乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > DBeaver使用文档

DBeaver使用文档

当前时间： 2026-07-01 09:56:26 更新时间： 2026-07-01 分类：软件教程 评论(0)

DBeaver使用文档

DBeaver 完整手册：官方文档、高频常见问题、开发运维注意事项

一、DBeaver 官方权威文档

1. 核心官方地址

  1. 产品总文档入口（社区/专业版通用）
    https://dbeaver.com/docs/dbeaver/
  2. 快速上手教程
    https://dbeaver.com/docs/dbeaver/Getting-started/
  3. 完整用户手册PDF
    https://dbeaver.com/doc/DBeaver_v_6_2.pdf
  4. 驱动/连接/SSH隧道专题文档
    https://dbeaver.com/docs/dbeaver/Connections/
  5. 官方FAQ故障排查
    https://dbeaver.com/docs/dbeaver/Troubleshooting/
  6. GitHub开源社区版（社区文档、issue反馈）
    https://github.com/dbeaver/dbeaver
  7. 中文非官方参考手册
    https://www.dbeaver.net.cn/docs/

2. 文档核心板块（开发高频查阅）

  1. Connections
    ：新建连接、SSH隧道、SSL、驱动配置、保活、超时设置
  2. SQL Editor
    ：编辑器语法、执行规则、格式化、模板、本地历史、执行计划
  3. Data Transfer
    ：导入导出CSV/Excel/SQL、批量数据迁移、大文件处理
  4. ER Diagrams
    ：实体关系图、表关联、导出结构图
  5. Security
    ：密码加密存储、主密码、自动化无密码任务配置
  6. Performance Tuning
    ：内存调优、分页加载、查询性能优化
  7. Debug & Scripts
    ：存储过程调试、批量脚本执行、定时任务
  8. Shortcuts
    ：全量快捷键清单

3. 版本区分

  • DBeaver Community（社区免费）
    ：个人开发、基础连接、SQL编辑，无企业批量、高级审计
  • DBeaver PRO/Enterprise
    ：团队管理、数据对比、AI助手、批量导出、权限管控、定时任务

二、DBeaver 高频常用操作&快捷键

（一）SQL编辑器核心快捷键（Windows）

