Metabase JAR 命令全解析内建运维命令的管理、迁移、序列化与加密实战指南【免费下载链接】metabaseThe easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:项目地址: https://gitcode.com/GitHub_Trending/me/metabaseMetabase 的发行 JAR 包内置了一套可在服务器端直接运行的命令行工具用于实例管理、数据库迁移、H2 数据搬迁、序列化导出/导入、加密密钥轮换与文档生成等运维任务。本文基于当前仓库的 commands.md 文档结合 src/metabase/cmd/core.clj 的命令分发实现与各命令源码逐条讲解每个命令的用法、参数含义与底层行为帮助你完成从跑得起来到管得规范的运维闭环。说明本文讲解的是随 Metabase JAR 分发的服务端命令在服务器上、针对 Metabase 自身运行如果你要找的是通过 API 驱动 Metabase 实例的mb命令行客户端可单独使用或配合 AI Agent请参阅 Metabase CLI。命令机制与入口所有 JAR 内建命令都定义在metabase.cmd.core命名空间中并以^:command元数据标记。命令分发逻辑位于 src/metabase/cmd/core.clj 的run-cmd函数它先校验命令名与参数个数不合法会打印用法并报错再解析:arg-spec中声明的选项最后调用对应的命令函数。help命令本身也是这一机制的一部分——它读取每个命令函数的 docstring 和 arglist 来动态生成说明文本因此文档与实现永不脱节。调用方式有两种效果等价# 通过 Clojure CLI 运行开发/源码方式 clojure -M:run command options # 通过 Metabase JAR 运行生产/发行方式 java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar command options查看全部可用命令java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar helpMetabase 会按字母序列出所有命令、参数签名与选项说明。查看单个命令的用法java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar help command-name注意命令入口使用了--add-opens java.base/java.nioALL-UNNAMEDJVM 参数这是 Metabase 运行所必需的模块开放开关建议在启动脚本中固定保留。迁移类命令数据库升级与 H2 搬迁migrate direction运行数据库迁移。direction的合法取值为up、force、down、down-force、print、release-locksjava --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar migrate up从实现看src/metabase/cmd/migrate.clj该命令会直接调用应用数据库核心的mdb/migrate!传入方向关键字实际执行的是 app_db 迁移体系 中的迁移逻辑。当升级版本后应用数据库需要结构变更时可先执行migrate print查看将执行的 SQL 迁移计划再用up正式执行release-locks用于清理迁移过程中残留的锁例如多实例并发迁移导致锁未释放的场景。更详细的升级流程可参考 upgrading-metabase.md。dump-to-h2 h2-filename opts将现有应用数据库MySQL/Postgres 等的数据完整搬迁到新建的 H2 文件中常用于实例迁移前的数据打包java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar dump-to-h2 /path/to/metabase_dump.h2选项-k, --keep-existing若目标 H2 文件已存在则不删除默认会先删除。-p, --dump-plaintext不对转储内容加密。从源码 src/metabase/cmd/dump_to_h2.clj 可以确认几个关键行为h2-filename缺省时默认写为metabase_dump.h2除非指定--keep-existing否则会先通过copy.h2/delete-existing-h2-database-files!删除已存在的 H2 数据库文件数据拷贝由 src/metabase/cmd/copy.clj 的copy!完成源为mdb/data-source目标为 H2指定--dump-plaintext时会在转储后的 H2 上执行一次空密钥轮换即解密使产物为明文结束后执行CHECKPOINT SYNC强制 H2 落盘保证文件一致性。load-from-h2 | load-from-h2 h2-connection-string把已有 H2 数据库的数据迁移到新建的 MySQL 或 Postgres 数据库数据库连接由环境变量指定是从 H2 升级到正式数据库的标准路径# Postgres 示例 MB_DB_TYPEpostgres MB_DB_HOSTlocalhost MB_DB_PORT5432 MB_DB_USERuser MB_DB_DBNAMEmetabase \ java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar load-from-h2 # MySQL 示例 MB_DB_TYPEmysql MB_DB_HOSTlocalhost MB_DB_PORT3306 MB_DB_USERroot MB_DB_DBNAMEmetabase \ java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar load-from-h2不带参数时默认读取MB_DB_FILE即配置的应用数据库 H2 文件作为源。源码 src/metabase/cmd/load_from_h2.clj 揭示了三点细节连接串会自动追加;IFEXISTSTRUE避免源文件不存在时报错拷贝完成后会校验加密状态若源数据加密而MB_ENCRYPTION_SECRET_KEY未设置或密钥不符:invalid直接抛出异常中止若源为明文而当前配置了加密密钥:absent key 已设置会自动对目标库执行加密完成后调用search/reset-tracking!重置搜索索引追踪状态确保新库的搜索可用。完整的 H2 迁移指南见 migrating-from-h2.md。序列化命令实例的导出与导入export path options将整个 Metabase 实例序列化导出到path目录java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar export /path/to/export选项-c, --collection ID仅导出指定 ID 的内容多个 ID 用逗号分隔可传主键PK或以eid:开头的实体 ID。源码中该选项的解析逻辑src/metabase/cmd/core.clj会智能区分以eid:开头、长度为 21 的视为实体 ID否则按数字主键解析-C, --no-collections不导出集合内的任何内容-S, --no-settings不导出settings.yaml-D, --no-data-model不导出任何数据模型实体适合用于后续增量导出-f, --include-field-values连同字段元数据一起导出字段值-e, --continue-on-error出错时不中断执行--full-stacktrace出错时输出完整堆栈。import path options从path目录加载由export命令产生的序列化数据java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar import /path/to/export选项-e, --continue-on-error出错时不中断执行--full-stacktrace出错时输出完整堆栈。从源码结构看export与import命令都带有^:requires-init元数据意味着执行前会先完成应用数据库初始化二者最终委托给企业版Enterprise Edition的序列化实现metabase-enterprise.serialization.cmd的v2-dump!/v2-load!。也就是说这两个命令的完整能力属于 EE 版本社区版运行时会收到仅企业版可用的提示。序列化格式与使用细节可参考 serialization.md备份场景见 backing-up-metabase-application-data.md。加密相关命令密钥管理全流程Metabase 支持对应用数据库中的敏感数据如数据库连接密码进行透明加密密钥由环境变量MB_ENCRYPTION_SECRET_KEY提供。下面四个命令构成了密钥的完整生命周期管理。enable-encryption使用MB_ENCRYPTION_SECRET_KEY环境变量中的密钥对应用数据库中的存量明文数据执行加密。此命令是把存量明文行变成密文的唯一官方路径——正如 src/metabase/cmd/enable_encryption.clj 源码注释所述Metabase 启动时会拒绝已设置密钥但数据库尚未用该密钥加密的状态以确保存量数据只会在管理员显式执行本命令时被加密。MB_ENCRYPTION_SECRET_KEYyour-key \ java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar enable-encryption执行要点必须先在环境变量中设置密钥否则命令直接报错退出源码中default-encryption-enabled?检查需在 Metabase 停止状态下运行一次若数据库已经用该密钥加密状态为:valid命令会提示无需处理直接返回若存在:invalid哨兵密钥不匹配encrypt-db会在触碰任何行之前中止保证数据安全。remove-encryption解密应用数据库中的数据。执行前MB_ENCRYPTION_SECRET_KEY必须设置为当前密钥MB_ENCRYPTION_SECRET_KEYcurrent-key \ java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar remove-encryption源码 src/metabase/cmd/remove_encryption.clj 直接调用mdb/decrypt-db完成解密。rotate-encryption-key new-key轮换应用数据库的加密密钥MB_ENCRYPTION_SECRET_KEY设置为当前密钥new-key为新密钥且长度必须至少 16 个字符MB_ENCRYPTION_SECRET_KEYcurrent-key \ java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar rotate-encryption-key new-key从 src/metabase/cmd/rotate_encryption_key.clj 的实现看命令本质是先解密再使用新密钥重新加密当new-key为空字符串时它等价于执行解密这一点也被dump-to-h2 --dump-plaintext复用。核心逻辑位于 app_db 加密体系如encrypt-db/decrypt-db包括加密状态哨兵的写入与校验。密钥管理与加解密细节可进一步参考 encrypting-details-at-rest.md。文档生成命令让文档与实现同步Metabase 仓库中的多份核心文档本身就是由命令自动生成的保证了文档即代码。这类命令通常在开发流程中运行。命令作用输出位置ai-providers-documentation生成 Markdown列出 Metabase 可连接的 AI 提供商、各自所需的凭据以及提供的模型docs/ai/providers.mdapi-documentation生成 Scalar 格式的 Metabase API 文档HTML 文件 JSON 文件command-documentation生成所有 CLI 命令的 Markdown 文档docs/installation-and-operation/commands.mdconfig-template生成带说明的示例配置YAML包含 Metabase 设置项及默认值docs/configuring-metabase/config-template.mdenvironment-variables-documentation生成与配置 Metabase 相关的环境变量文档仅收录通过 defsettings 注册的环境变量Markdown 文件command-documentation的实现值得注意从 src/metabase/cmd/command_dox.clj 可以看到它通过扫描metabase.cmd.core中所有带^:command元数据的函数读取每个命令的 docstring、arglist 与:arg-spec再套用 Markdown 模板拼装——你正在阅读的这份 commands.md 就是该命令的产物。这也解释了为什么文档中的命令与 JAR 中实际可用命令始终保持一致。生成的环境变量文档基于设置注册体系defsettings完整的环境变量清单还可以参考 environment-variables.mdconfig-template生成的示例配置见 config-template.md其配套说明在 config-file.md。其他运维命令driver-methods | driver-methods _docs打印某个数据库驱动driver可以实现的所有 multimethod多方法列表加_docs参数时附带各方法的 docstring。对驱动开发与排查驱动能力未实现问题非常有用java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar driver-methods java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar driver-methods _docs源码 src/metabase/cmd/driver_methods.clj 负责收集并打印可用 multimethod驱动开发文档见 drivers 指南。reset-password email-address重置指定邮箱用户的密码java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar reset-password userexample.com从 src/metabase/cmd/reset_password.clj 的实现看该命令并非直接设置新密码而是为对应用户生成一个密码重置令牌并打印到标准输出格式为OK [[[token]]]。需要注意的行为邮箱不存在时输出FAIL [[[No user found with email address ...]]]已停用deactivated用户的密码无法重置需先重新激活账号。version打印 Metabase 版本号及当前系统信息包括操作系统、Java 虚拟机与版本、国家、系统时区、语言与文件编码java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar version该命令的实现直接读取配置中的版本信息与 JVM 系统属性src/metabase/cmd/core.clj是收集诊断信息的第一步完整诊断流程见 diagnostic-info.md。generate-openapi-spec从 Malli schema 定义生成 OpenAPI 规范文件输出到resources/openapi/openapi.json。API 定义分散在 api-routes 等模块中该命令确保 OpenAPI 描述与真实 API 契约一致。补充命令H2 SQL Shell当应用数据库是 H2 文件时可以用 H2 自带的 Shell 工具直接打开 SQL 交互界面这也是help输出末尾推荐的实用命令java -cp metabase.jar org.h2.tools.Shell -url jdbc:h2:/path/to/metabase.db注意这里用的是-cpclasspath而不是-jar因为需要直接调用 JAR 内的org.h2.tools.Shell类。适合在排查数据问题时快速查询应用数据库内容如用户表、设置表只读查询更安全。实战建议与常见场景把上述命令组合起来可以覆盖 Metabase 运维的几类典型场景从 H2 升级到 Postgres/MySQL先停止实例备份 H2 文件再按 migrating-from-h2.md 设置MB_DB_TYPE等环境变量后运行load-from-h2。为存量实例开启加密设置MB_ENCRYPTION_SECRET_KEY后运行enable-encryption务必在停止状态下执行一次日常轮换密钥用rotate-encryption-key。实例迁移/备份使用export导出目录企业版或使用dump-to-h2生成 H2 快照文件后带走目标环境再用import或load-from-h2恢复。忘记管理员密码用reset-password email生成重置令牌完成密码重置。升级版本先migrate print预览迁移 SQL再migrate up执行配合 upgrading-metabase.md 完成版本升级。所有命令的共同前提运行环境需具备 JavaMetabase 要求对应版本的 JDK见 installing-metabase.md且命令应在 Metabase 进程停止时执行尤其涉及迁移与加密的命令以避免数据竞争。命令执行失败的常见原因包括环境变量缺失、密钥不匹配:invalid哨兵、H2 文件路径错误等可结合 troubleshooting-guide 中的相关章节排查。【免费下载链接】metabaseThe easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:项目地址: https://gitcode.com/GitHub_Trending/me/metabase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Metabase JAR 命令全解析：内建运维命令的管理、迁移、序列化与加密实战指南
Metabase JAR 命令全解析内建运维命令的管理、迁移、序列化与加密实战指南【免费下载链接】metabaseThe easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:项目地址: https://gitcode.com/GitHub_Trending/me/metabaseMetabase 的发行 JAR 包内置了一套可在服务器端直接运行的命令行工具用于实例管理、数据库迁移、H2 数据搬迁、序列化导出/导入、加密密钥轮换与文档生成等运维任务。本文基于当前仓库的 commands.md 文档结合 src/metabase/cmd/core.clj 的命令分发实现与各命令源码逐条讲解每个命令的用法、参数含义与底层行为帮助你完成从跑得起来到管得规范的运维闭环。说明本文讲解的是随 Metabase JAR 分发的服务端命令在服务器上、针对 Metabase 自身运行如果你要找的是通过 API 驱动 Metabase 实例的mb命令行客户端可单独使用或配合 AI Agent请参阅 Metabase CLI。命令机制与入口所有 JAR 内建命令都定义在metabase.cmd.core命名空间中并以^:command元数据标记。命令分发逻辑位于 src/metabase/cmd/core.clj 的run-cmd函数它先校验命令名与参数个数不合法会打印用法并报错再解析:arg-spec中声明的选项最后调用对应的命令函数。help命令本身也是这一机制的一部分——它读取每个命令函数的 docstring 和 arglist 来动态生成说明文本因此文档与实现永不脱节。调用方式有两种效果等价# 通过 Clojure CLI 运行开发/源码方式 clojure -M:run command options # 通过 Metabase JAR 运行生产/发行方式 java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar command options查看全部可用命令java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar helpMetabase 会按字母序列出所有命令、参数签名与选项说明。查看单个命令的用法java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar help command-name注意命令入口使用了--add-opens java.base/java.nioALL-UNNAMEDJVM 参数这是 Metabase 运行所必需的模块开放开关建议在启动脚本中固定保留。迁移类命令数据库升级与 H2 搬迁migrate direction运行数据库迁移。direction的合法取值为up、force、down、down-force、print、release-locksjava --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar migrate up从实现看src/metabase/cmd/migrate.clj该命令会直接调用应用数据库核心的mdb/migrate!传入方向关键字实际执行的是 app_db 迁移体系 中的迁移逻辑。当升级版本后应用数据库需要结构变更时可先执行migrate print查看将执行的 SQL 迁移计划再用up正式执行release-locks用于清理迁移过程中残留的锁例如多实例并发迁移导致锁未释放的场景。更详细的升级流程可参考 upgrading-metabase.md。dump-to-h2 h2-filename opts将现有应用数据库MySQL/Postgres 等的数据完整搬迁到新建的 H2 文件中常用于实例迁移前的数据打包java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar dump-to-h2 /path/to/metabase_dump.h2选项-k, --keep-existing若目标 H2 文件已存在则不删除默认会先删除。-p, --dump-plaintext不对转储内容加密。从源码 src/metabase/cmd/dump_to_h2.clj 可以确认几个关键行为h2-filename缺省时默认写为metabase_dump.h2除非指定--keep-existing否则会先通过copy.h2/delete-existing-h2-database-files!删除已存在的 H2 数据库文件数据拷贝由 src/metabase/cmd/copy.clj 的copy!完成源为mdb/data-source目标为 H2指定--dump-plaintext时会在转储后的 H2 上执行一次空密钥轮换即解密使产物为明文结束后执行CHECKPOINT SYNC强制 H2 落盘保证文件一致性。load-from-h2 | load-from-h2 h2-connection-string把已有 H2 数据库的数据迁移到新建的 MySQL 或 Postgres 数据库数据库连接由环境变量指定是从 H2 升级到正式数据库的标准路径# Postgres 示例 MB_DB_TYPEpostgres MB_DB_HOSTlocalhost MB_DB_PORT5432 MB_DB_USERuser MB_DB_DBNAMEmetabase \ java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar load-from-h2 # MySQL 示例 MB_DB_TYPEmysql MB_DB_HOSTlocalhost MB_DB_PORT3306 MB_DB_USERroot MB_DB_DBNAMEmetabase \ java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar load-from-h2不带参数时默认读取MB_DB_FILE即配置的应用数据库 H2 文件作为源。源码 src/metabase/cmd/load_from_h2.clj 揭示了三点细节连接串会自动追加;IFEXISTSTRUE避免源文件不存在时报错拷贝完成后会校验加密状态若源数据加密而MB_ENCRYPTION_SECRET_KEY未设置或密钥不符:invalid直接抛出异常中止若源为明文而当前配置了加密密钥:absent key 已设置会自动对目标库执行加密完成后调用search/reset-tracking!重置搜索索引追踪状态确保新库的搜索可用。完整的 H2 迁移指南见 migrating-from-h2.md。序列化命令实例的导出与导入export path options将整个 Metabase 实例序列化导出到path目录java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar export /path/to/export选项-c, --collection ID仅导出指定 ID 的内容多个 ID 用逗号分隔可传主键PK或以eid:开头的实体 ID。源码中该选项的解析逻辑src/metabase/cmd/core.clj会智能区分以eid:开头、长度为 21 的视为实体 ID否则按数字主键解析-C, --no-collections不导出集合内的任何内容-S, --no-settings不导出settings.yaml-D, --no-data-model不导出任何数据模型实体适合用于后续增量导出-f, --include-field-values连同字段元数据一起导出字段值-e, --continue-on-error出错时不中断执行--full-stacktrace出错时输出完整堆栈。import path options从path目录加载由export命令产生的序列化数据java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar import /path/to/export选项-e, --continue-on-error出错时不中断执行--full-stacktrace出错时输出完整堆栈。从源码结构看export与import命令都带有^:requires-init元数据意味着执行前会先完成应用数据库初始化二者最终委托给企业版Enterprise Edition的序列化实现metabase-enterprise.serialization.cmd的v2-dump!/v2-load!。也就是说这两个命令的完整能力属于 EE 版本社区版运行时会收到仅企业版可用的提示。序列化格式与使用细节可参考 serialization.md备份场景见 backing-up-metabase-application-data.md。加密相关命令密钥管理全流程Metabase 支持对应用数据库中的敏感数据如数据库连接密码进行透明加密密钥由环境变量MB_ENCRYPTION_SECRET_KEY提供。下面四个命令构成了密钥的完整生命周期管理。enable-encryption使用MB_ENCRYPTION_SECRET_KEY环境变量中的密钥对应用数据库中的存量明文数据执行加密。此命令是把存量明文行变成密文的唯一官方路径——正如 src/metabase/cmd/enable_encryption.clj 源码注释所述Metabase 启动时会拒绝已设置密钥但数据库尚未用该密钥加密的状态以确保存量数据只会在管理员显式执行本命令时被加密。MB_ENCRYPTION_SECRET_KEYyour-key \ java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar enable-encryption执行要点必须先在环境变量中设置密钥否则命令直接报错退出源码中default-encryption-enabled?检查需在 Metabase 停止状态下运行一次若数据库已经用该密钥加密状态为:valid命令会提示无需处理直接返回若存在:invalid哨兵密钥不匹配encrypt-db会在触碰任何行之前中止保证数据安全。remove-encryption解密应用数据库中的数据。执行前MB_ENCRYPTION_SECRET_KEY必须设置为当前密钥MB_ENCRYPTION_SECRET_KEYcurrent-key \ java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar remove-encryption源码 src/metabase/cmd/remove_encryption.clj 直接调用mdb/decrypt-db完成解密。rotate-encryption-key new-key轮换应用数据库的加密密钥MB_ENCRYPTION_SECRET_KEY设置为当前密钥new-key为新密钥且长度必须至少 16 个字符MB_ENCRYPTION_SECRET_KEYcurrent-key \ java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar rotate-encryption-key new-key从 src/metabase/cmd/rotate_encryption_key.clj 的实现看命令本质是先解密再使用新密钥重新加密当new-key为空字符串时它等价于执行解密这一点也被dump-to-h2 --dump-plaintext复用。核心逻辑位于 app_db 加密体系如encrypt-db/decrypt-db包括加密状态哨兵的写入与校验。密钥管理与加解密细节可进一步参考 encrypting-details-at-rest.md。文档生成命令让文档与实现同步Metabase 仓库中的多份核心文档本身就是由命令自动生成的保证了文档即代码。这类命令通常在开发流程中运行。命令作用输出位置ai-providers-documentation生成 Markdown列出 Metabase 可连接的 AI 提供商、各自所需的凭据以及提供的模型docs/ai/providers.mdapi-documentation生成 Scalar 格式的 Metabase API 文档HTML 文件 JSON 文件command-documentation生成所有 CLI 命令的 Markdown 文档docs/installation-and-operation/commands.mdconfig-template生成带说明的示例配置YAML包含 Metabase 设置项及默认值docs/configuring-metabase/config-template.mdenvironment-variables-documentation生成与配置 Metabase 相关的环境变量文档仅收录通过 defsettings 注册的环境变量Markdown 文件command-documentation的实现值得注意从 src/metabase/cmd/command_dox.clj 可以看到它通过扫描metabase.cmd.core中所有带^:command元数据的函数读取每个命令的 docstring、arglist 与:arg-spec再套用 Markdown 模板拼装——你正在阅读的这份 commands.md 就是该命令的产物。这也解释了为什么文档中的命令与 JAR 中实际可用命令始终保持一致。生成的环境变量文档基于设置注册体系defsettings完整的环境变量清单还可以参考 environment-variables.mdconfig-template生成的示例配置见 config-template.md其配套说明在 config-file.md。其他运维命令driver-methods | driver-methods _docs打印某个数据库驱动driver可以实现的所有 multimethod多方法列表加_docs参数时附带各方法的 docstring。对驱动开发与排查驱动能力未实现问题非常有用java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar driver-methods java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar driver-methods _docs源码 src/metabase/cmd/driver_methods.clj 负责收集并打印可用 multimethod驱动开发文档见 drivers 指南。reset-password email-address重置指定邮箱用户的密码java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar reset-password userexample.com从 src/metabase/cmd/reset_password.clj 的实现看该命令并非直接设置新密码而是为对应用户生成一个密码重置令牌并打印到标准输出格式为OK [[[token]]]。需要注意的行为邮箱不存在时输出FAIL [[[No user found with email address ...]]]已停用deactivated用户的密码无法重置需先重新激活账号。version打印 Metabase 版本号及当前系统信息包括操作系统、Java 虚拟机与版本、国家、系统时区、语言与文件编码java --add-opens java.base/java.nioALL-UNNAMED -jar metabase.jar version该命令的实现直接读取配置中的版本信息与 JVM 系统属性src/metabase/cmd/core.clj是收集诊断信息的第一步完整诊断流程见 diagnostic-info.md。generate-openapi-spec从 Malli schema 定义生成 OpenAPI 规范文件输出到resources/openapi/openapi.json。API 定义分散在 api-routes 等模块中该命令确保 OpenAPI 描述与真实 API 契约一致。补充命令H2 SQL Shell当应用数据库是 H2 文件时可以用 H2 自带的 Shell 工具直接打开 SQL 交互界面这也是help输出末尾推荐的实用命令java -cp metabase.jar org.h2.tools.Shell -url jdbc:h2:/path/to/metabase.db注意这里用的是-cpclasspath而不是-jar因为需要直接调用 JAR 内的org.h2.tools.Shell类。适合在排查数据问题时快速查询应用数据库内容如用户表、设置表只读查询更安全。实战建议与常见场景把上述命令组合起来可以覆盖 Metabase 运维的几类典型场景从 H2 升级到 Postgres/MySQL先停止实例备份 H2 文件再按 migrating-from-h2.md 设置MB_DB_TYPE等环境变量后运行load-from-h2。为存量实例开启加密设置MB_ENCRYPTION_SECRET_KEY后运行enable-encryption务必在停止状态下执行一次日常轮换密钥用rotate-encryption-key。实例迁移/备份使用export导出目录企业版或使用dump-to-h2生成 H2 快照文件后带走目标环境再用import或load-from-h2恢复。忘记管理员密码用reset-password email生成重置令牌完成密码重置。升级版本先migrate print预览迁移 SQL再migrate up执行配合 upgrading-metabase.md 完成版本升级。所有命令的共同前提运行环境需具备 JavaMetabase 要求对应版本的 JDK见 installing-metabase.md且命令应在 Metabase 进程停止时执行尤其涉及迁移与加密的命令以避免数据竞争。命令执行失败的常见原因包括环境变量缺失、密钥不匹配:invalid哨兵、H2 文件路径错误等可结合 troubleshooting-guide 中的相关章节排查。【免费下载链接】metabaseThe easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:项目地址: https://gitcode.com/GitHub_Trending/me/metabase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考