DBeaver 连接 MySQL 实战:新建连接、测试连通和运行 SQL
来源:17golang原创
时间:2026-06-16 11:25:26 269浏览 收藏
DBeaver 是很多开发者常用的数据库客户端,适合连接 MySQL、PostgreSQL、SQLite、Oracle 等数据库。本文只聚焦一个最常见场景:在 DBeaver 里新建 MySQL 连接,测试连通后打开表,再运行一条 SQL 查看结果。
本文适合刚安装 DBeaver、已经知道 MySQL 主机地址和账号密码,但还不熟悉连接向导的读者。示例里使用本地 MySQL,端口为 3306。
目录
- 准备工作:先确认 MySQL 信息
- 新建 DBeaver MySQL 连接
- 驱动下载和连接测试
- 在 Database Navigator 里打开库表
- 执行 SQL 并查看结果
- 常见问题处理
- 最后确认清单
准备工作:先确认 MySQL 信息
打开 DBeaver 前,先准备好这几项信息:
| 字段 | 示例 | 说明 |
|---|---|---|
| Host | 127.0.0.1 |
MySQL 所在机器地址 |
| Port | 3306 |
MySQL 默认端口 |
| Database | testdb |
要连接的数据库名 |
| Username | root |
数据库用户名 |
| Password | 你的密码 | 数据库密码 |
如果是远程数据库,还要确认服务器防火墙、云安全组和 MySQL 用户授权范围。只在本地连接时,127.0.0.1 才是最常用写法。
新建 DBeaver MySQL 连接
启动 DBeaver 后,界面左侧通常是 Database Navigator,顶部是菜单和工具栏。新建连接的常用路径是:点击工具栏的新建连接按钮,或者进入 Database - New Database Connection。

连接向导里按下面顺序操作:
- 在数据库类型里选择 MySQL。
- 进入连接设置页,填写 Host 和 Port。
- 填写 Database、Username 和 Password。
- 如果是个人本机开发环境,可以勾选保存密码;生产环境按团队安全规范处理。
- 点击 Test Connection 测试连接。
- 测试成功后点击 Finish 保存连接。
驱动下载和连接测试
第一次连接 MySQL 时,DBeaver 可能提示需要下载 JDBC 驱动。按提示下载即可。下载完成后再次点击测试连接,如果看到成功提示,说明客户端已经能访问 MySQL。
如果测试失败,优先看错误信息里的关键词:
- Connection refused:MySQL 服务可能没有启动,或端口不对。
- Access denied:用户名、密码或授权范围有问题。
- Unknown database:填写的数据库名不存在。
- Communications link failure:网络、防火墙、安全组或地址填写错误。
测试连接成功只是第一步,后面还要确认库表能展开、SQL 能运行、结果能正常显示。
在 Database Navigator 里打开库表
保存连接后,左侧 Database Navigator 会出现新的连接节点。展开连接后,通常能看到数据库、表、视图、索引等对象。
常见操作路径如下:
- 展开 localhost - testdb。
- 展开 Tables 或 表 节点。
- 双击某张表,比如
user。 - 右侧会出现表结构、数据、属性等标签页。
如果左侧看不到目标库表,可以右键连接节点执行刷新;也可以检查当前账号是否有对应库表权限。
执行 SQL 并查看结果
打开表以后,可以新建 SQL 编辑器,选择当前连接和数据库,然后输入查询语句。

示例查询:
SELECT id, name, created_at FROM user LIMIT 10;
点击运行按钮后,结果会显示在下方表格区域。这里重点检查三件事:
- 结果表是否返回数据。
- 列名和类型是否符合预期。
- 右下角状态栏是否显示成功、耗时和行数。
如果需要导出结果,可以在结果表工具栏里选择导出入口,然后按 CSV、Excel 或 SQL 文件格式导出。导出前建议先确认结果行数,避免误导出过大数据集。
常见问题处理
| 现象 | 原因方向 | 处理方式 |
|---|---|---|
| 测试连接失败 | 地址、端口、网络 | 确认 Host、Port,检查 MySQL 是否监听 |
| 提示密码错误 | 账号或授权 | 重新输入密码,确认账号允许当前来源访问 |
| 看不到表 | 权限或刷新 | 刷新连接,确认当前账号有查询权限 |
| SQL 运行慢 | 条件、索引、数据量 | 先加 LIMIT,再分析执行计划 |
| 中文显示异常 | 连接编码或字段编码 | 检查数据库字符集和连接配置 |
最后确认清单
- DBeaver 左侧能看到 MySQL 连接节点。
- 连接节点下能展开目标数据库。
- 目标表可以打开并显示列信息。
- SQL 编辑器里能选中正确连接和数据库。
- 运行简单查询后能看到结果表。
- 需要导出时,先确认行数和字段范围。
整体流程并不复杂:先新建连接,测试连通,再打开库表,最后运行 SQL 看结果。只要连接信息准备准确,DBeaver 就能很快变成日常查看 MySQL 数据的稳定工具。
-
499 收藏
-
244 收藏
-
235 收藏
-
157 收藏
-
101 收藏
-
文章 · 软件教程 | 1天前 | Redis · 数据库工具 · ttl · 软件教程 · RedisInsight · Key管理 · redis 软件教程 TTL WorkBench RedisInsight Key筛选119 收藏
-
270 收藏
-
文章 · 软件教程 | 2天前 | MySQL · SQL · dbeaver · 软件教程 · 数据库客户端 · mysql 数据库工具 SQL Editor DBeaver Database Navigator465 收藏
-
278 收藏
-
343 收藏
-
105 收藏
-
122 收藏
-
151 收藏
-
213 收藏
-
373 收藏
-
447 收藏
-
250 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习