疑難排解 Apache Iceberg 檢視表問題

在 Lakehouse 執行階段目錄中建立、查詢、變更或刪除 Apache Iceberg 檢視表時,可能會遇到錯誤,例如與資料表名稱衝突、存取遭拒、檢視表時間旅行、快照過期、不支援的目錄類型,或檢視表位置不可變更。本文可協助您找出這些常見錯誤的原因並加以解決。如需一般目錄問題,請參閱「疑難排解」。

建立或取代檢視表或資料表時,使用 409 Conflict 或 AlreadyExistsException

資料表和檢視表在目錄命名空間中,共用相同的 ID 命名空間,且目錄會禁止跨類型覆寫。您無法建立與現有資料表同名的檢視表,也無法建立與現有檢視表同名的資料表。

如要找出名稱衝突,請列出命名空間中的資料表和檢視表:

SHOW TABLES IN NAMESPACE_NAME;
SHOW VIEWS IN NAMESPACE_NAME;

請選擇其他名稱,或先捨棄衝突的物件。

403 Forbidden 或 AccessDeniedException (檢視作業)

由於 Compute Engine 會在用戶端評估檢視表,因此查詢檢視表時,必須具備檢視表和檢視表參照的每個資料表的權限。請確認下列事項:

  • 如為檢視表 DDL,呼叫端須具備 BigLake 編輯者 (roles/biglake.editor) 或 BigLake 管理員 (roles/biglake.admin) 角色。
  • 對於 SELECT 查詢,呼叫端具有 BigLake 檢視者 (roles/biglake.viewer),可授予檢視表的 biglake.views.get,以及參照資料表的 biglake.tables.get 和 biglake.tables.getData。
  • 在使用者憑證模式中,呼叫端必須具備 Cloud Storage bucket 的 Storage 物件使用者 (roles/storage.objectUser) 角色,才能查看 DDL,或具備 Storage 物件檢視者 (roles/storage.objectViewer) 角色,才能執行唯讀查詢。
  • 在憑證販售模式中,目錄的服務帳戶在 Cloud Storage bucket 具有 Storage 物件使用者 (roles/storage.objectUser) 角色,且 Spark 已設定 spark.sql.catalog.CATALOG_NAME.header.X-Iceberg-Access-Delegation=vended-credentials。

詳情請參閱「必要的角色和權限」。

UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW

如果查詢直接將 TIMESTAMP AS OF 或 VERSION AS OF 套用至檢視表 ID,Spark 會傳回 AnalysisException: [UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW] Cannot time travel on view。

從查詢中移除時間旅行子句。如需歷來資料,請定義檢視表,並將其 SQL 定義套用至基礎資料表 TIMESTAMP AS OF,或使用 CTE 直接查詢基礎資料表。詳情請參閱「建立檢視表,並對基礎資料表使用時間旅行功能」。

ValidationException: Cannot find snapshot older than timestamp

使用時間旅行子句定義的檢視表,參照了已過期或已從基礎資料表移除的快照。

請使用較新的時間戳記或快照 ID,將檢視表替換為 CREATE OR REPLACE VIEW,或調整基礎 Iceberg 資料表的快照保留設定。

捨棄命名空間時發生 409 Conflict: Namespace is not empty

您無法捨棄仍含有檢視表的命名空間。列出並捨棄所有剩餘的檢視表,然後捨棄命名空間:

SHOW VIEWS IN NAMESPACE_NAME;
DROP VIEW IF EXISTS NAMESPACE_NAME.VIEW_NAME;

400 Bad Request 搭配 FAILED_PRECONDITION 執行檢視作業

Iceberg 檢視表僅支援多值區目錄和單一值區目錄。目錄會拒絕 BigQuery 目錄或聯合目錄的檢視作業。在支援的目錄類型中建立檢視表。

400 Bad Request: View location is immutable

檢視表建立後,即無法變更儲存位置。從要求中移除位置更新通知。

在 Trino 481 以下版本中,CREATE OR REPLACE VIEW 會傳送位置更新通知,觸發這項錯誤。請升級至 Trino 482 以上版本,或依序執行 DROP VIEW 和 CREATE VIEW,更新檢視表定義。詳情請參閱「Trino 支援」。

後續步驟