迁移到 Metabase 云 - Metabase 49 或更低版本

如果您运行的是 Metabase 50 或更高版本，请查看此指南。

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

请勿担心。您不会丢失任何工作，如果您遇到问题，我们随时为您提供帮助。

准备迁移

了解限制

Metabase 云有一些限制，可能会影响您的迁移。

确认您具有正确的访问权限

为了进行迁移，您需要对自托管 Metabase 环境具有 shell 访问权限，并且您的 Metabase 环境需要能够访问互联网。

安排一些停机时间

请务必告知您的用户，您的 Metabase 实例在迁移期间将不可用（最好在非工作时间）。迁移过程通常不到 15 分钟。

关闭您的自托管 Metabase 实例

您只需停止 Metabase JAR 进程或 Docker 容器，以确保您的 Metabase 已关闭。这样做的目的是防止人们创建更多问题或仪表板，这可能在迁移期间使您的实例处于不一致状态。

备份您的应用程序数据库。

万一出现问题，您需要一份备份。请参阅备份 Metabase 应用程序数据。

将您的 Metabase 迁移到 Metabase 云

这个过程本身大部分是自动化的，但它对您的实例来说是独一无二的。让我们来看看。

创建 Metabase 云实例

您需要一个 Metabase 云实例来迁移到。如果您还没有，请注册 Metabase 云的 14 天免费试用。

如果您已经有 Metabase 云实例，则可以跳过此步骤。

遵循迁移说明

访问您的 Metabase 商店帐户并点击发起迁移。

您将获得一个运行命令，该命令将下载一个脚本来管理您的迁移。Metabase JAR 有一个命令，如果您通过 Docker 运行 Metabase，则有另一个命令。

在执行迁移脚本之前，您可能需要设置环境变量以匹配您的应用程序数据库的常规配置

• Docker：环境变量将已设置。
• JAR：在运行 JAR 的服务器上运行MB_DB_CONNECTION_URI=xxxxx migration_script.sh来设置环境变量。
• Heroku：请按照运行脚本的额外步骤进行操作。

在您的自托管环境中执行脚本

警告：如果您在 Metabase 云实例中创建了任何问题或仪表板，它们将在您上传现有自托管 Metabase 实例的应用程序数据时被覆盖。

该脚本将您的应用程序数据上传到您的新 Metabase 云实例。如果一切顺利，脚本将打印Done!。

如果出现任何问题，请按照脚本输出的任何提示进行操作。如果您仍然遇到问题，请给我们发送电子邮件，我们将帮助您解决问题。

迁移到 Metabase 云后

成功上传后，一些收尾工作和重启会在几分钟内自动完成，然后您就可以登录到您崭新的 Metabase 云实例了。您应该会看到所有的问题和仪表板，就像您在自托管实例中看到的一样。

• 如果您使用 Google 登录，您需要前往Google Developers Console，并将您的新 Metabase 云 URL 添加到 Google Auth 客户端 ID 的授权 JavaScript 来源中。
• 对于使用 SAML SSO 的专业版和企业版客户，您需要使用您的身份提供商更新您的设置，将重定向 URL 和基本 URL 更改为您的新 Metabase 云 URL，否则您的身份提供商仍会将用户重定向到您旧的（已关闭的）Metabase 实例。请参阅使用 SAML 进行身份验证。

告知您的团队新的 Metabase 地址

确认一切正常后，请告知所有成员新的 Metabase 云 URL 地址，他们应该使用该地址登录 Metabase。用户应该能够像往常一样登录，并从他们上次离开的地方继续工作。

如果您将 Metabase 嵌入到应用程序中，请务必更新您的代码以反映您的新 URL。

让您的旧 Metabase 退役

尽管您应该已经关闭了旧的 Metabase 实例，但如果您通过第三方自托管，请务必清理并取消任何服务，以避免不必要的费用（例如旧备份的存储费）。

就是这样！

我们将从现在开始负责您的 Metabase 并使其保持最新。欢迎来到 Metabase 云！

需要帮助？

如果您有任何问题，只需给我们发送电子邮件。