“dbvr”是数据库管理工具 DBeaver 推出的命令行工具，官网为 https://dbeaver.io/（实测 HTTP 200，标题「DBeaver Community | Free Open-Source Database Management Tool」）。它的价值在于：把 DBeaver 的元数据、SQL 执行、数据导入导出能力搬到终端与 CI 流水线里，不需要打开图形界面。本文说明它的定位、能做什么、典型命令与使用边界。

一、先分清两个 CLI

DBeaver 生态里有两种“命令行”：

1. dbeaver-cli：DBeaver 桌面版自带，用于无界面执行 SQL 脚本（启动后跑 SQL 文件，输出结果，适合批量执行）。
2. dbvr：独立的新一代命令行工具，围绕项目/数据源/元数据管理 + 任务自动化设计，支持脚本化查询、数据抽取与结构对比，更贴近 DevOps 场景。

简单说：只想跑 SQL 文件用 dbeaver-cli；要做可复用的数据库任务（连接、查询、导出、比对）、把它接进流水线，用 dbvr。

二、能用于哪些自动化场景

• 定时导出报表：把 SQL 结果导出为 CSV/JSON，配合 cron 或 Jenkins 定时执行。
• CI 中做数据库校验：迁移前后对比表结构、验证某些视图存在、检查行数阈值。
• 元数据检索：跨多张库/Schema 搜索某列名、某表被哪些视图引用，替代手写一堆 information_schema 查询。
• 多数据源统一操作：DBeaver 支持 MySQL、PostgreSQL、Oracle、SQL Server、SQLite、ClickHouse 及大量 JDBC 数据库，CLI 沿用同一套抽象。
• 批量执行 SQL 脚本：DDL 上线、初始化脚本、按环境切换执行。

三、基本使用流程

典型操作序列（以连接、执行、导出为例，具体参数以 --help 输出为准）：

# 1) 先看能力与子命令
dbvr --help
2) 列出已配置的数据源（沿用 DBeaver 工作空间配置）
dbvr datasource list
3) 对指定数据源执行 SQL 并输出结果
dbvr execute --datasource mydb --sql “select id,name from users limit 10”
4) 执行脚本文件并把结果导出为 CSV
dbvr execute --datasource mydb --file ./report.sql --format csv --output ./report.csv

dbeaver-cli 侧常见用法：

dbeaver-cli -runScript mydb -f D:\sql\init.sql -outD:\out\ -forceRun

说明：dbvr 与 dbeaver-cli 的参数会随版本调整，务必以本机 --help 为准；上面的写法用于理解命令结构（数据源 → 执行 → 输出格式 → 落地路径），而不是逐字照抄。

四、接入 CI 的注意事项

1. 凭据不写进仓库：数据源密码用环境变量、流水线密钥或 -data-manager 类外部凭据管理，绝不要把连接配置连同密码提交到 Git。
2. 用只读账号做校验：CI 里跑结构对比与行数检查时用 SELECT 权限账号；DDL 上线单独用受控的高权限流程。
3. 大结果集要限制：CLI 输出会占用内存与磁盘，导出前加 limit、分页或 --format 流式输出。
4. SQL 注入面：脚本中拼接变量时坚持用参数绑定；不要执行来源不明的 .sql 文件。
5. 失败要可见：命令返回非 0 时让流水线红掉，避免“静默失败导致生产数据未更新”。

五、什么时候用原生 CLI 更合适

单一数据库、纯脚本迁移场景，用厂商自带工具更轻量可控：mysql/mysqldump、psql/pg_dump、sqlcmd 等。dbvr 的优势在多数据源统一抽象与元数据操作；如果你的项目只连一种库，原生 CLI + 脚本可能更直接。

六、常见问题 FAQ

问：Community 版能免费用 CLI 吗？
答：DBeaver Community 开源免费，CLI 能力可用；部分企业特性在 PRO/企业版，具体以官方页面版本对比为准。

问：装好后找不到命令？
答：确认安装目录已加入 PATH，并在同一工作空间下已配置数据源；Windows 上可用绝对路径调用。

问：能连国产数据库（达梦、人大金仓、OceanBase 等）吗？
答：只要有对应 JDBC 驱动即可自行添加数据源驱动，这是 DBeaver 在信创环境里常被使用的原因之一。

要点：dbvr 把 DBeaver 的元数据与 SQL 能力带到终端，适合定时导出、CI 校验、多库统一管理；跑纯 SQL 脚本可继续用 dbeaver-cli；接进流水线必须管住凭据、用只读账号做校验、限制大结果集，单库场景则原生 CLI 往往更轻。

• 数据库
• DBeaver
• CLI