📣

TiDB Cloud Premium is now in public preview. Unlimited growth, instant elasticity, advanced security for enterprise workloads. Try it out →

Connect to TiDB Cloud Lake Using Drivers

TiDB Cloud Lake provides official drivers for multiple programming languages, enabling you to connect and interact with TiDB Cloud Lake from your applications.

Quick Start

Choose your language - Select from Python, Go, Node.js, Java, or Rust
Get your connection string - Use the DSN format below
Install and connect - Follow the driver-specific documentation

Connection String (DSN)

All TiDB Cloud Lake drivers use the same DSN (Data Source Name) format:

lake://user:pwd@host[:port]/[database][?sslmode=disable][&arg1=value1]

Note

The user:pwd refers to SQL users in TiDB Cloud Lake. See CREATE USER to create users and grant privileges.

Connection Examples

Deployment	Connection String
TiDB Cloud Lake	`lake://user:pwd@host:443/database?warehouse=wh`

Parameters Reference

Parameter	Description	TiDB Cloud Lake	Example
`sslmode`	SSL mode	Not used	`?sslmode=disable`
`warehouse`	Warehouse name	Required	`?warehouse=compute_wh`

TiDB Cloud Lake: Get connection info →

Available Drivers

Language	Package	Key Features
Python	`tidbcloudlake-driver` `lake-sqlalchemy`	• Sync/async support • SQLAlchemy dialect • PEP 249 compatible
Go	`lake-go`	• database/sql interface • Connection pooling • Bulk operations
Node.js	`tidbcloudlake-driver`	• TypeScript support • Promise-based API • Streaming results
Java	`lake-jdbc`	• JDBC 4.0 compatible • Connection pooling • Prepared statements
Rust	`lake-driver`	• Async/await support • Type-safe queries • Zero-copy deserialization