快捷键
功能
Ctrl+Enter
执行光标所在单条SQL（最常用）
Ctrl+Shift+Enter
执行编辑器全部SQL
Ctrl+Shift+F
SQL格式化
Ctrl+Shift+X / Y
选中SQL转大写/小写
Ctrl+空格
表/字段自动补全
Ctrl+/
单行注释
Ctrl+Shift+/
块注释
F5
刷新数据库元数据
F4
查看表详情（字段、索引、约束）
Ctrl+Alt+T
自定义SQL模板（select/insert/update）
Ctrl+`
打开执行计划Explain
Ctrl+- / Ctrl++
编辑器字体缩放

（二）核心功能操作

  1. SSH隧道连接内网数据库
    编辑连接 → SSH标签页，填写跳板机IP、端口、账号密钥，自动端口转发，无需本地代理工具。
  2. 本地历史（找回未保存SQL）
    编辑器右键 → 本地历史记录，自动保存所有修改，断电/误关闭可恢复脚本。
  3. ER图生成
    选中库/多张表 → 右键 → 查看ER图，自动展示外键关联，支持导出PNG/PDF。
  4. 批量导入导出
    右键表 → 导出数据（CSV/Excel/SQL）；工具→执行脚本，超大SQL文件不卡顿编辑器。
  5. 事务手动控制
    顶部切换自动提交Auto-Commit，关闭后手动Commit/Rollback，测试UPDATE/DELETE防误删。
  6. 执行计划优化SQL
    选中SQL点击解释计划，定位全表扫描、无索引、关联瓶颈。

三、高频常见问题 & 解决方案

1. 连接类报错（最多）

（1）驱动缺失/下载失败

现象：测试连接提示“找不到JDBC驱动”解决：编辑连接 → 驱动设置 → 点击下载；网络差手动上传本地jar包，匹配数据库版本。

（2）MySQL 8.x 登录认证失败 caching_sha2_password

旧驱动不支持新加密插件：

  1. 升级DBeaver驱动至最新；
  2. 或修改数据库用户认证：ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'xxx';

（3）闲置一段时间自动断开连接

原因：防火墙/数据库超时回收空闲连接修复：编辑连接 → SQL编辑器 → 开启保持连接Keep-Alive，间隔60s；初始化连接填入SELECT 1心跳语句。

（4）SSH隧道连接失败

  1. 跳板机22端口不通，telnet测试；
  2. 私钥权限过高（Windows无影响，Linux私钥600权限）；
  3. 隧道本地端口被占用，修改SSH本地转发端口。

（5）SSL握手异常 PKIX

编辑连接 → SSL → SSL Mode改为DISABLED；JDBC链接追加useSSL=false&verifyServerCertificate=false。

（6）No active connection 无法执行SQL

编辑器顶部下拉框未选中数据库连接，切换对应连接即可。

2. SQL执行异常

（1）多条SQL一起执行报错，仅单条生效

MySQL默认禁止多语句；编辑连接→驱动属性，开启allowMultiQueries=true。

（2）存储过程/匿名块执行报错（Oracle/PG）

光标必须放在脚本第一行，或全选整个存储过程再执行；光标在中间行会截断语法报错。

（3）查询百万级大表卡顿、软件卡死

默认客户端拉取全量数据再分页；设置：首选项→数据编辑器→开启Use SQL to limit fetch size，数据库侧分页，减少网络IO。

（4）中文乱码

  1. 连接URL追加characterEncoding=utf8mb4；
  2. 编辑器文件编码统一UTF-8；
  3. 数据库show variables like '%character%'确认服务端UTF8。

3. 功能故障

（1）ER图不显示关联、空白

  1. 表无外键约束则无连线；
  2. 重新刷新库元数据（F5）；
  3. 删除旧ER图重新拖拽表生成。

（2）自动补全失效、无字段提示

  1. 刷新数据库元数据；
  2. 首选项→编辑器关闭自定义过滤；
  3. 重启DBeaver重建缓存。

（3）软件启动卡顿、内存溢出

修改安装目录dbeaver.ini，调大-Xmx（推荐2048m/4096m）；定期清理缓存：文件→无效缓存并重启。

（4）导入Excel/CSV乱码、字段错位

导入向导第一步指定文件编码UTF-8，分隔符匹配源文件。

（5）执行TRUNCATE/DELETE无确认弹窗

首选项→SQL编辑器→开启危险操作确认弹窗。

4. 密码安全类问题

（1）换电脑连接密码丢失

窗口→首选项→通用→安全，导出密码库；设置主密码加密存储凭证。

（2）定时任务后台执行提示输入密码

加密方式切换为Automation (console)，无头模式免交互认证。

四、开发&运维使用注意点（安全、性能、规范）

（一）生产环境安全红线（重中之重）

  1. 严格区分生产/测试/本地连接分组
    新建文件夹分类，命名标注【生产】，防止误操作线上库。
  2. 禁止长期保存生产数据库密码在公用电脑
    公用设备不勾选保存密码；个人电脑设置主密码加密所有凭证。
  3. 线上执行DML必须关闭自动提交
    UPDATE/DELETE/批量更新前关闭Auto-Commit，执行后核对行数再手动Commit，出错直接Rollback回滚。
  4. 禁止裸执行无WHERE条件的DELETE/UPDATE
    开启危险SQL弹窗确认；大批量删除分批次执行，避免锁表阻塞业务。
  5. 公网数据库必须使用SSH隧道+SSL双重加密
    不直接暴露3306/5432等端口，禁止明文直连生产库。
  6. 敏感数据导出管控
    手机号、身份证、订单数据导出后及时删除本地文件，不随意转发Excel；导出时脱敏。
  7. 不使用第三方修改/汉化破解版
    仅官网原版，破解版存在窃取数据库账号风险。

（二）SQL开发规范注意点

  1. 统一使用格式化快捷键Ctrl+Shift+F，团队SQL风格统一。
  2. 复杂查询必须用执行计划校验索引，杜绝线上全表扫描。
  3. 超大SQL脚本不要直接打开编辑器，使用「工具-执行脚本」后台运行，避免内存卡死。
  4. 禁止SELECT * 查询，只查询需要字段，减少数据传输。
  5. 线上禁止一次性查询十万级无分页数据，加LIMIT分批查看。
  6. 存储过程、DDL脚本全选执行，避免光标位置导致语法截断报错。
  7. 定期保存SQL脚本到项目目录，依赖编辑器本地历史不可靠。

（三）性能优化使用规范

  1. 大表查询开启数据库侧分页，避免客户端全量拉取数据。
  2. 闲置连接配置心跳保活，反复重连会频繁创建销毁连接，消耗数据库连接池。
  3. 不一次性加载几十张大表ER图，分批次查看，防止软件卡顿。
  4. 定期清理查询历史、导出缓存、无用ER图，减少内存占用。
  5. 批量数据迁移优先使用内置导出导入工具，比手动复制粘贴高效稳定。

（四）连接配置规范

  1. 生产连接单独配置超时参数：连接超时、读取超时缩短，防止卡死线程。
  2. 本地开发关闭SSL，线上强制开启SSL加密传输。
  3. 多环境统一驱动版本，避免驱动差异导致SQL语法兼容问题。
  4. 连接备注写明负责人、业务库、IP，方便多人协作识别。

（五）团队协作&工程化注意点

  1. 导出连接配置分享给团队，统一数据库地址、驱动、SSH参数。
  2. 公共SQL模板统一导出，团队导入复用（分页、分页统计、分页更新模板）。
  3. 线上高危操作（删表、改字段、清数据）先在测试库复现，确认无误再执行。
  4. 所有线上变更SQL留存脚本，记录操作时间、操作人员，用于审计溯源。
  5. 定期备份DBeaver工作区，防止重装软件丢失连接、SQL脚本。

（六）其他避坑要点

  1. Windows与Linux导出CSV换行符不一致，导入前用工具转换换行。
  2. 批量TRUNCATE会清空整表，不可回滚，操作前务必备份数据。
  3. 数据库字段注释乱码，统一连接字符集utf8mb4。
  4. 定时同步、数据迁移脚本不要硬编码密码，使用SSH密钥免密登录。
  5. 软件定期更新，修复驱动漏洞、连接稳定性bug。