大网数据广告活动
数据库部署与 SQL 参考

通过 MySQL 工具连接到 TiDB

· 52CE 我爱测

TiDB 支持 MySQL 客户端/服务器协议。这使得大多数客户端驱动程序和 ORM 框架可以像连接到 MySQL 一样地连接到 TiDB。

通过 MySQL 工具连接到 TiDB

TiDB 高度兼容 MySQL 协议,全量的客户端连接参数列表,请参阅 MySQL Client Options。

TiDB 支持 MySQL 客户端/服务器协议。这使得大多数客户端驱动程序和 ORM 框架可以像连接到 MySQL 一样地连接到 TiDB。

你可以选择使用 MySQL Client 或 MySQL Shell 连接到 TiDB。

你可以使用 MySQL Client 作为 TiDB 的命令行工具连接到 TiDB。下面以基于 YUM 的 Linux 发行版为例,介绍如何安装 MySQL Client。

sudo yum install mysql

安装完成后,你可以使用如下命令连接到 TiDB:

mysql --host <tidb_server_host> --port 4000 -u root -p --comments

macOS 上的 MySQL 9.x 客户端无法正确加载 mysql_native_password 插件,导致连接 TiDB 时报错 ERROR 2059 (HY000): Authentication plugin 'mysql_native_password' cannot be loaded。为解决该问题,建议安装并使用 MySQL 8.0 客户端来连接 TiDB 。安装命令如下:

brew install mysql-client@8.0
brew unlink mysql
brew link mysql-client@8.0

如果仍然遇到问题,可以尝试指定 MySQL 8.0 客户端的安装路径来使用 MySQL 8.0 客户端连接 TiDB。连接命令如下:

/opt/homebrew/opt/mysql-client@8.0/bin/mysql --comments --host ${YOUR_IP_ADDRESS} --port ${YOUR_PORT_NUMBER} -u ${your_user_name} -p

请使用实际部署的 MySQL 8.0 客户端的安装路径替代上述命令中的 /opt/homebrew/opt/mysql-client@8.0/bin/mysql。

你可以使用 MySQL Shell 作为 TiDB 的命令行工具连接到 TiDB。参考 MySQL Shell 文档进行安装。安装完成后,你可以使用如下命令连接到 TiDB:

mysqlsh --sql mysql://root@<tidb_server_host>:4000

本文来自 PingCAP / TiDB 文档贡献者,按 CC BY-SA 3.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
PingCAP / TiDB 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY-SA 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。