修改檢視表

變更 Apache Iceberg 檢視表,即可逐步調整檢視表的結構定義和 SQL 定義,或設定及取消設定自訂檢視表屬性,而不會變更 Lakehouse 執行階段目錄中的檢視表身分。

不支援重新命名檢視表。如要重新命名檢視表,請以新名稱建立檢視表,然後刪除原始檢視表。檢視表的儲存位置在建立後也無法變更,如果更新時設定了其他位置,則會失敗並顯示 400 Bad Request 錯誤。

事前準備

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

  2. 如果尚未啟用 BigLake API,請先啟用。

    啟用 API 所需的角色

    如要啟用 API,您必須具備 serviceusage.services.enable 權限。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

    啟用 API

  3. 使用 Apache Iceberg REST 目錄端點設定 Lakehouse 執行階段目錄。
  4. 查看 Iceberg 檢視表的限制。
  5. 建立檢視表。

必要的角色

如要取得修改檢視表所需的權限,請要求管理員在專案和 Storage bucket 授予您下列 IAM 角色:

  • 變更檢視表:BigLake 編輯者 (roles/biglake.editor) - 您的專案
  • 在使用者憑證模式中寫入檢視表中繼資料檔案:Storage 物件使用者 (roles/storage.objectUser) - Cloud Storage bucket

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

這些預先定義的角色具備修改檢視表所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

必須具備下列權限,才能修改檢視表:

  • 修改檢視表:
    • biglake.views.update 檢視畫面
    • biglake.tables.get 新檢視表定義參照的每個 Iceberg 資料表
  • 在使用者憑證模式下,將檢視表中繼資料檔案寫入 Cloud Storage bucket:storage.objects.create

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

如需查看權限的完整清單,請參閱「必要角色和權限」。

取代檢視表定義

取代現有檢視表的結構定義和 SQL 邏輯。取代檢視表時,目錄會寫入新的版本化 metadata.json 檔案 (例如 00001-UUID.metadata.json),將新的檢視表版本和結構定義附加至檢視表中繼資料,並保留檢視表的 view-uuid。

Spark

CREATE OR REPLACE VIEW my_ns.eng_employees (
  emp_id,
  emp_name,
  dept,
  salary,
  is_senior
)
COMMENT 'Updated Engineering view with seniority flag'
AS SELECT id, name, dept, salary, (salary >= 140000.0) AS is_senior
FROM my_ns.employees
WHERE dept = 'Engineering';

REST

如要使用 REST API 更新檢視表,請向 UpdateIcebergView 端點發出 POST 要求:

POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME

要求主體必須包含有效的 Iceberg CommitViewRequest JSON 酬載,以及要套用的 requirements 和 updates。目錄會驗證開放式並行需求,並將更新內容提交至新的 metadata.json 檔案。

更改下列內容:

  • PROJECT_ID:您的 Google Cloud專案 ID。
  • CATALOG_ID:目錄 ID。
  • NAMESPACE_NAME:目錄命名空間的名稱。
  • VIEW_NAME:檢視表名稱。

設定及取消設定檢視畫面屬性

設定或移除檢視表的自訂屬性,而不變更其定義。

Spark

設定屬性:

ALTER VIEW my_ns.eng_employees
SET TBLPROPERTIES ('tier' = 'gold', 'reviewed' = 'true');

取消設定屬性:

ALTER VIEW my_ns.eng_employees
UNSET TBLPROPERTIES IF EXISTS ('reviewed');

如要進一步瞭解目錄如何處理 write.metadata.compression-codec 等屬性,請參閱「查看屬性」。

REST

傳送 CommitViewRequest 至 UpdateIcebergView 端點,並附上 set-properties 或 remove-properties 更新。如要瞭解端點路徑,請參閱「取代檢視表定義」。

後續步驟