diff --git a/TOC-tidb-cloud.md b/TOC-tidb-cloud.md index cd73f2c2dd024..c7c6aab9cf17c 100644 --- a/TOC-tidb-cloud.md +++ b/TOC-tidb-cloud.md @@ -23,6 +23,7 @@ - [JetBrains DataGrip](/develop/dev-guide-gui-datagrip.md) - [DBeaver](/develop/dev-guide-gui-dbeaver.md) - [VS Code](/develop/dev-guide-gui-vscode-sqltools.md) + - [Navicat](/develop/dev-guide-gui-navicat.md) - [Choose Driver or ORM](/develop/dev-guide-choose-driver-or-orm.md) - Java - [JDBC](/develop/dev-guide-sample-application-java-jdbc.md) diff --git a/TOC.md b/TOC.md index f4bc50c94254a..4fb705c8fbfad 100644 --- a/TOC.md +++ b/TOC.md @@ -53,6 +53,7 @@ - [JetBrains DataGrip](/develop/dev-guide-gui-datagrip.md) - [DBeaver](/develop/dev-guide-gui-dbeaver.md) - [VS Code](/develop/dev-guide-gui-vscode-sqltools.md) + - [Navicat](/develop/dev-guide-gui-navicat.md) - [Choose Driver or ORM](/develop/dev-guide-choose-driver-or-orm.md) - [Connect to TiDB](/develop/dev-guide-connect-to-tidb.md) - [Connection Pools and Connection Parameters](/develop/dev-guide-connection-parameters.md) diff --git a/develop/dev-guide-gui-navicat.md b/develop/dev-guide-gui-navicat.md new file mode 100644 index 0000000000000..2937ed84fbe9c --- /dev/null +++ b/develop/dev-guide-gui-navicat.md @@ -0,0 +1,167 @@ +--- +title: Connect to TiDB with Navicat +summary: Learn how to connect to TiDB using Navicat. +--- + +# Connect to TiDB with Navicat + +TiDB is a MySQL-compatible database, and [Navicat](https://www.navicat.com) is a GUI tool set for database users. This tutorial uses the [Navicat for MySQL](https://www.navicat.com/en/products/navicat-for-mysql) tool to connect to TiDB. + +> **Warning:** +> +> - Although you can use Navicat to connect to TiDB due to its MySQL compatibility, Navicat does not fully support TiDB. You might encounter some issues during usage as it treats TiDB as MySQL. There is a known issue about [Navicat user management compatibility](https://github.com/pingcap/tidb/issues/45154). For more compatibility issues between Navicat and TiDB, see the [TiDB GitHub issue page](https://github.com/pingcap/tidb/issues?q=is%3Aissue+navicat+is%3Aopen). +> - It is recommended to use other GUI tools that officially support TiDB, such as [DataGrip](/develop/dev-guide-gui-datagrip.md), [DBeaver](/develop/dev-guide-gui-dbeaver.md), and [VS Code SQLTools](/develop/dev-guide-gui-vscode-sqltools.md). For a complete list of GUI tools that fully supported by TiDB, see [Third-party tools supported by TiDB](/develop/dev-guide-third-party-support.md#gui). + +In this tutorial, you can learn how to connect to your TiDB cluster using Navicat. + +> **Note:** +> +> This tutorial is compatible with TiDB Serverless, TiDB Dedicated, and TiDB Self-Hosted. + +## Prerequisites + +To complete this tutorial, you need: + +- [Navicat for MySQL](https://www.navicat.com/en/download/navicat-for-mysql) **16.3.2** or later versions. +- A paid account for Navicat for MySQL. +- A TiDB cluster. + + + +**If you don't have a TiDB cluster, you can create one as follows:** + +- (Recommended) Follow [Creating a TiDB Serverless cluster](/develop/dev-guide-build-cluster-in-cloud.md) to create your own TiDB Cloud cluster. +- Follow [Deploy a local test TiDB cluster](/quick-start-with-tidb.md#deploy-a-local-test-cluster) or [Deploy a production TiDB cluster](/production-deployment-using-tiup.md) to create a local cluster. + + + + +**If you don't have a TiDB cluster, you can create one as follows:** + +- (Recommended) Follow [Creating a TiDB Serverless cluster](/develop/dev-guide-build-cluster-in-cloud.md) to create your own TiDB Cloud cluster. +- Follow [Deploy a local test TiDB cluster](https://docs.pingcap.com/tidb/stable/quick-start-with-tidb#deploy-a-local-test-cluster) or [Deploy a production TiDB cluster](https://docs.pingcap.com/tidb/stable/production-deployment-using-tiup) to create a local cluster. + + + +## Connect to TiDB + +Connect to your TiDB cluster depending on the TiDB deployment option you have selected. + + +
+ +1. Navigate to the [**Clusters**](https://tidbcloud.com/console/clusters) page, and then click the name of your target cluster to go to its overview page. + +2. Click **Connect** in the upper-right corner. A connection dialog is displayed. + +3. Ensure the configurations in the connection dialog match your operating environment. + + - **Endpoint Type** is set to `Public`. + - **Connect With** is set to `General`. + - **Operating System** matches your environment. + +4. Click **Create password** to create a random password. + + > **Tip:** + > + > If you have created a password before, you can either use the original password or click **Reset password** to generate a new one. + +5. Launch Navicat for MySQL, click **Connection** in the upper-left corner, and select **MySQL** from the drop-down list. + + ![Navicat: add new connection](/media/develop/navicat-add-new-connection.jpg) + +6. In the **New Connection (MySQL)** dialog, configure the following connection parameters: + + - **Connection Name**: give this connection a meaningful name. + - **Host**: enter the `host` parameter from the TiDB Cloud connection dialog. + - **Port**: enter the `port` parameter from the TiDB Cloud connection dialog. + - **User Name**: enter the `user` parameter from the TiDB Cloud connection dialog. + - **Password**: enter the password of the TiDB Serverless cluster. + + ![Navicat: configure connection general panel for TiDB Serverless](/media/develop/navicat-connection-config-serverless-general.png) + +7. Click the **SSL** tab and select **Use SSL**, **Use authentication**, and **Verify server certificate against CA** checkboxes. Then, select the `ssl_ca` file from the TiDB Cloud connection dialog into the **CA Certificate** field. + + ![Navicat: configure connection SSL panel for TiDB Serverless](/media/develop/navicat-connection-config-serverless-ssl.png) + +8. Click **Test Connection** to validate the connection to the TiDB Serverless cluster. + +9. If the connection test is successful, you can see the **Connection Successful** message. Click **Save** to finish the connection configuration. + +
+
+ +1. Navigate to the [**Clusters**](https://tidbcloud.com/console/clusters) page, and then click the name of your target cluster to go to its overview page. + +2. Click **Connect** in the upper-right corner. A connection dialog is displayed. + +3. Click **Allow Access from Anywhere**. + + For more details about how to obtain the connection string, refer to [TiDB Dedicated standard connection](https://docs.pingcap.com/tidbcloud/connect-via-standard-connection). + +4. Click **Download CA cert** to download the CA file. + +5. Launch Navicat for MySQL, click **Connection** in the upper-left corner, and select **MySQL** from the drop-down list. + + ![Navicat: add new connection](/media/develop/navicat-add-new-connection.jpg) + +6. In the **New Connection (MySQL)** dialog, configure the following connection parameters: + + - **Connection Name**: give this connection a meaningful name. + - **Host**: enter the `host` parameter from the TiDB Cloud connection dialog. + - **Port**: enter the `port` parameter from the TiDB Cloud connection dialog. + - **User Name**: enter the `user` parameter from the TiDB Cloud connection dialog. + - **Password**: enter the password of the TiDB Dedicated cluster. + + ![Navicat: configure connection general panel for TiDB Dedicated](/media/develop/navicat-connection-config-dedicated-general.png) + +7. Click the **SSL** tab and select **Use SSL**, **Use authentication**, and **Verify server certificate against CA** checkboxes. Then, select the CA file downloaded in step 4 into the **CA Certificate** field. + + ![Navicat: configure connection SSL panel for TiDB Dedicated](/media/develop/navicat-connection-config-dedicated-ssl.jpg) + +8. **Test Connection** to validate the connection to the TiDB Dedicated cluster. + +9. If the connection test is successful, you can see the **Connection Successful** message. Click **Save** to finish the connection configuration. + +
+
+ +1. Launch Navicat for MySQL, click **Connection** in the upper-left corner, and select **MySQL** from the drop-down list. + + ![Navicat: add new connection](/media/develop/navicat-add-new-connection.jpg) + +2. In the **New Connection (MySQL)** dialog, configure the following connection parameters: + + - **Connection Name**: give this connection a meaningful name. + - **Host**: enter the IP address or domain name of your TiDB Self-Hosted cluster. + - **Port**: enter the port number of your TiDB Self-Hosted cluster. + - **User Name**: enter the username to use to connect to your TiDB. + - **Password**: enter the password to use to connect to your TiDB. + + ![Navicat: configure connection general panel for self-hosted TiDB](/media/develop/navicat-connection-config-self-hosted-general.png) + +3. Click **Test Connection** to validate the connection to the TiDB Self-Hosted cluster. + +4. If the connection test is successful, you can see the **Connection Successful** message. Click **Save** to finish the connection configuration. + +
+
+ +## Next steps + +- Learn the best practices for TiDB application development with the chapters in the [Developer guide](/develop/dev-guide-overview.md), such as [Insert data](/develop/dev-guide-insert-data.md), [Update data](/develop/dev-guide-update-data.md), [Delete data](/develop/dev-guide-delete-data.md), [Single table reading](/develop/dev-guide-get-data-from-single-table.md), [Transactions](/develop/dev-guide-transaction-overview.md), and [SQL performance optimization](/develop/dev-guide-optimize-sql-overview.md). +- Learn through the professional [TiDB developer courses](https://www.pingcap.com/education/) and earn [TiDB certifications](https://www.pingcap.com/education/certification/) after passing the exam. + +## Need help? + + + +Ask questions on the [Discord](https://discord.gg/DQZ2dy3cuc?utm_source=doc), or [create a support ticket](/support.md). + + + + + +Ask questions on the [Discord](https://discord.gg/DQZ2dy3cuc?utm_source=doc), or [create a support ticket](/tidb-cloud/tidb-cloud-support.md). + + diff --git a/media/develop/navicat-add-new-connection.jpg b/media/develop/navicat-add-new-connection.jpg new file mode 100644 index 0000000000000..13662f4174066 Binary files /dev/null and b/media/develop/navicat-add-new-connection.jpg differ diff --git a/media/develop/navicat-connection-config-dedicated-general.png b/media/develop/navicat-connection-config-dedicated-general.png new file mode 100644 index 0000000000000..8d41a772cf045 Binary files /dev/null and b/media/develop/navicat-connection-config-dedicated-general.png differ diff --git a/media/develop/navicat-connection-config-dedicated-ssl.jpg b/media/develop/navicat-connection-config-dedicated-ssl.jpg new file mode 100644 index 0000000000000..3b5efb0438225 Binary files /dev/null and b/media/develop/navicat-connection-config-dedicated-ssl.jpg differ diff --git a/media/develop/navicat-connection-config-self-hosted-general.png b/media/develop/navicat-connection-config-self-hosted-general.png new file mode 100644 index 0000000000000..058e7789d824a Binary files /dev/null and b/media/develop/navicat-connection-config-self-hosted-general.png differ diff --git a/media/develop/navicat-connection-config-serverless-general.png b/media/develop/navicat-connection-config-serverless-general.png new file mode 100644 index 0000000000000..5dc47a5f884bb Binary files /dev/null and b/media/develop/navicat-connection-config-serverless-general.png differ diff --git a/media/develop/navicat-connection-config-serverless-ssl.png b/media/develop/navicat-connection-config-serverless-ssl.png new file mode 100644 index 0000000000000..bb2bcbce45e97 Binary files /dev/null and b/media/develop/navicat-connection-config-serverless-ssl.png differ