嵌入式分析 SDK - 版本

⚠️ 此功能尚在 Beta 測試階段。歡迎試用,但請注意,功能可能會變更 (且可能無法如預期般運作)。

嵌入式分析 SDK 僅適用於 ProEnterprise 方案 (包括自架和 Metabase Cloud)。但是,您可以在本機電腦上使用 SDK,無需授權,透過 API 金鑰驗證您的嵌入。

SDK 穩定版本與 Metabase 版本同步。

例如,如果您使用 Metabase 51 (0.51.x1.51.x),則任何版本 0.51.x 的 @metabase/embedding-sdk-react npm 套件都相容。

為了簡化操作,我們為每個穩定的 Metabase 版本發布 dist-tag,從 Metabase 51 開始,版本標籤為 51-stable。若要安裝與 Metabase 51 相容的最新 SDK 版本,請執行

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

若要取得適用於 Metabase 每夜建置版本的最新 SDK 版本,請使用 canary dist-tag。

將 SDK 與 Metabase Cloud 搭配使用時的版本固定

若要固定您的 Metabase 版本,請前往「管理設定」>「設定」>「嵌入」。前往「嵌入式分析 SDK」卡片,捲動至「版本固定」,然後按一下「請求版本固定」。

版本固定需求

若要固定 Metabase 版本,您必須

  • 使用 Metabase Cloud (顯而易見)
  • 使用 Pro 或 Enterprise 方案

為何您會想要固定 Metabase Cloud 版本

通常,Metabase Cloud 會在推出新版本時升級您的 Metabase,讓您無需處理升級。

但是,如果您將 SDK 與 Metabase Cloud 搭配使用,則會想要手動升級,以確保在您同時升級 Metabase 和 SDK 版本時,您的嵌入不會中斷。

若要手動升級,您可以固定您的 Metabase 版本,使其與您使用的 SDK 版本保持同步。您可以選擇何時升級您的 Metabase。