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

您已安装 Metabase，但是

• 您正尝试将应用程序数据库从 H2 迁移到另一个数据库，但出现了问题，
• 您正尝试降级而不是升级，
• 尝试运行时，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 扩展名添加到您在命令行中指定的数据库路径，因此请确保传递给命令的数据库文件路径不包含 .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 Pro 或 Enterprise 版本，您可以使用序列化来快照您的应用程序数据库。当您希望在新 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 需要有权限为应用程序数据库创建本地文件。运行 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 迁移到更快的服务器（特别是具有更快磁盘的服务器）。