DBeaver 数据库工具快速上手:3 步完成首次连接,避开 4 个新手坑
【免费下载链接】dbeaverFree universal database tool and SQL client项目地址: https://gitcode.com/GitHub_Trending/db/dbeaver
DBeaver 是一款免费开源的通用数据库管理工具和 SQL 客户端,一个界面就能连 MySQL、PostgreSQL、Oracle、ClickHouse、SQLite 等 40 多种数据库。按下面的路径走完首次连接、日常查数、进阶配置到排坑,你就能独立应对绝大部分日常场景。
三步完成首次数据库连接
刚打开 DBeaver,左侧导航树是空的——第一步就是把你自己的数据库接进来。
向导里该填什么
- 点左侧导航栏顶部的数据库图标,打开新连接向导(New Connection Wizard)
- 选数据库类型,填主机、端口、用户名、密码
- 点 Test Connection 验证,成功后保存
端口记不住就查这张表:
| 数据库 | 默认端口 |
|---|---|
| MySQL / MariaDB | 3306 |
| PostgreSQL | 5432 |
| SQL Server | 1433 |
| Oracle | 1521 |
| SQLite | 无端口,直接选本地 .db 文件 |
驱动不用手动装
测试连接时如果提示缺驱动,DBeaver 会自动下载对应 JDBC 驱动,等进度条走完即可;下载失败的排查见第 4 节。远程或内网数据库,在向导的 SSH 页签勾选隧道,DBeaver 会先建 SSH 通道再走数据库连接。
连接通了之后,你大概率想先翻一张表看看数据。
查表、改数、导出:最高频的 2 个操作
连上库,十有八九你先想干两件事:看看数据长什么样,再把结果拿走。
浏览表结构并执行查询
在导航树展开 数据库 → 目录 → 模式 → 表,双击表名右侧会打开数据网格。想自己写 SQL,用菜单 Database → SQL Editor 新建脚本,编辑器会根据表元数据自动补全表名和列名:Ctrl+Enter执行光标所在语句,Ctrl+Shift+Enter执行整段脚本。
把结果导出成文件
在查询结果的网格上右键 → Export data,可选 CSV、Excel、JSON、SQL 脚本等格式。跨库迁移(比如 MySQL 搬数据到 PostgreSQL)走 Data Transfer 功能,选源结果集再指定目标连接即可,注意开启分批写入,避免一次性撑爆内存,数据迁移模块源码 里可以看到各类格式的处理逻辑。
查数导出都顺了,再花 10 分钟做几个设置,后面会省不少事。
⚡ 进阶配置:快捷键、内存与连接参数
记住这 4 个快捷键
Ctrl+Enter执行当前语句;Ctrl+Shift+Enter执行全部语句;Ctrl+/注释或取消注释选中行;F3跳转到对象定义。另外把常用 SQL 存到导航树的 Scripts 节点,连接按项目建文件夹分组,找起来会快很多。
内存与连接参数建议
大结果集查询卡顿,多半是 JVM 堆不够。在安装目录编辑dbeaver.ini,加两行后重启:
-Xms256m -Xmx2048m| 参数 | 建议值 | 作用 |
|---|---|---|
-Xmx(dbeaver.ini) | 2048m 起步 | 大结果集查询防卡顿 |
| 连接超时 | 30 秒 | 连不上的库不长时间挂起 |
| 数据抓取行数 | 按查询量调整 | 大报表调大,减少往返次数 |
| 查询日志落盘 | 开启 | 事后分析慢查询耗时 |
参数都调完,剩下的麻烦基本就那几类。
连不上、查不动?4 个高频坑逐个拆
工具用顺了之后偶尔还是会卡壳,对照下面两条清单,大部分问题不用翻源码就能定位。
连接失败的排查顺序
- 驱动没下下来——网络受限时自动下载会失败,在驱动设置里手动指定本地 jar
- 主机或端口填错——确认端口没被中间件改掉,用
telnet 主机 端口先验证连通性 - 账号权限不足——能连上但看不到表,通常是 schema 权限问题
- 走 SSH 的隧道断了——确认 SSH 主机、端口和密钥
日志在哪看
菜单 Window → Show View → DBeaver Log 打开应用日志,连库报错、驱动加载失败都会记录在这里;查询执行日志则在 Preferences 的 Query Manager 里勾选 Save log to file(s),配合日志文件位置设置即可事后分析。
DBeaver 的核心价值,是一套界面打通 40 多种数据库的日常查数与导出。建议先把最常用的那个连接按前面步骤走一遍,再试着把一条查询结果导出成 CSV——这两件事跑通,就算正式上手了。
【免费下载链接】dbeaverFree universal database tool and SQL client项目地址: https://gitcode.com/GitHub_Trending/db/dbeaver
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考