Connector FAQ
This page is an index of frequently asked questions organized by connector category. Each entry links to the FAQ section inside the corresponding connector documentation page.
These FAQ sections are intended to be quick navigation, not a second source of truth. For exact
option names, defaults, and full examples, always use the connector option table and linked
detailed sections on the connector page itself.
For general SeaTunnel questions (engine setup, variable substitution, scheduling, etc.) see the General FAQ.
CDC Connectors
Change Data Capture connectors read real-time change events (INSERT / UPDATE / DELETE) from database transaction logs.
| Connector | Common FAQ Topics |
|---|
| MySQL CDC | Required permissions, binlog settings, replica support, tables without primary keys, snapshot phase, DDL propagation, server-id conflicts, snapshot performance, timezone/charset |
| PostgreSQL CDC | Required permissions, logical decoding plugins, replica support, tables without primary keys, replication slot management, replication lag |
| Oracle CDC | LogMiner permissions, supplemental logging, CDB/PDB multi-tenant, tables without primary keys, LogMiner performance, supported Oracle versions |
Message Queue Connectors
| Connector | Common FAQ Topics |
|---|
| Kafka Source | start_mode options, filtering by message key, supported formats, SASL/Kerberos authentication, consumer group offset commit |
| Kafka Sink | Automatic topic creation, partition_key_fields behavior, exactly-once delivery, SASL/Kerberos authentication, supported formats |
Sink Connectors
OLAP / Analytical Stores
| Connector | Common FAQ Topics |
|---|
| Doris Sink | Automatic table creation, exactly-once with 2PC, "Label already exists" error, DELETE propagation, column case sensitivity, Stream Load format |
| StarRocks Sink | Automatic table creation, upsert and DELETE support, labelPrefix usage, column case sensitivity, nodeUrls vs base-url |
| ClickHouse Sink | Automatic table creation, batch write performance, supported data types, "Table doesn't exist" error |
Relational Databases
| Connector | Common FAQ Topics |
|---|
| JDBC Sink | Automatic table creation, exactly-once with XA transactions, upsert / primary key configuration, multi-table writing, missing JDBC driver |
Data Lakes / File Systems
| Connector | Common FAQ Topics |
|---|
| Hive Sink | Supported file formats, partitioned tables, Kerberos authentication, small file problem, schema evolution |
Tips for Finding Answers
- Connector-specific issues → go directly to the connector's page and scroll to its FAQ section.
- Cross-connector topics (e.g., "does SeaTunnel support CDC?", "what is
schema_save_mode?") → see the General FAQ. - Still stuck? → search the GitHub Issues or reach out via the mailing list.
⭐️