升级 Metabase 和嵌入式分析 SDK

以下是升级 SDK 时需要执行的步骤的基本概述。

1. 阅读 Metabase 和嵌入式分析 SDK 的发布帖子和变更日志

• 发布帖子提供了每个版本内容的良好概述，并指出了重大更改（这很少见）。
• Metabase 变更日志列出了 Metabase 的更改。
• 嵌入式分析 SDK 变更日志列出了 SDK 包特有的更改。

检查任何相关的更改，特别是需要更新应用程序代码的重大更改。如果存在重大更改，我们将提供文档，指导您完成需要进行的更改以及原因。

2. 测试升级

升级到新的主要版本时，您需要并行升级 Metabase 和 SDK 版本，因为 Metabase 和 SDK 主要版本不同步可能会导致错误。

启动新版本的 Metabase 进行测试

您可以在本地或开发实例中执行此操作。如果您的测试设置涉及大量测试用户帐户，获取开发实例可能更具成本效益。

请参阅升级 Metabase。

使用 npm 或 yarn 升级 SDK

您需要首先在本地测试这些更改，因为可能存在需要升级应用程序代码的重大更改。

在应用程序中检出新分支并安装下一个稳定版本，可以使用 npm 或 yarn

通过 npm

npm install @metabase/embedding-sdk-react@{next-major-version-number}-stable

例如，如果您要升级到 SDK 的版本 55

npm install @metabase/embedding-sdk-react@55-stable

如果您使用 yarn

yarn add @metabase/embedding-sdk-react@{next-major-version-number}-stable

有关SDK 版本的更多信息。

如果存在重大更改，请对您的应用程序代码进行必要的更改

重大更改很少见，但如果您确实需要进行更改，我们将在新主要版本的发布说明中提及，并提供指导您完成更改的文档。

更新或添加您所做的任何应用程序代码更改的测试。

部署到您的预演环境

在将应用程序部署到预演环境之前，请确保您已在本地测试了您的应用程序（手动以及运行任何自动化测试）。

如果您的本地测试一切顺利，请部署到您的预演环境。检查您的预演应用程序中的 Metabase 嵌入是否仍按预期工作，并执行您通常对嵌入式分析应用程序进行的任何其他测试。

3. 部署到生产环境

如果预演环境中的一切都正常工作，您就可以部署到生产环境了。

请务必并行部署您的应用程序更改并升级您的 Metabase，以便 SDK 版本和 Metabase 版本保持同步。

如果您的实例固定在 Metabase Cloud 上，您需要请求升级

如果您在 Metabase Cloud 上，并且您已固定了 Metabase 的版本，您需要通过联系支持请求升级。

我们将与您协调，以便在您部署应用程序更改时升级您的实例。