TiDBTiDB Docs Dash 2024

Jan 9 - Jan 12 (UTC)
Join us to improve docs and win a prize!
Sign InTry Free

Connect to Your TiDB Serverless Cluster

This document describes how to connect to your TiDB Serverless cluster.

Connection methods

After your TiDB Serverless cluster is created on TiDB Cloud, you can connect to it via one of the following methods:

  • Direct connections

    Direct connections mean the MySQL native connection system over TCP. You can connect to your TiDB Serverless cluster using any tool that supports MySQL connection, such as MySQL client.

  • Data Service (beta)

    TiDB Cloud provides a Data Service feature that enables you to connect to your TiDB Serverless cluster via an HTTPS request using a custom API endpoint. Unlike direct connections, Data Service accesses TiDB Serverless data via a RESTful API rather than raw SQL.

  • Serverless Driver (beta)

    TiDB Cloud provides a serverless driver for JavaScript, which allows you to connect to your TiDB Serverless cluster in edge environments with the same experience as direct connections.

In the preceding connection methods, you can choose your desired one based on your needs:

Connection methodTransport protocolUser interfaceScenario
Direct connectionsTCPSQLLong-running environment, such as Java, Node.js, and Python.
Data ServiceHTTPRESTful APIAll browser and application interactions.
Serverless DriverHTTPSQLEdge environments such as Vercel Edge Functions and Cloudflare Workers.

Network

There are two network connection types for TiDB Serverless:

  • Private endpoint (recommended)

    Private endpoint connection provides a private endpoint to allow SQL clients in your VPC to securely access services over AWS PrivateLink, which provides highly secure and one-way access to database services with simplified network management.

  • Public endpoint

    The standard connection exposes a public endpoint, so you can connect to your TiDB cluster via a SQL client from your laptop.

    TiDB Serverless requires TLS connections, which ensures the security of data transmission from your applications to TiDB clusters.

The following table shows the network you can use in different connection methods:

Connection methodNetworkDescription
Direct connectionsPublic or private endpointDirect connections can be made via both public and private endpoints.
Data Service (beta)/Accessing TiDB Serverless via Data Service (beta) does not need to specify the network type.
Serverless Driver (beta)Public endpointServerless Driver only supports connections via public endpoint.

What's next

After you have successfully connected to your TiDB cluster, you can explore SQL statements with TiDB.

Was this page helpful?

Download PDFRequest docs changesAsk questions on Discord
Playground
New
One-stop & interactive experience of TiDB's capabilities WITHOUT registration.
Products
TiDB
TiDB Dedicated
TiDB Serverless
Pricing
Get Demo
Get Started
© 2024 PingCAP. All Rights Reserved.
Privacy Policy.