davidzollo opened a new pull request, #455: URL: https://github.com/apache/seatunnel-website/pull/455
## Summary This PR implements the connector FAQ structure improvement. It adds **FAQ sections** to 10 high-priority connector pages in version 2.3.12, and introduces a **Connector FAQ Index** as a central navigation entry point. ## Structure Each connector page now has a **`## FAQ`** section inserted between **Examples** and **Changelog**: ``` Options → Parameter Interpretation → Examples → FAQ → Changelog ``` A new **Connector FAQ Index** page (`connector-v2/connector-faq.md`) provides a categorized overview linking to each connector's FAQ section, and is registered in the Connector-V2 sidebar. ## Changed Files ### New file - `versioned_docs/version-2.3.12/connector-v2/connector-faq.md` — Connector FAQ Index organized by category (CDC / Message Queue / OLAP Sink / Relational / Data Lake) ### FAQ sections added to connector pages **Priority 1 — CDC Connectors** | File | FAQ topics | |---|---| | `source/MySQL-CDC.md` | Permissions, binlog settings, replica support, no-PK tables, snapshot phase, DDL propagation, server-id conflicts, snapshot performance, timezone/charset | | `source/PostgreSQL-CDC.md` | Permissions, decoding plugins, standby limitation, no-PK tables, replication slot management, lag | | `source/Oracle-CDC.md` | LogMiner permissions & supplemental logging, CDB/PDB multi-tenant, no-PK tables, LogMiner performance, supported versions | **Priority 2 — Message Queue** | File | FAQ topics | |---|---| | `source/Kafka.md` | `start_mode` comparison table, filtering by key via NATIVE format, formats, SASL/Kerberos, offset commit | | `sink/Kafka.md` | Auto topic creation caveat (broker-side), `partition_key_fields` null-key behavior, exactly-once, SASL/Kerberos, formats | **Priority 3 — Sink Connectors** | File | FAQ topics | |---|---| | `sink/Doris.md` | `schema_save_mode`, 2PC exactly-once, label conflict, DELETE propagation, column case, Stream Load format | | `sink/StarRocks.md` | `schema_save_mode`, upsert/delete, exactly-once, column case, `nodeUrls` vs `base-url` | | `sink/Clickhouse.md` | `schema_save_mode`, batch tuning, supported types, table-not-found | | `sink/Jdbc.md` | `schema_save_mode`, XA exactly-once, upsert/PK config, multi-table writing, missing JDBC driver | | `sink/Hive.md` | File formats, partitioned tables, Kerberos, small files, schema evolution | ### Sidebar - `versioned_sidebars/version-2.3.12-sidebars.json` — added `connector-v2/connector-faq` to the Connector-V2 items ## Notes - All changes are scoped to **version 2.3.12** only. - No existing content was modified; FAQ sections are purely additive. - The Kafka topic auto-creation FAQ explicitly states this is a **broker-side** behavior (`auto.create.topics.enable`), not a SeaTunnel capability. -- 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]
