从 Metabase 云迁移到自托管 Metabase

本指南概述了从 Metabase 云迁移到自托管 Metabase 的过程。如果您想迁移到 Metabase 云，请查看本指南。

从 Metabase 云迁移到自托管将保留您所有的提问、仪表盘、人员、设置 — 以及您现有 Metabase 中的所有内容。

要迁移，您需要联系我们的成功团队，以获取您的 Metabase 的应用程序数据库的快照。此应用程序数据库包含有关您的 Metabase 云实例的所有设置、提问、仪表盘、模型、用户等信息。应用程序数据库与您连接到 Metabase 的任何数据库都不同。您需要托管您自己的 PostgreSQL 数据库，并通过从应用程序数据库的此快照还原来导入您的数据。

准备从云迁移到自托管

自托管 Metabase 版本应与云版本匹配

您的自托管 Metabase 的主要版本应与您的 Metabase 云实例的版本匹配。例如，如果您的 Metabase 云实例的版本为 52，则您的自托管实例也应为版本 52。

您可以通过点击 Metabase 右上角的齿轮图标，然后点击关于 Metabase来找到您的 Metabase 版本。对于 Metabase 云，您还可以在 Metabase 商店中查看您的实例版本。

使用 PostgreSQL 作为您的应用程序数据库

自托管 Metabase 附带一个内置的 H2 应用程序数据库（H2 是一种基于文件的数据库格式）。H2 数据库适用于演示和试用，但您应避免在生产环境中使用内置的 H2 应用程序数据库！

我们建议使用 PostgreSQL 作为您的应用程序数据库，但您也可以使用 MySQL 或 MariaDB。在开始从 Metabase 云迁移之前，为您的自托管实例配置应用程序数据库。

有关为什么您应该使用 PostgreSQL 作为应用程序数据库的更多信息，请查看如何在生产环境中运行 Metabase。

如果您使用的是 Pro 计划，则需要切换到自托管 Pro 计划

如果您要从 Metabase 云 Pro 计划迁移到自托管 Pro 计划，则需要取消您的 Metabase 云 Pro 计划，并在Metabase 商店中启动新的 Pro 自托管计划。切换是必要的，因为

• 云计划和自托管计划之间的条款和条件不同。
• 自托管时，您需要许可证令牌来激活您的 Pro 功能。

如何从 Metabase 云迁移到自托管实例

1. 通过联系我们的成功工程团队，请求您的 Metabase 云实例的应用程序数据库的快照。

   目前，您无法自行生成快照。Metabase 成功工程师将为您生成快照，并通过电子邮件发送链接，以便您从 Metabase 商店下载您的快照。

2. 从 Metabase 商店下载快照。来自 Metabase 成功工程团队的电子邮件将包含指向您下载的链接。您需要登录 Metabase 商店才能访问下载。

   您的 Metabase 云应用程序数据库的快照将是一个 H2 文件数据库：一个扩展名为 .mv.db 的文件。（Metabase 云实例使用 PostgresSQL 作为应用程序数据库，但快照以 H2 格式保存，以便您可以还原到 PostgresSQL 或 MysQL 应用程序数据库）。

   快照很快过期，但不用担心；如果您的快照已过期，只需请求一个新的即可。

3. 将您的应用程序数据导入到您的自托管应用程序数据库中。按照从 H2 迁移到生产应用程序数据库的说明，使用您下载的 .mv.db 快照。

   迁移将涉及运行 CLI 命令，以将数据从您下载的 H2 快照加载到您的自托管应用程序数据库中。

   如果您遇到任何问题，请查看故障排除指南或联系我们。

4. Pro 计划将需要输入许可证令牌才能激活付费功能。如果您要迁移到 Pro 自托管计划，请激活您的企业版令牌。

   如果您使用的是 Pro 云计划，则需要取消该计划并启动新的自托管 Pro 计划，以获取激活付费功能所需的令牌。请参阅准备从云迁移到自托管。