使用或迁移 H2 应用程序数据库

您已安装 Metabase，但

• 您正在尝试将应用程序数据库从 H2 迁移到另一个数据库，但出现问题，
• 您正在尝试降级而不是升级，
• 当您尝试运行 Metabase 时，Metabase 日志记录了 `liquibase` 错误消息，
• Metabase 在运行时记录了另一条提及 `H2` 或 `h2` 的错误消息，或者
• 您使用的是 Windows 10，并收到有关文件权限的警告。

您目前是否将 H2 用作应用程序数据库？

根本原因： Metabase 在其自己的数据库中存储有关用户、问题等的信息，称为“应用程序数据库”，简称“应用数据库”。默认情况下，Metabase 使用 H2 作为应用程序数据库，但我们不建议在生产环境中使用它——因为它是一个磁盘数据库，它对文件系统错误很敏感，例如驱动器损坏或文件未正确刷新。

采取的步骤

1. 要检查您将什么用作应用数据库，请转到 **管理员面板**，打开 **工具** 选项卡，向下滚动到“诊断信息”，然后在它显示的 JSON 中查找 `application-database` 键。
2. 请参阅 从 H2 迁移 以获取有关迁移到更健壮的应用数据库的说明。

您是否正在尝试将应用程序数据库从 H2 迁移到其他数据库？

根本原因： 您正在尝试使用 `load-from-h2` 命令将应用数据库从 H2 迁移到生产数据库（如 PostgreSQL 或 MySQL/MariaDB），但由于数据库文件名不正确而失败，并出现类似以下错误的提示：

Command failed with exception: Unsupported database file version or invalid file header in file <YOUR FILENAME>

采取的步骤

1. 创建导出的 H2 数据库的副本（请参阅 备份 Metabase 应用程序数据）。在完成此操作之前不要继续，以防出现问题。

2. 检查导出的 H2 数据库文件是否命名为 `metabase.db.mv.db`。

3. H2 会自动为命令行的数据库路径添加 `.mv.db` 扩展名，因此请确保传递给命令的 DB 文件路径不包含 `.mv.db` 扩展名。例如，如果您导出了应用程序数据库，并且想使用 `load-from-h2` 将数据从该 H2 数据库加载到 PostgreSQL 数据库中，您的命令将类似于：

   export MB_DB_TYPE=postgres
   export MB_DB_DBNAME=metabase
   export MB_DB_PORT=5432
   export MB_DB_USER=<username>
   export MB_DB_PASS=<password>
   export MB_DB_HOST=localhost
   java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar load-from-h2 /path/to/metabase.db # do not include .mv.db
   

如果您使用的是 Metabase 专业版或企业版，您可以使用 序列化 来快照您的应用程序数据库。当您想要在新 Metabase 实例中 预加载问题和仪表板 时，序列化非常有用。

您是否正在尝试降级？

根本原因： Metabase 不支持降级（即，回滚到应用程序的早期版本）。

采取的步骤

1. 关闭 Metabase。
2. 恢复您在尝试升级或降级之前制作的应用数据库的备份副本。
3. 恢复您想要回滚到的旧版本的 JAR 文件或容器。
4. 重新启动 Metabase。

应用数据库是否被锁定？

根本原因： 有时 Metabase 无法启动，因为在上次运行时应用数据库锁未能正确清除。错误消息看起来像这样：

liquibase.exception.DatabaseException: liquibase.exception.LockException: Could not acquire change log lock.

采取的步骤

1. 在安装 Metabase 的服务器上打开一个 shell，并通过运行以下命令手动清除锁：

   java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar migrate release-locks
   

2. 此命令完成后，请正常重新启动您的 Metabase 实例（不使用 `migrate release-locks` 标志）。

应用数据库是否已损坏？

根本原因： H2 不如生产级数据库管理系统可靠，有时数据库本身会损坏。这可能导致应用数据库中的数据丢失，但不会损坏 Metabase 连接的数据库中的数据。

采取步骤： 错误消息可能因应用数据库损坏的方式而异，但在大多数情况下，日志消息会提到 `h2`。典型的命令和消息是：

myUser@myIp:~$ java --add-opens java.base/java.nio=ALL-UNNAMED -cp metabase.jar org.h2.tools.RunScript -script whatever.sql -url jdbc:h2:~/metabase.db
Exception in thread "main" org.h2.jdbc.JdbcSQLException: Row not found when trying to delete from index """"".I37: ( /* key:7864 */ X'5256470012572027c82fc5d2bfb855264ab45f8fec4cf48b0620ccad281d2fe4', 165)" [90112-194]
    at org.h2.message.DbException.getJdbcSQLException(DbException.java:345)
    [etc]

如何修复： 并非所有 H2 错误都可以恢复（这就是为什么如果您使用 H2，请为应用程序数据库文件制定备份策略）。

如果您正在运行最新版本并使用 H2，则应用数据库存储在 `metabase.db.mv.db` 中。- 在 Metabase 实例运行的服务器上打开一个 shell，然后通过运行以下四个命令尝试恢复损坏的 H2 文件：

java -cp metabase.jar org.h2.tools.Recover

mv metabase.db.mv.db metabase-old.db.mv.db

touch metabase.db.mv.db

java --add-opens java.base/java.nio=ALL-UNNAMED -cp target/uberjar/metabase.jar org.h2.tools.RunScript -script metabase.db.h2.sql -url jdbc:h2:`pwd`/metabase.db

您是否在 Windows 10 上使用 H2 运行 Metabase？

根本原因： 在 Windows 10 的某些情况下，Metabase JAR 需要权限来为应用程序数据库创建本地文件。运行时，您将看到类似以下的错误消息：

Exception in thread "main" java.lang.AssertionError: Assert failed: Unable to connect to Metabase DB.

采取的步骤

1. 右键单击 Metabase JAR 文件（不是应用数据库文件）。
2. 选择“属性”。
3. 选择“取消阻止”。

应用数据库加载时间过长？

根本原因： 您将 H2 用作应用数据库，并且应用数据库非常大，无法在 5 秒内（这是默认超时值）加载。当您尝试启动 Metabase 时，您会在控制台中看到“Timeout”消息。

采取的步骤

1. 使用生产级数据库（如 PostgreSQL）作为应用数据库（首选）。
2. 转到 **管理员面板** 并增加应用数据库的超时设置。
3. 将 Metabase 移动到更快的服务器（尤其是具有更快磁盘的服务器）。