變更 Apache Iceberg 檢視表,即可逐步調整檢視表的結構定義和 SQL 定義,或設定及取消設定自訂檢視表屬性,而不會變更 Lakehouse 執行階段目錄中的檢視表身分。
不支援重新命名檢視表。如要重新命名檢視表,請以新名稱建立檢視表,然後刪除原始檢視表。檢視表的儲存位置在建立後也無法變更,如果更新時設定了其他位置,則會失敗並顯示 400 Bad Request 錯誤。
事前準備
-
如果尚未啟用 BigLake API,請先啟用。
啟用 API 所需的角色
如要啟用 API,您必須具備
serviceusage.services.enable權限。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。 - 使用 Apache Iceberg REST 目錄端點設定 Lakehouse 執行階段目錄。
- 查看 Iceberg 檢視表的限制。
- 建立檢視表。
必要的角色
如要取得修改檢視表所需的權限,請要求管理員在專案和 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 更新。如要瞭解端點路徑,請參閱「取代檢視表定義」。