📣

TiDB Cloud Serverless 现已更名为
Starter
!此页面由 AI 自动翻译,英文原文请见
此处。

使用 MySQL Workbench 连接 TiDB

TiDB 是兼容 MySQL 的数据库,MySQL Workbench 是为 MySQL 数据库用户提供的图形化工具集。

本教程将指导你如何使用 MySQL Workbench 连接到你的 TiDB 集群。

前提条件

完成本教程,你需要:

如果你还没有 TiDB 集群,可以按如下方式创建:

连接 TiDB

根据你选择的 TiDB 部署方式,连接到你的 TiDB 集群。

    1. 进入 Clusters 页面,点击目标集群名称进入其概览页面。

    2. 点击右上角的 Connect,弹出连接对话框。

    3. 确认连接对话框中的配置与你的操作环境一致。

      • Connection Type 设置为 Public
      • Branch 设置为 main
      • Connect With 设置为 MySQL Workbench
      • Operating System 与你的环境一致。
    4. 点击 Generate Password 生成一个随机密码。

    5. 启动 MySQL Workbench,点击 MySQL Connections 标题旁的 +

      MySQL Workbench: add new connection

    6. Setup New Connection 对话框中,配置以下连接参数:

      • Connection Name:为该连接起一个有意义的名称。

      • Hostname:输入 TiDB Cloud 连接对话框中的 HOST 参数。

      • Port:输入 TiDB Cloud 连接对话框中的 PORT 参数。

      • Username:输入 TiDB Cloud 连接对话框中的 USERNAME 参数。

      • Password:点击 Store in Keychain ...Store in Vault,输入 TiDB Cloud Serverless 集群的密码,然后点击 OK 存储密码。

        MySQL Workbench: store the password of TiDB Cloud Serverless in keychain

      下图展示了连接参数的示例:

      MySQL Workbench: configure connection settings for TiDB Cloud Serverless

    7. 点击 Test Connection 验证与 TiDB Cloud Serverless 集群的连接。

    8. 如果连接测试成功,你会看到 Successfully made the MySQL connection 消息。点击 OK 保存连接配置。

    1. 进入 Clusters 页面,点击目标集群名称进入其概览页面。

    2. 点击右上角的 Connect,弹出连接对话框。

    3. 在连接对话框中,从 Connection Type 下拉列表选择 Public,然后点击 CA cert 下载 CA 证书。

      如果你还未配置 IP 访问列表,点击 Configure IP Access List 或按照 配置 IP 访问列表 的步骤进行配置后再首次连接。

      除了 Public 连接类型,TiDB Cloud Dedicated 还支持 Private EndpointVPC Peering 连接类型。更多信息请参见 连接到你的 TiDB Cloud Dedicated 集群

    4. 启动 MySQL Workbench,点击 MySQL Connections 标题旁的 +

      MySQL Workbench: add new connection

    5. Setup New Connection 对话框中,配置以下连接参数:

      • Connection Name:为该连接起一个有意义的名称。

      • Hostname:输入 TiDB Cloud 连接对话框中的 HOST 参数。

      • Port:输入 TiDB Cloud 连接对话框中的 PORT 参数。

      • Username:输入 TiDB Cloud 连接对话框中的 USERNAME 参数。

      • Password:点击 Store in Keychain ...,输入 TiDB Cloud Dedicated 集群的密码,然后点击 OK 存储密码。

        MySQL Workbench: store the password of TiDB Cloud Dedicated in keychain

      下图展示了连接参数的示例:

      MySQL Workbench: configure connection settings for TiDB Cloud Dedicated

    6. 点击 Test Connection 验证与 TiDB Cloud Dedicated 集群的连接。

    7. 如果连接测试成功,你会看到 Successfully made the MySQL connection 消息。点击 OK 保存连接配置。

    1. 启动 MySQL Workbench,点击 MySQL Connections 标题旁的 +

      MySQL Workbench: add new connection

    2. Setup New Connection 对话框中,配置以下连接参数:

      • Connection Name:为该连接起一个有意义的名称。

      • Hostname:输入你的 TiDB 自建集群的 IP 地址或域名。

      • Port:输入你的 TiDB 自建集群的端口号。

      • Username:输入用于连接 TiDB 的用户名。

      • Password:点击 Store in Keychain ...,输入用于连接 TiDB 集群的密码,然后点击 OK 存储密码。

        MySQL Workbench: store the password of TiDB Self-Managed in keychain

      下图展示了连接参数的示例:

      MySQL Workbench: configure connection settings for TiDB Self-Managed

    3. 点击 Test Connection 验证与 TiDB 自建集群的连接。

    4. 如果连接测试成功,你会看到 Successfully made the MySQL connection 消息。点击 OK 保存连接配置。

    常见问题

    如何处理连接超时错误 "Error Code: 2013. Lost connection to MySQL server during query"?

    该错误表示查询执行时间超过了超时时间限制。你可以通过以下步骤调整超时设置来解决此问题:

    1. 启动 MySQL Workbench,进入 Workbench Preferences 页面。

    2. SQL Editor > MySQL Session 部分,配置 DBMS connection read timeout interval (in seconds) 选项。该选项设置了查询最大允许执行时间(秒),超时后 MySQL Workbench 会断开与服务器的连接。

      MySQL Workbench: adjust timeout option in SQL Editor settings

    更多信息请参见 MySQL Workbench 常见问题

    后续步骤

    需要帮助?

    DiscordSlack 社区提问,或 提交支持工单

    文档内容是否有帮助?