TiDB
About
TiDB is an open-source distributed SQL database that supports Hybrid Transactional and Analytical Processing (HTAP) workloads. It is MySQL-compatible and features horizontal scalability, strong consistency, and high availability.
Requirements
Database User
This source uses standard MySQL protocol authentication. You will need to create a TiDB user to login to the database with.
For TiDB Cloud users, you can create database users through the TiDB Cloud console.
SSL Configuration
TiDB Cloud
For TiDB Cloud instances, SSL is automatically enabled when the hostname matches the TiDB Cloud pattern (
gateway*.*.*.tidbcloud.com
). You don’t need to explicitly setssl: true
for TiDB Cloud connections.Self-Hosted TiDB
For self-hosted TiDB instances, you can optionally enable SSL by setting
ssl: true
in your configuration.
Example
TiDB Cloud
sources: my-tidb-cloud-source: kind: tidb host: gateway01.us-west-2.prod.aws.tidbcloud.com port: 4000 database: my_db user: ${TIDB_USERNAME} password: ${TIDB_PASSWORD} # SSL is automatically enabled for TiDB Cloud
Self-Hosted TiDB
sources: my-tidb-source: kind: tidb host: 127.0.0.1 port: 4000 database: my_db user: ${TIDB_USERNAME} password: ${TIDB_PASSWORD} # ssl: true # Optional: enable SSL for secure connections
Tip
Use environment variable replacement with the format ${ENV_NAME} instead of hardcoding your secrets into the configuration file.
Reference
field | type | required | description |
---|---|---|---|
kind | string | true | Must be “tidb”. |
host | string | true | IP address or hostname to connect to (e.g. “127.0.0.1” or “gateway01.*.tidbcloud.com”). |
port | string | true | Port to connect to (typically “4000” for TiDB). |
database | string | true | Name of the TiDB database to connect to (e.g. “my_db”). |
user | string | true | Name of the TiDB user to connect as (e.g. “my-tidb-user”). |
password | string | true | Password of the TiDB user (e.g. “my-password”). |
ssl | boolean | false | Whether to use SSL/TLS encryption. Automatically enabled for TiDB Cloud instances. |