简介这是一份以 PDF 形式整理的 DBeaver 常用操作指南面向需要日常连接与维护多种数据库的开发人员和数据库管理员帮助读者快速掌握这款免费开源通用数据库工具的核心用法。文档围绕实际开发场景展开重点讲解如何利用“打开声明”查看表列注释和建表 CREATE 语句以理解表结构、通过首选项限制查询返回条数以提升响应速度、借助模板功能输入名称后按两下 Tab 键即可呼出常用 SQL 语句块以及将查询结果集按 CSV、Excel、HTML、JSON 等格式导出的技巧。内容还覆盖多数据库连接管理、图形化执行计划、数据编辑与版本控制集成等实用能力。资源包仅 1 个 PDF 文件大小约 347KB内容精炼、便于随时查阅。目前已有 17717 人浏览学习适合希望提升数据库操作效率、刚开始接触 DBeaver 或从 PL/SQL Developer 等工具迁移的用户。1. Dbeaver 解决什么问题一个客户端管住多套数据库Dbeaver 是一款以 JDBC 驱动为基础的通用数据库客户端把连库、写 SQL、看表结构、导数据、看执行计划这些高频动作都收进了一个窗口。我第一次密集用它是因为要在同一天里面对三套不同体系的数据库每套都有自己的客户端界面还不一样来回切换非常消耗耐心。Dbeaver 的价值在于它把所有数据库的连接入口统一了你只需要记住一份操作习惯就能在 MySQL、PostgreSQL、Oracle、SQLite 之间自由切换。下面的内容适合已经在用或即将用 Dbeaver 的开发者、运维和数据同事社区版就能覆盖绝大多数场景我会把连接、编辑、导入导出、排错这四块常用操作按实际使用顺序拆开讲最后补一组沉淀工作流的技巧。2. 建立连接驱动、URL参数与SSH隧道的实操拆解2.1 首次连接的驱动选择与下载失败处理新建连接的第一步不是填 IP而是选对数据库类型并确保 JDBC 驱动可用。Dbeaver 内置了一套驱动定义首次连接时会尝试从远程仓库拉取对应的 jar 包这一步在网络受限的环境里经常失败。失败时你不会看到红色报错弹窗而是连接测试一直转圈最后提示驱动类无法加载很多新人会误以为是自己填错了主机地址。点开“数据库 → 驱动管理器”找到正在用的数据库类型再点“编辑 → 库”页签可以看到当前驱动依赖的 jar 文件。如果文件列表是空的或者只有几 KB 的残缺文件说明下载没成功。常见做法是到数据库官方渠道下载对应版本的 JDBC 驱动然后在这个页签里手动添加本地 jar。比如 MySQL 就用官方发布的 Connector/JPostgreSQL 就用官方 JDBC 驱动版本尽量和服务器大版本对齐。提示手动添加 jar 后不需要重启 Dbeaver回到连接窗口再点一次“测试连接”即可。如果驱动类名是自动识别出来的不要手动去改一般只有 PG、MySQL 这类常见库能自动识别。2.2 连接 URL 与关键参数时区、SSL 和公钥验证连接窗口的主页签只需要填主机、端口、数据库、用户名和密码但真正决定连接成败的往往是“编辑连接设置”里的高级属性。Dbeaver 会根据数据库类型自动生成 URL 模板你可以直接改这个 URL也可以在“驱动属性”里以键值对形式添加连接参数效果一样。MySQL 8 默认使用 caching_sha2_password 认证方式JDBC 驱动首次连接时如果没有拿到服务器的公钥就会报“Public Key Retrieval is not allowed”。你需要在驱动属性里加 allowPublicKeyRetrievaltrue才能正常连接。时区问题也很常见服务器和本机时区不一致时日期时间会整体偏移 8 小时做法是在 URL 或属性里写明 serverTimezoneAsia/Shanghai。SSL 相关的告警建议在测试环境直接设 useSSLfalse避免因为证书校验失败误伤排查。参数推荐值作用serverTimezoneAsia/Shanghai对齐数据库时区避免时间偏移useSSLfalse测试环境跳过证书校验allowPublicKeyRetrievaltrue解决 MySQL 8 公钥获取报错characterEncodingutf8保证中文字符正常读写PostgreSQL 这边最常见的坑是 sslmode 默认值如果服务器没开 SSL但驱动默认尝试 SSL 优先也会出现握手失败。把 sslmode 设为 disable 可以跳过这一步。驱动属性页签里每一行都有说明改完参数后先测试连接再保存确认无误再去动复杂配置。2.3 走 SSH 隧道连内网数据库很多数据库不能直连只能通过跳板机访问。Dbeaver 的 SSH 隧道功能专门处理这种情况不需要你在本机另外搭隧道工具。在连接设置里找到“SSH”页签打开开关填跳板机地址、端口、用户名认证方式可以用密码也可以用密钥文件。这里的核心坑在于数据库地址要改成 localhost。隧道建立后本机会把远程数据库端口映射到本地JDBC 驱动连接的是这个本地映射端口而不是原来的内网 IP。如果还填着内网 IP连接会走公网路由然后失败这是最常见的 SSH 隧道翻车原因。密钥文件只认 OpenSSH 格式Windows 下常用工具生成的 ppk 格式需要先转换否则会提示格式错误。跳板机和数据库是两个认证体系SSH 页签管的是跳板机登录主连接页签管的是数据库账号。很多人把数据库账号填到 SSH 里结果两边都不对。排错时先确认 SSH 隧道本身能通再看数据库连接参数不要一次改多个变量。3. 编辑器与结果集Dbeaver 写 SQL 时最常用的操作3.1 编辑器快捷键与 SQL 格式化日常写 SQL 离不开编辑器但 Dbeaver 的编辑器有个容易被忽略的特性每个 SQL 编辑器页签都持有自己独立的数据库会话。你在一个页签里改了数据另一个页签要等事务提交后才能看到这决定了后续所有写操作的习惯。编辑器工具栏上的数据库连接按钮可以切换当前页签绑定的连接别写错库。快捷键是提升效率最直接的手段。执行当前光标所在语句用 CtrlEnter执行整个编辑器内容用 AltX格式化 SQL 用 CtrlShiftF大小写转换是 CtrlShiftX 和 CtrlShiftU注释和取消注释是 Ctrl/。格式化对很长的 SQL 可能会卡住尤其是带复杂子查询的脚本可以在“窗口 → 首选项 → SQL 编辑器 → 格式化”里关掉自动格式化。快捷键功能CtrlEnter执行当前光标处语句AltX执行编辑器全部内容CtrlShiftF格式化 SQLCtrlShiftX / U大写 / 小写转换Ctrl/注释 / 取消注释格式化结果不一定符合你的审美但胜在统一。多语句脚本执行时Dbeaver 会按分号切分每条语句的错误都会单列出来方便定位。比在命令行里粘一大段脚本友好得多。3.2 结果集的筛选、编辑与生成 SQL结果集不是一个只读表格它支持直接编辑单元格也支持行内筛选。点击结果集工具栏的漏斗图标会在每列顶部出现筛选输入框你可以不写 WHERE 就完成临时过滤这对快速确认数据范围很有用。排序也一样点击表头就能切换升序降序不必回头改 SQL。结果集里右键某一行弹出的菜单里有“生成 SQL”选项可以生成 INSERT、UPDATE 或 DELETE 语句。这是 Dbeaver 最高效的功能之一你不用手动拼条件Dbeaver 会把当前行的主键和值填进语句里。我一般会用它处理批量修正场景先用筛选器锁定目标行再生成 UPDATE最后把 WHERE 条件检查一遍再执行而不是直接双击单元格乱改。双击单元格改数据时要注意工具栏的自动提交状态。如果自动提交是关着的修改结果只停留在当前会话里别的窗口看不到需要手动保存。结果集底部会显示当前连接、事务状态和影响行数养成看这个状态条的习惯能避免很多“改了半天没生效”的困惑。3.3 执行计划与慢查询定位执行计划是慢 SQL 排查的入口Dbeaver 把入口放在编辑器工具栏的运行按钮旁边下拉就能看到“执行执行计划”。原理是给原 SQL 包一层 EXPLAIN让数据库返回执行路径而不是真的跑完整条查询。对大表来说直接跑一批慢 SQL 会使服务器负载升高看计划反而是最快定位手段。一条查询计划出来后重点看三个信息访问类型 type、索引 key、预估行数 rows。以 MySQL 为例type 从 ALL 到 index 到 range 再到 ref、const级别越来越高。看到 ALL 意味着全表扫描说明 WHERE 条件没有走到索引。rows 是数据库预判要扫描的行数这个数值和实际返回行数差距过大时通常意味着统计信息过期或查询条件写得不合理。EXPLAIN SELECT order_id, amount FROM t_order WHERE status PENDING AND create_time 2025-01-01;如果 EXPLAIN 结果里 type 是 ALL优先检查 create_time 或 status 列上有没有索引。需要注意的是像 status 这种区分度很低的列即使建了索引优化器也可能选择全表扫描这种情况下要结合业务调整过滤条件比如缩短时间范围。执行计划在 Dbeaver 里可以横向展开看每一列的说明鼠标悬停字段名会显示解释比在命令行里一个个猜强很多。4. 数据导出与导入CSV、Excel、SQL 脚本的完整配置4.1 导出结果集格式选择与编码参数导出功能有两个入口一个是在数据导航器右键表名直接导出整表另一个是在结果集窗口右键导出当前查询结果。我一般建议用后者因为能先通过 SQL 把数据范围缩到最小避免导出全表时文件巨大、卡住编辑器。导出向导会先问你格式再看字段和编码。CSV 是通用性最强的格式但如果文件要交给业务同事用 Excel 打开建议导出时把编码选成 UTF-8 带 BOM否则 Excel 打开全是乱码。JSON 适合接口联调或临时交换数据SQL INSERT 格式适合把数据搬去另一套库。Dbeaver 还支持按批次导出数据量大时它会把查询结果分批抓取下来写入文件进度条会显示当前批次不再是一次性灌进内存。导出页面里每个格式都有独立的参数面板最常动的是“包含列标题”“NULL 值表示”“字段分隔符”这三项。NULL 默认可能导出为空字符串接收方如果区分 NULL 和空字符串要把 NULL 值设置成 \N 或约定好的占位符。导出前点一次“预览”看前 100 行比导完再打开文件检查靠谱得多。4.2 导入 CSV 数据字段映射与类型转换导入通常在数据导航器右键目标表选择“导入数据”然后选 CSV 或 Excel 文件。导入向导会自动读取文件头把源列名和目标字段做映射这一步必须人工确认一次因为列名对不上时Dbeaver 会跳过字段而不是报错结果就是数据悄悄少了一半。字符编码是导入翻车重灾区。CSV 文件如果是 GBK 编码但导入向导默认按 UTF-8 读中文会变成乱码或问号。导入前先确认源文件编码再在向导第一步选中对应编码。日期字段要注意格式是否匹配常见错误是 CSV 里写的是 2025/01/01表字段期望的是 2025-01-01这时要在类型映射里指定日期格式。导入性能方面大批量数据建议勾选“使用多行插入”Dbeaver 会合并成带多条 VALUES 的 INSERT 语句显著减少往返次数。如果目标库是 MySQL还可以在连接属性里加 rewriteBatchedStatementstrue让驱动自动重写批量插入导入速度差距可以达到一个数量级。导入前清空目标表是常规操作但一定要先确认清的是哪张表不要只看着表名像就动手。4.3 用 SQL 脚本做库与库之间的同步导出的 SQL INSERT 格式本质上是一份可回放的脚本适合小数据量的库间同步。方式很简单源库导出时选 SQL 格式得到一个 .sql 文件在目标库的 SQL 编辑器里直接打开执行。这个方式不需要两库互通只要文件能传过去就行是跨网络环境下最稳妥的搬运方式。脚本文件比 CSV 更安全的地方在于它保留了字段名和类型不会因为列顺序错位而串数据。缺点是体积大一条 INSERT 一行几万行数据文件就很大。我一般会按业务维度拆分导出比如按日期范围导出增量数据而不是一次性导全表。执行后做一个 COUNT 对比确认两边行数一致再把几处关键统计字段比对一遍。INSERT INTO t_order (id, order_no, amount, status, create_time) VALUES (10001, ORD20250101, 199.00, PAID, 2025-01-01 10:00:00);导出的 SQL 脚本里如果包含外键执行顺序会影响导入成功。目标表有外键约束时先导父表再导子表或者临时关闭外键检查。Dbeaver 的导出向导里能勾选“包含表结构”如果目标库是全新的可以连同 CREATE TABLE 一起导出省的再手动建表。5. Dbeaver 避坑与排查六个最常踩的坑和对应解法5.1 MySQL 8 连接报错Public Key Retrieval is not allowed现象连接测试报这个错换旧版驱动也一样。原因是 MySQL 8 默认认证插件是 caching_sha2_passwordJDBC 驱动第一次握手需要获取服务器公钥但默认安全策略不允许直接获取。解决在驱动属性里添加 allowPublicKeyRetrievaltrue同时按环境设置 useSSLfalse保存后重新测试连接。这个坑新手必踩基本和时区问题是并列的 MySQL 连接两大拦路虎。5.2 驱动包下载失败或加载不到驱动类现象第一次新建连接进度条一直转日志提示仓库连接超时驱动管理器里的 jar 文件为空或很小。原因是 Dbeaver 内置驱动定义不包含 jar 本体首次使用才去公共仓库下载网络受限时自然失败。解决手动下载对应数据库的 JDBC 驱动 jar在驱动管理器里编辑该驱动把本地 jar 添加到库列表随后重置连接即可。连接“测试连接”通过后这个驱动定义会被复用后续新建同类型连接不再需要下载。5.3 导出 CSV 后中文乱码现象用 Excel 打开导出的 CSV中文全是“锟斤拷”或问号或导入别人给的 CSV 时中文变乱码。原因是导出和导入时的字符集不一致。解决导出时选“UTF-8 with BOM”Excel 会更正确识别导入时先确认源文件编码一般 Windows 上生成的文件常见 GBK商用数据交换优先 UTF-8 无 BOM。另外检查目标表字符集MySQL 表要建在 utf8mb4 上不是 gbk。5.4 数据改了却没生效另一个窗口看不到现象在结果集里双击改了值数据看起来变了但刷新查询后还是旧值。原因是当前连接没有开启自动提交修改停留在未提交事务里。解决看编辑器底部状态栏如果有“未提交”字样按保存或点击工具栏提交按钮。注意每个编辑器页签是独立会话提交一个页签不影响另一个。做高风险变更时我会故意关闭自动提交改完后检查一遍再提交相当于给误操作上了后悔药。5.5 查询结果被“截断”以为数据只有那么点现象查询一张几百万行的表结果集只显示部分行往下拖才慢慢加载更多。原因是 Dbeaver 按 fetch size 分批从数据库取数默认值有限滚动时才拉下一批。这不丢数据只是显示策略。解决在连接设置或首选项里调大结果集抓取大小或改用带 LIMIT 的分页查询思路。判断表大小时用 COUNT(*) 而不是翻结果集避免基于“我看到几行”做断言。5.6 结果集里按 Delete 直接删行没确认就写库现象想删除结果集里某几行按 Delete 后行消失了刷新后数据真的没了。原因是结果集默认启用了直接编辑和删除能力部分版本不弹确认框。解决在“窗口 → 首选项 → 数据库 → 编辑器 → 结果集”里勾选删除确认高风险环境的连接设成“只读连接”在连接设置的最后一项这样任何写操作都会直接被拒。删除数据前先右键生成 DELETE 语句并检查 WHERE我是不太敢在手误概率高的场景里直接删行的。6. 把常用操作沉淀成工作流模板、脚本与可控的数据修正6.1 把排查 SQL 收敛成模板高频排查语句不值得每次重新敲比如查看当前事务、找锁、看连接数。Dbeaver 的 SQL 模板功能可以把这些语句存下来输入关键字后按提示插入。我的模板列表里常年放着查 MySQL 事务和锁的语句先看 innodb_trx 里有没有长事务再看锁等待基本能快速定位大部分卡住的场景。SELECT trx_id, trx_state, trx_started, trx_mysql_thread_id, trx_query FROM information_schema.innodb_trx ORDER BY trx_started;模板的意义在于统一格式团队协作时分享一个模板文件新人也能用同一个排查路径不会凭记忆写错字段名。6.2 数据修正的安全习惯修正线上数据时我的固定步骤是先 SELECT 确认范围再通过结果集筛出目标行右键生成 UPDATE 语句检查 WHERE 和赋值是否符合预期最后在确认无误的编辑器里执行。执行后立刻用原 SELECT 复查结果。整个过程里自动提交保持关闭直到最终确认。这样即使某一步判断失误也能通过回滚事务回到起点。6.3 结构差异对比技巧对比两套环境的结构差异常见做法是在各自连接上导出 DDL再用文件对比工具看差异。Dbeaver 在右键表的菜单里提供生成 DDL 的能力把生产库和测试库的 DDL 分别生成两份 SQL 文件用 diff 工具逐段对比。数据量小的时候把两边的结果集分别导出为 CSV 再对比也能快速查到不一致的字段值。社区版没有内置数据比对功能这个方案胜在简单可靠。结构差异最容易藏在这种细节里某张表在测试库多了一个字段生产库没有代码部署后一查询就报字段不存在。把 DDL 对比纳入每次发版前的检查清单能少很多线上报错。我现在每次在 Dbeaver 里跑写操作前都习惯看一眼编辑器右上角的连接名和右下角的事务状态这个习惯帮我避开了很多次连错库和漏提交的问题。希望帮到你。本文还有配套的精品资源点击获取