Skip to content

Commit c851d39

Browse files
ljun0712ljun0712
authored
cloud: add public connection docs for premium (#21926)
1 parent 1979c09 commit c851d39

File tree

6 files changed

+163
-7
lines changed

6 files changed

+163
-7
lines changed

‎TOC-tidb-cloud-premium.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -133,8 +133,8 @@
133133
- Manage TiDB Cloud Instances
134134
- [Create a {{{ .premium }}} Instance](/tidb-cloud/premium/create-tidb-instance-premium.md)
135135
- Connect to Your TiDB Cloud Cluster
136-
- [Connection Overview](/tidb-cloud/connect-to-tidb-cluster-serverless.md)
137-
- [Connect via Public Endpoint](/tidb-cloud/connect-via-standard-connection-serverless.md)
136+
- [Connection Overview](/tidb-cloud/premium/connect-to-tidb-instance.md)
137+
- [Connect via Public Endpoint](/tidb-cloud/premium/connect-to-premium-via-public-connection.md)
138138
- [Connect via Private Endpoint with AWS](/tidb-cloud/premium/connect-to-premium-via-aws-private-endpoint.md)
139139
- [Connect via Private Endpoint with Alibaba Cloud](/tidb-cloud/set-up-private-endpoint-connections-on-alibaba-cloud.md)
140140
- [Back Up and Restore TiDB Cloud Data](/tidb-cloud/premium/backup-and-restore-premium.md)
@@ -201,7 +201,7 @@
201201
- [TiKV Follower Read](/follower-read.md)
202202
- [Coprocessor Cache](/coprocessor-cache.md)
203203
- [Tune TiFlash Performance](/tiflash/tune-tiflash-performance.md)
204-
- [Delete a TiDB Cluster](/tidb-cloud/delete-tidb-cluster.md)
204+
- [Delete a TiDB Instance](/tidb-cloud/premium/delete-tidb-instance.md)
205205
- Migrate or Import Data
206206
- [Overview](/tidb-cloud/tidb-cloud-migration-overview.md)
207207
- Migrate Data into TiDB Cloud
@@ -230,9 +230,9 @@
230230
- [Identity Access Management](/tidb-cloud/manage-user-access.md)
231231
- [OAuth 2.0](/tidb-cloud/oauth2.md)
232232
- Network Access Control
233+
- [Configure an IP Access List](/tidb-cloud/premium/configure-ip-access-list-premium.md)
233234
- [Connect via Private Endpoint with Alibaba Cloud](/tidb-cloud/set-up-private-endpoint-connections-on-alibaba-cloud.md)
234235
- [Configure Firewall Rules for Public Endpoints](/tidb-cloud/configure-serverless-firewall-rules-for-public-endpoints.md)
235-
- [TLS Connections to TiDB Cloud](/tidb-cloud/secure-connections-to-serverless-clusters.md)
236236
- Audit Management
237237
- [Console Audit Logging](/tidb-cloud/tidb-cloud-console-auditing.md)
238238
- Billing

‎tidb-cloud/premium/configure-ip-access-list-premium.md‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
title: Configure an IP Access List for {{{ .premium }}}
3+
summary: Learn how to configure IP addresses that are allowed to access your {{{ .premium }}} instance.
4+
---
5+
6+
# Configure an IP Access List for {{{ .premium }}}
7+
8+
For each {{{ .premium }}} instance in TiDB Cloud, you can configure an IP access list to filter internet traffic trying to access the instance, which works similarly to a firewall access control list. After the configuration, only the clients and applications whose IP addresses are in the IP access list can connect to your {{{ .premium }}} instance.
9+
10+
> **Note:**
11+
>
12+
> This document applies to **{{{ .premium }}}**. For instructions on configuring an IP access list for **{{{ .starter }}}** or **{{{ .essential }}}**, see [Configure {{{ .starter }}} or Essential Firewall Rules for Public Endpoints](/tidb-cloud/configure-serverless-firewall-rules-for-public-endpoints.md).
13+
14+
To configure an IP access list for your {{{ .premium }}} instance, take the following steps:
15+
16+
1. Navigate to the [**TiDB Instances**](https://tidbcloud.com/tidbs) page, and then click the name of your target instance to go to its overview page.
17+
18+
> **Tip:**
19+
>
20+
> You can use the combo box in the upper-left corner to switch between organizations.
21+
22+
2. In the left navigation pane, click **Settings** > **Networking**.
23+
3. On the **Networking** page, click **Enable** for **Public Endpoint** to to make the instance accessible via a public endpoint, and then click **Add IP Address**.
24+
4. In the displayed dialog, choose one of the following options:
25+
26+
- **Allow access from anywhere**: allows all IP addresses to access TiDB Cloud. This option exposes your instance to the internet completely and is highly risky.
27+
- **Use IP addresses** (recommended): you can add a list of IPs and CIDR addresses that are allowed to access TiDB Cloud via a SQL client.
28+
29+
5. If you choose **Use IP addresses**, add IP addresses or CIDR ranges with an optional description.
30+
6. Click **Confirm** to save your changes.

‎tidb-cloud/premium/connect-to-premium-via-public-connection.md‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: Connect to {{{ .premium }}} via Public Connection
3+
summary: Learn how to connect to your {{{ .premium }}} via public connection.
4+
---
5+
6+
# Connect to {{{ .premium }}} via Public Connection
7+
8+
This document describes how to connect to your {{{ .premium }}} instance via public connection. The public connection exposes a public endpoint with traffic filters, so you can connect to your {{{ .premium }}} instance via a SQL client from your laptop.
9+
10+
> **Tip:**
11+
>
12+
> - To learn how to connect to a {{{ .starter }}} or {{{ .essential }}} cluster via public connection, see [Connect to {{{ .starter }}} or Essential via Public Endpoint](/tidb-cloud/connect-via-standard-connection-serverless.md).
13+
> - To learn how to connect to a TiDB Cloud Dedicated cluster via public endpoint, see [Connect to TiDB Cloud Dedicated via Public Connection](/tidb-cloud/connect-via-standard-connection.md).
14+
15+
## Prerequisite: Configure IP access list
16+
17+
For public connections, {{{ .premium }}} only allows client connections from addresses in the IP access list. If you have not configured the IP access list, follow the steps in [Configure an IP Access List](/tidb-cloud/premium/configure-ip-access-list-premium.md) to configure it before your first connection.
18+
19+
## Connect to the instance
20+
21+
To connect to a {{{ .premium }}} instance via public connection, take the following steps:
22+
23+
1. Open the overview page of the target instance.
24+
25+
1. Log in to the [TiDB Cloud console](https://tidbcloud.com/) and navigate to the [**TiDB Instances**](https://tidbcloud.com/tidbs) page.
26+
27+
> **Tip:**
28+
>
29+
> You can use the combo box in the upper-left corner to switch between organizations.
30+
31+
2. Click the name of your target instance to go to its overview page.
32+
33+
2. Click **Connect** in the upper-right corner. A connection dialog is displayed.
34+
35+
3. In the connection dialog, select **Public** from the **Connection Type** drop-down list.
36+
37+
If you have not configured the IP access list, click **Configure IP Access List** or follow the steps in [Configure an IP Access List](/tidb-cloud/premium/configure-ip-access-list-premium.md) to configure it before your first connection.
38+
39+
4. Click **CA cert** to download CA cert for TLS connection to TiDB instances. The CA cert supports TLS 1.2 version by default.
40+
41+
5. Choose your preferred connection method, and then refer to the connection string and sample code on the tab to connect to your instance.
42+
43+
## What's next
44+
45+
After you have successfully connected to your TiDB instance, you can [explore SQL statements with TiDB](/basic-sql-operations.md).

‎tidb-cloud/premium/connect-to-tidb-instance.md‎

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
title: Connect to Your {{{ .premium }}} Instance
3+
summary: Learn how to connect to your {{{ .premium }}} instance via different methods.
4+
---
5+
6+
# Connect to Your {{{ .premium }}} Instance
7+
8+
This document describes how to connect to your {{{ .premium }}} instance.
9+
10+
> **Tip:**
11+
>
12+
> To learn how to connect to a TiDB Cloud Dedicated cluster, see [Connect to Your TiDB Cloud Dedicated Cluster](/tidb-cloud/connect-to-tidb-cluster.md).
13+
14+
## Connection methods
15+
16+
After your {{{ .premium }}} instance is created on TiDB Cloud, you can connect to it via direct connections.
17+
18+
Direct connections mean the MySQL native connection system over TCP. You can connect to your instance using any tool that supports MySQL connection, such as [MySQL client](https://dev.mysql.com/doc/refman/8.0/en/mysql.html).
19+
20+
| Connection method | User interface | Scenario |
21+
|--------------------|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|
22+
| Direct connections | SQL/ORM | Long-running environment, such as Java, Node.js, and Python. |
23+
24+
## Network
25+
26+
There are two network connection types for {{{ .premium }}}:
27+
28+
- [Private endpoint](/tidb-cloud/premium/connect-to-premium-via-aws-private-endpoint.md) (recommended)
29+
30+
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.
31+
32+
- [Public endpoint](/tidb-cloud/premium/connect-to-premium-via-public-connection.md)
33+
34+
The standard connection exposes a public endpoint, so you can connect to your TiDB instance via a SQL client from your laptop.
35+
36+
<!-- To ensure the security of data transmission, you need to [establish a TLS connection](/tidb-cloud/premium/tidb-cloud-tls-connect-to-premium.md) from your client to your instance. -->
37+
38+
The following table shows the network you can use:
39+
40+
| Connection method | Network | Description |
41+
|----------------------------|------------------------------|-------------------------------------------------------------------------------------------------------------------|
42+
| Direct connections | Public or private endpoint | Direct connections can be made via both public and private endpoints. |
43+
44+
## What's next
45+
46+
After you have successfully connected to your TiDB instance, you can [explore SQL statements with TiDB](/basic-sql-operations.md).

‎tidb-cloud/premium/create-tidb-instance-premium.md‎

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -56,11 +56,10 @@ If you have the `Organization Owner` role, you can create a {{{ .premium }}} ins
5656

5757
The instance creation process begins. If this is your first instance in the selected region, provisioning typically takes about 30 minutes. If the selected region already has existing instances, the process is faster and usually completes within about 1 minute.
5858

59-
<!--## What's next
59+
## What's next
6060

61-
After your instance is created, follow the instructions in [Connect to TiDB Cloud via Public Endpoint](/tidb-cloud/connect-via-standard-connection-premium.md) to create a password for your instance.
61+
After your instance is created, follow the instructions in [Connect to TiDB Cloud via Public Endpoint](/tidb-cloud/premium/connect-to-premium-via-public-connection.md) to create a password for your instance.
6262

6363
> **Note:**
6464
>
6565
> If you do not set a password, you cannot connect to the instance.
66-
-->

‎tidb-cloud/premium/delete-tidb-instance.md‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
title: Delete a {{{ .premium }}} instance
3+
summary: Learn how to delete a {{{ .premium }}} instance.
4+
---
5+
6+
# Delete a {{{ .premium }}} instance
7+
8+
This document describes how to delete a {{{ .premium }}} instance.
9+
10+
You can delete an instance at any time by performing the following steps:
11+
12+
1. Navigate to the [**TiDB Instances**](https://tidbcloud.com/tidbs) page.
13+
2. In the row of your target instance to be deleted, click **...**.
14+
15+
> **Tip:**
16+
>
17+
> Alternatively, you can also click the name of the target instance to go to its overview page, and then click **...** in the upper-right corner.
18+
19+
3. Click **Delete** in the drop-down menu.
20+
4. In the deletion confirmation window, confirm the deletion:
21+
22+
Enter `<organization name>/<instance name>` to ensure the instance is deleted correctly.
23+
24+
If you want to restore the instance some time in the future, make sure that you have a backup of the instance. Otherwise, you cannot restore it. For more information about how to back up {{{ .premium }}} instances, see [Back Up and Restore {{{ .premium }}} Data](/tidb-cloud/premium/backup-and-restore-premium.md).
25+
26+
5. Click **I understand, delete it**.
27+
28+
Once you delete a backed up {{{ .premium }}} instance, the existing backup files of the instance are moved to the recycle bin.
29+
30+
Automatic backups will expire and be automatically deleted once the retention period ends. The default retention period is 7 days if you don't modify it.
31+
32+
> **Note:**
33+
>
34+
> Please be aware that backups will continue to incur charges until deleted.
35+
36+
If you want to restore a {{{ .premium }}} instance from the recycle bin, see [Restore from Recycle Bin](/tidb-cloud/premium/backup-and-restore-premium.md#restore-from-recycle-bin).

0 commit comments

Comments
 (0)