XiaodongHuan created FLINK-39344:
------------------------------------
Summary: [Doc] Fix inconsistencies between MySqlDataSourceOptions
and MySQL Pipeline Connector documentation
Key: FLINK-39344
URL: https://issues.apache.org/jira/browse/FLINK-39344
Project: Flink
Issue Type: Improvement
Components: Flink CDC
Affects Versions: cdc-3.6.0
Reporter: XiaodongHuan
Fix For: cdc-3.6.0
Attachments: image-2026-03-27-20-47-55-481.png,
image-2026-03-27-20-48-28-813.png, image-2026-03-27-20-49-28-670.png
## Problem
There are several inconsistencies between `MySqlDataSourceOptions.java` and the
MySQL Pipeline Connector documentation
(`docs/content/docs/connectors/pipeline-connectors/mysql.md` and
`docs/content.zh/docs/connectors/pipeline-connectors/mysql.md`):
**1. Missing option: `server-time-zone`**
The `server-time-zone` option is defined in `MySqlDataSourceOptions.java` as a
non-experimental config option, but it is absent from both the English and
Chinese Pipeline Connector documentation.
**2. Wrong default value for `metadata.list`**
- In `MySqlDataSourceOptions.java`: defined with `noDefaultValue()`, meaning
the default should be `(none)`
- In both docs: the Default column incorrectly shows `false`
**3. Wrong default value for `jdbc.properties.*`**
- This is a pass-through config option not explicitly defined in
`MySqlDataSourceOptions.java`
- In both docs: the Default column incorrectly shows `20` (which appears to be
a copy-paste error from the `connection.pool.size` option)
- It should be `(none)`
## Expected Behavior
The documentation should accurately reflect the actual behavior defined in the
source code.
## Proposed Fix
- Add the `server-time-zone` option entry to both English and Chinese Pipeline
Connector docs
- Fix the default value of `metadata.list` from `false` to `(none)` in both docs
- Fix the default value of `jdbc.properties.*` from `20` to `(none)` in both
docs
!image-2026-03-27-20-47-55-481.png!!image-2026-03-27-20-48-28-813.png!!image-2026-03-27-20-49-28-670.png!
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
