DanielCarter-stack opened a new pull request, #11794:
URL: https://github.com/apache/seatunnel/pull/11794
# Improve Aerospike Feishu Mysql GraphQL and Prometheus connector docs
## What this PR does
This PR brings the Chinese (`docs/zh`) connector documentation for five
connectors up to parity with their already-merged `docs/en` counterparts, and
re-aligns the section ordering where the two locales diverged. The English
files were not modified because they were recently touched by other in-flight
work.
- **Aerospike sink (`docs/zh/connectors/sink/Aerospike.md`)** — reorders
sections so `支持引擎` comes before `许可证兼容性通知`, matching the `docs/en` layout. No
content change.
- **Feishu sink (`docs/zh/connectors/sink/Feishu.md`)** — adds two missing
task examples that exist in `docs/en`:
- `流式告警推送到飞书机器人` (Kafka source → Feishu streaming, with `array_mode` +
`request_interval_ms`).
- `发送飞书富文本消息` (using `Sql` transform to wrap rows as a `text` envelope
before the Feishu sink).
Also fixes the data type mapping table (the previous Chinese row
`TIME<br/>TIMESTAMP<br/>TIME` was a self-duplicate; the EN table has three
separate rows `DATE`/`TIME`/`TIMESTAMP`, now mirrored here), and fixes
`row_num` → `row.num` in the first example to match the EN version and the
actual `FakeSource` option name.
- **Mysql sink (`docs/zh/connectors/sink/Mysql.md`)** — fixes several
long-standing Chinese-translation typos in the Sink Options table:
- `xa_data_source_class_name` row: rewrites the broken sentence
`数据库Driver的xa数据源类名，例如mysql是\`com.mysql.cj.jdbc。MysqlXADataSource`
(mixed-language, missing closing backtick, broken punctuation) into a clean
sentence: `数据库 Driver 的 xa 数据源类名，例如 MySQL 是
\`com.mysql.cj.jdbc.MysqlXADataSource\`，其他数据源请参考对应驱动文档。`
- `field_ide` row: backticks the three enum values (`ORIGINAL` /
`UPPERCASE` / `LOWERCASE`) and fixes punctuation.
- `enable_upsert` row: `upstart` → `upsert`, adds missing backticks.
- `transaction_timeout_sec` row: full-width angle brackets `＜br/＞` → ASCII
`<br/>`, `默认值-1` → `默认值 -1`.
- **GraphQL source (`docs/zh/connectors/source/GraphQL.md`)** — adds two
missing task examples that exist in `docs/en`:
- `带鉴权头的 GraphQL 查询` (passing `Authorization: Bearer ...` and a tenant
header through `headers`).
- `流式轮询查询` (HTTP polling in `STREAMING` mode, controlled by
`poll_interval_millis`).
- **Prometheus source (`docs/zh/connectors/source/Prometheus.md`)** — adds
two missing task examples that exist in `docs/en`:
- `流式范围查询示例` (continuous `Range` query with `poll_interval_millis`, plus
`retry`/`retry_backoff_*`).
- `使用 Unix 时间戳的范围查询` (backfill window with explicit Unix second
timestamps).
## Why docs-only
No production code, config keys, defaults, or connector behavior are
touched. The change is intentionally scoped to `docs/zh/**` and is a
parity-sync against the already-merged `docs/en` content, plus
translation-quality fixes in the Mysql sink table.
## Verification
- Ran `git diff` on the touched files; every new example is a faithful
Chinese translation of the corresponding `docs/en` example, with option names,
HOCON keys, URLs, schema fields and JSON paths preserved byte-for-byte.
- Cross-checked the new Mysql `xa_data_source_class_name` row wording
against `seatunnel-connectors-v2/connector-jdbc` source so the example driver
class name matches.
- Did not modify any `docs/en` files; the only EN-side changes from the
previous batch (PR #11793) that touch the same five connectors' review-thread
issues have been kept intact on `docs/connectors-batch-20260813-5`.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
