讲师中心 微信公众号
AI工具推荐 视频效率加速

如何通过Navicat连接到TiDB数据库_通过MySQL协议与4000端口进行连接

轻枫大大_6058

轻枫大大_6058

发布时间:2026-05-24 18:27:54

|

373人浏览过

|

来源于php中文网

原创

Navicat 连接 TiDB 的本质是将其作为兼容 MySQL 协议的数据库使用,但必须选用官方支持的“TiDB”专用连接类型(非 MySQL),配合正确 HOST/PORT、SSL 强制验证及权限配置。

navicat 连接 tidb 的本质,就是把它当做一个兼容 mysql 协议的数据库来用——只要协议对、端口通、认证过,就能连上。但直接填 4000 端口 + mysql 驱动,大概率会失败或功能异常,因为 tidb 官方推荐且 navicat 正式支持的是专用的 tidb 连接类型(不是选 mysql)。

必须选 “TiDB” 连接类型,不能选 “MySQL”

Navicat Premium 17.1.6+ 内置了原生 TiDB 连接驱动,它会自动适配 TiDB 的认证机制(如 mysql_native_password)、元数据查询行为和部分 SQL 语法提示。若强行用 MySQL 类型连接:

  • 常见错误:Authentication plugin 'caching_sha2_password' cannot be loaded(TiDB 默认不启用该插件,但 MySQL 驱动会尝试协商)
  • 表结构编辑可能报错或丢失字段注释
  • 视图/存储过程等对象在左侧导航树中无法正确展开
  • SSL 配置项位置不同,容易漏设

正确做法:点击 Connection → 在 Vendor Filter 中勾选 PingCAP → 双击 TiDB,而非 MySQL。

Host 和 Port 填什么,取决于部署形态

4000 确实是 TiDB Server 的默认端口,但它只适用于本地或直连网络通畅的场景。实际填写需分情况:

  • TiDB Cloud Serverless/Dedicated:从控制台 Connect 页面获取的 HOST 和 PORT,不是固定 4000(Serverless 通常为 4000,Dedicated 可能是 4000 或 6000,以控制台为准)
  • 本地部署 TiDB:若未改配置,填 127.0.0.1 和 4000 即可;但注意 tidb-server 是否监听了 0.0.0.0:4000(检查 config.toml 中的 host 和 port)
  • Docker 启动的 TiDB:确保端口已映射,例如 -p 4000:4000,且容器内 tidb-server 配置允许外部连接

SSL 配置不是可选项,而是强制路径

TiDB Cloud 所有集群(Serverless/Dedicated)均强制要求 SSL 加密传输,且必须验证服务端证书。Navicat 中必须设置:

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载
  • 勾选 Use SSL
  • 勾选 Use authentication
  • 勾选 Verify server certificate against CA
  • CA Certificate 字段填入从 TiDB Cloud Connect 对话框下载的 ca.pem 文件绝对路径(Windows 下注意反斜杠转义或用正斜杠)

漏掉任一选项,测试连接时会出现类似 SSL connection error: unknown error number 或直接超时。本地部署 TiDB 若未启用 TLS,则可不勾选 SSL,但生产环境不建议跳过。

用户名格式和权限常被忽略

TiDB 的用户体系与 MySQL 兼容,但有两点关键细节:

  • 用户名必须带 host 限定(如 root@%),但 Navicat 的 User Name 字段只填用户名本体(root),host 由 TiDB 服务端策略控制,无需手动拼接
  • 首次连接后,若执行 DDL 报 Access denied,大概率是用户缺少 CREATE/ALTER 权限,需用 root 登录后运行:GRANT ALL PRIVILEGES ON *.* TO 'your_user'@'%'; FLUSH PRIVILEGES;
  • TiDB Cloud 默认用户是 root,密码由控制台生成,不可改;本地部署默认也是 root,无密码(首次连接后建议立即设密码)

最易卡住的点:以为填对了所有参数,结果连上却看不见任何数据库——其实是用户没被授权访问任何 schema,得先授予权限再刷新连接。

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2293

2023.06.20

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

1399

2023.06.21

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

815

2023.07.18

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3172

2023.07.19

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

5388

2023.07.25

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

1199

2023.08.08

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

5651

2023.08.11

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

4942

2023.08.14

Playwright 测试失败怎么办
Playwright 测试失败怎么办

Playwright测试失败专题汇集超时、定位器匹配、浏览器提前关闭、依赖与插件配置、文件上传、SSL及Docker启动等故障文章,并介绍通过截图、报告和Trace定位错误。

0

2026.10.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 188人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn