將 Iceberg V1 資料表升級至 V2

如果您有現有的第 1 版 (V1) Apache Iceberg 表格，必須先使用查詢引擎升級，才能搭配 Apache Iceberg REST 目錄端點使用。詳情請參閱「變更資料表」。

事前準備

  1. 確認專案已啟用計費功能 Google Cloud 。

  2. 啟用 BigLake API。

    啟用 API 時所需的角色

    如要啟用 API，您需要具備服務使用情形管理員 IAM 角色 (roles/serviceusage.serviceUsageAdmin)，其中包含 serviceusage.services.enable 權限。瞭解如何授予角色。

    啟用 API

  3. 使用 Apache Iceberg REST 目錄端點設定 Lakehouse 執行階段目錄。

必要的角色

如要取得升級資料表所需的權限，請要求管理員在專案和儲存空間 bucket 中授予您下列 IAM 角色：

  • 在憑證販售模式中升級資料表： BigLake 編輯器 (roles/biglake.editor) - 專案
  • 在非憑證臨時配發模式下升級資料表：
    • BigLake 編輯者 (roles/biglake.editor) - 專案
    • Storage 物件使用者 (roles/storage.objectUser) - Cloud Storage 值區

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

升級資料表

如要將 Iceberg V1 表格升級至 V2，請在查詢引擎中執行下列指令：

Spark 

ALTER TABLE CATALOG_NAME.SCHEMA_NAME.TABLE_NAME SET TBLPROPERTIES ('format-version'='2');

更改下列內容：

  • CATALOG_NAME：目錄名稱。
  • SCHEMA_NAME：結構定義名稱。
  • TABLE_NAME：資料表名稱。

後續步驟