DBeaver：多数据源客户端的连接、事务与团队治理
多数据库工作台与驱动
DBeaver 用 Database Navigator 管理连接和对象，用 SQL Editor 执行查询，用 Data Transfer 导入或导出数据。切换数据库时可以保留相似的操作入口，SQL 方言、事务和类型转换仍由各自驱动与服务端决定。
在 Ubuntu 安装 Community 并执行第一条查询
以下选择 Ubuntu 24.04 桌面 x86-64、DBeaver Community 26.2.0 和 PostgreSQL 18.6。图形步骤依据官方文档，尚未实际点击验证。到 Community 下载页 选择 Linux Debian x86-64 包；若下载页已更新，使用官方 26.2.0 文件目录取得本例的固定版本。核对下载来源、发行信息和文件摘要，在下载目录检查实际文件名后安装：
test -f ./dbeaver-ce-26.2.0-linux-x86_64.deb
sudo apt install ./dbeaver-ce-26.2.0-linux-x86_64.deb
dpkg-query -W -f='${Version}\n' dbeaver-ce
dbeaverdpkg-query 应显示 26.2.0；安装需要 sudo，启动和后续操作使用普通桌面用户。若实际下载文件名不同，先核对版本和架构，不把其他架构的包改名后安装。
下载 合成数据库准备脚本 到新的可写工作目录，安装好 Docker、OpenSSL 后执行 bash prepare.sh。脚本打印 client-lab.* 目录，创建三条订单状态样本；默认仅发布回环端口 15432，冲突时用 CLIENT_LAB_PORT=15433 bash prepare.sh 创建独立实例，不重用旧卷。
点击 Database → New Database Connection，选择 PostgreSQL。Main 页填写 Host 127.0.0.1、Port 15432、Database client_lab、Username lab_writer，密码从实验目录的 secrets/writer.password 取得。
选择 Development 连接类型。本机合成库不启用 SSH/TLS；跨机连接必须配置受信 CA 和主机名校验。Test Connection 提示缺驱动时，从受信源下载 PostgreSQL 驱动，成功后 Finish。
在 Database Navigator 展开 client_lab → Schemas → lab → Tables，应看到 client_guard_lab。右键连接选择 SQL Editor → New SQL Script，确认编辑器绑定刚才的连接与 lab schema，执行下列 SQL。菜单说明见 Create Connection。
SELECT current_database(),current_user,current_schema();
SELECT id,status,created_at FROM lab.client_guard_lab ORDER BY id;结果应为 client_lab / lab_writer / lab 和三行，状态 CREATED、PAID、CREATED。对象树没有表但 SQL 成功时，先刷新 lab 或检查 Navigator 过滤器；SQL 也缺表才检查初始化输出和连接目标。
Manual commit、结果网格与 CSV 往返
工具栏切为 Manual commit，关闭“事务结束后回到 Auto-commit”的选项。执行 UPDATE lab.client_guard_lab SET status='PAID' WHERE id=1;，同一编辑器查询应看到 PAID。点击 Rollback 后重新查询，应恢复 CREATED。再做一次更新并点击 Commit，独立只读连接才应读到 PAID；最后用写连接改回 CREATED 并 Commit，保持后续实验基线。编辑器关闭前检查待提交事务，避免留下锁。
重新查询 SELECT id,status FROM lab.client_guard_lab ORDER BY id。在结果网格右键选择 Export Data，格式 CSV，导出本次查询的全部三行而非仅已选中单元格，启用 header、UTF-8，写到实验目录 dbeaver-result.csv。先用文本编辑器检查两列三行，再以 writer 执行：
CREATE TABLE lab.client_import_check(id integer PRIMARY KEY,status varchar(24) NOT NULL);
COMMIT;在 Navigator 对这个空表右键 Import Data，选择 CSV 文件，将 id/status 映射到同名列，确认不选择覆盖其他表，执行后查询 SELECT * FROM lab.client_import_check ORDER BY id;，应与原查询相同。导入报类型、重复键或行数差异时，先读任务日志，不反复导入同一非空表。入口见 Data export。
复制连接为只读实验连接，改用 lab_reader 及 secrets/reader.password。它能查询 client_guard_lab，不能 UPDATE 或创建新表，后文据此比较数据库权限与本地 Security 选项。
结束后关闭各连接，下载 清理脚本 到本次打印的实验目录，在该目录执行并输入容器名；只删除本次合成数据。密码和 CSV 按需另行清除。初始化密码使用容器环境传递，Docker 管理员可见，仅用于这个本机实验。
Community 与各类商业产品的能力和许可边界不同，安装时应以计划采用的 edition 官方文档为准，不把另一 edition 的界面和管控能力写进统一手册。组织基线记录发行来源、安装包哈希、许可 owner、允许的扩展与回滚版本。版本号和价格变化快，不适合固化在长期文章；更可靠的是在升级窗口重新核对兼容矩阵与许可证条款。
多数据源不等于万能语义层。DBeaver 通过具体 driver 与服务端通信，不同数据库的 schema、catalog、事务、Explain 和类型系统仍然不同。团队可以统一安全底线，不能用一份截图式教程假装所有数据库行为一致。
Driver Manager 是复现起点
新建连接前，先按官方 Create connection 的配置层次，在 Driver Manager 核对驱动类、文件、URL 模板和来源。自动下载方便，但受限网络、供应链审计和历史项目往往需要固定仓库与版本。把驱动坐标或文件哈希写进团队基线；不要从同事机器复制来源不明的 JAR，也不要为了让旧驱动握手成功而关闭 TLS 校验。
驱动升级的最小回归包括认证、证书链、时区、字符集、JSON/数组/大数类型、分页抓取、statement cancel 和 prepared statement。DBeaver 展示的功能入口不代表每种驱动都完整实现。某项能力灰掉或行为异常时，先区分 Community/PRO 差异、DBeaver 功能和 driver/DBMS 限制，再决定修复位置。
离线或受限网络还要验证驱动能否从批准镜像恢复。新电脑只拿到 DBeaver 安装包，却必须访问公共仓库才能打开历史连接，说明供应链基线不完整。缓存下来的 JAR 也不能直接充当团队制品库；应有校验、来源和已验证的数据库范围。
连接名称采用 system-db-env-privilege，例如 billing-mysql-prod-ro。配置 host、port、database、user 后，再进入 SSH、SSL 和 initialization。SSH host key 校验不能因为首次连接失败就 bypass；TLS 必须验证 CA 与目标主机身份。database host 在隧道场景中可能从远端侧解析，故障记录要同时保留客户端到跳板机、跳板机到数据库两段证据。
Filters 用来限制 Database Navigator 展示的 schema、表或视图，能降低元数据扫描和误操作范围，但它不是权限。隐藏对象后，知道全名的账号仍可能访问。过滤范围、默认 database/schema 与服务端授权需要分别验收。
Connection type 是护栏，不是防火墙
DBeaver 的 connection type 可以区分 Development、Test、Production，提供颜色、事务默认值和执行确认。生产连接应使用醒目的独立颜色和名称，开启 SQL 执行、数据修改确认，并采用符合团队策略的 idle transaction 与 idle connection 回收。新连接默认可能不是 Production，导入连接后必须重新检查。
连接设置中的 Security 还能限制数据编辑、结构修改、脚本执行和数据导入。这些选项很有价值：它们能阻止大部分鼠标误触和常规执行路径。但官方说明同样清楚，这类限制不会改变数据库本身。任何人换客户端、脚本或被绕过的执行入口后，最终权限仍由服务端账号决定。
所以生产只读验收必须包含反证。先在开发测试库用计划中的只读角色执行有限查询，再对专用对象尝试 DDL：
SELECT id, status, created_at
FROM client_guard_lab
ORDER BY id DESC
LIMIT 20;
CREATE TABLE readonly_probe(id integer);第一条应返回小样本，第二条必须被服务端拒绝。若 DDL 成功，不要继续调客户端颜色和确认框；应清理测试对象，收回角色权限，并用厂商 CLI 复验。服务端拒绝是边界，connection type 和 Security 是第二层保险。
事务模式比红色背景更值得盯住
DBeaver 官方 Transaction mode 说明了 Auto-commit 和 Manual commit 的差异。Auto-commit 下，每条修改语句执行后立即提交，无法依靠后续 Rollback 撤销。Manual commit 会把修改留在事务中，直到明确 Commit 或 Rollback；这给人检查机会，也可能留下长事务和锁。
Smart commit 介于两者之间：保持 Auto-commit 时，遇到数据修改语句先切换到 Manual。它能减少误提交，但仍不能识别所有有副作用的存储过程、数据库函数或厂商扩展。Production connection type 通常应以 Manual 为基础，再按团队经验决定是否启用 Smart commit 和“事务结束后返回 Auto-commit”。不要让一次 Rollback 之后悄悄回到不同的提交习惯。
开始排障前，先看工具栏事务图标、隔离级别和当前 connection。结束前打开 pending transactions 或 transaction log，逐一处理未结束事务。关闭编辑器、断开网络或退出程序都不等于业务上正确回滚；以服务端会话与锁状态为最终证据。
初始化设置可以配置默认 database/schema、keep-alive、idle timeout 和 bootstrap query。bootstrap query 每次建连都会运行，适合设置安全的 session 参数，不适合偷偷切角色、修改业务状态或塞入凭据。它必须进入配置审查，并在干净环境验证重复执行是否幂等。
从 SQL Editor 到 Query Manager，留下的是本地事实
SQL Editor 的查询应从明确列、过滤条件和行数上限开始。打开大表的数据编辑器可能触发分页、计数和元数据查询；出现慢响应时，先查看生成 SQL 和服务端活动会话，不要连续刷新。Explain 与实际执行计划的副作用由数据库决定，任何带 Analyse、Actual 或 Profile 含义的操作都要确认是否真实执行。
Query Manager、transaction log 和 SQL history 便于复盘，但不能直接当合规审计。它们可能受本地设置、edition、清理周期和异常退出影响，也可能保存内部 SQL、参数、域名或错误消息。团队应明确哪些记录允许保留、保存多久、事件结束怎样清理；正式审计仍由数据库或集中代理完成。
连接导出和项目配置也要用干净账号检查。共享文件中只保留 endpoint、数据库、驱动标识、TLS 模式、owner 与申请入口，不携带密码、token、SSH 私钥或能直接登录的认证属性。即使密码字段被遮住，也要实际打开导出文件确认，而不是相信界面上的星号。
Data Transfer 是强能力，也是一条新的数据出境路径
DBeaver 的 Data Transfer 能在多种格式和数据源之间移动内容。正因为入口统一，使用者很容易把一次临时导出升级成没有 owner 的数据管道。小样本排障应显式选择列、过滤条件、最大行数、编码、NULL 和时间格式，并写入受控临时目录。导出完成后重新读入临时目标，核对行列、脱敏和时间语义。
跨库迁移、周期同步、百万行导出或自动重试不属于个人客户端的理想职责。它们需要服务端作业、资源隔离、断点恢复、审计与数据保留策略。DBeaver 可以用于设计和验证映射，但稳定运行应迁移到受控数据平台。
反向验收同样重要：尝试在 Production connection type 下启动被禁止的数据导入或编辑，预期客户端先阻止；换到 CLI 后，同一只读账号仍必须被服务端阻止。这样能分别证明本地护栏和真实权限，而不是只证明某个按钮不可点击。
团队落地要保留差异，而不是追求一份万能导入包
一个可维护的 DBeaver 基线包括允许的 edition、受信驱动来源、连接命名、环境颜色、Production 默认事务、安全限制、history 保留、导出目录和卸载流程。数据库专属的认证、TLS、schema 和 Explain 行为由各数据库附录负责，不硬塞进一个通用连接模板。
建议仓库保存如下契约：
connection: billing-postgres-prod-ro
edition-scope: capabilities verified for approved DBeaver edition
driver: approved coordinate and checksum
route: VPN -> bastion -> database
tls: hostname verification required
identity: personal short-lived readonly role
client-guards: Production type, manual commit, edit/import disabled
server-guards: DDL/DML denied, audit enabled
export: 20-row redacted sample to controlled temp directory退出时先处理 pending transactions，断开连接，清理保存凭据、SSH 引用、证书副本、history、Query Manager 数据和导出物；再撤销数据库角色、网络白名单与代理会话。商业 edition 还需回收席位。确认项目中没有残留可直接登录的连接文件后，才卸载客户端和驱动缓存。