排解常見的 Lakehouse for Apache Iceberg 問題

本頁說明如何解決 Lakehouse for Apache Iceberg 和相關資源的常見問題。

無法查詢中繼資料表

使用五部分名稱 ID，在 BigQuery 中查詢 Lakehouse 執行階段目錄支援的 Apache Iceberg 資料表時，如果查詢中繼資料表 (例如 .snapshots 或 .files)，就會發生這個問題。

如要解決這個問題，請使用 Apache Spark 查詢這些資料表。

metadata.json 檔案大小限制

Apache Iceberg metadata.json 檔案大小上限為 1 MB。這項限制適用於追蹤資料表快照、結構定義和分割規格的中繼資料檔案。如果中繼資料檔案超過這個大小，透過 Apache Iceberg REST 目錄端點執行資料表作業時，可能會發生錯誤。

如要解決這個問題，請與 Google 帳戶團隊聯絡，要求調高上限。

查詢多區域目錄時發生 NOT_FOUND 錯誤

如果您使用多區域 Cloud Storage 值區在Lakehouse 執行階段目錄中建立目錄，但未指定主要位置，然後嘗試透過指定 BigQuery 虛擬區域 (例如 US 或 EU) 查詢目錄，就會發生這個問題。

使用多地區值區建立目錄時，目錄的中繼資料會儲存在多地區地理範圍內的特定地區位置，而不是對應的 BigQuery 虛擬地區。如果您強制查詢在沒有中繼資料的虛擬區域中執行，查詢會失敗並顯示 NOT_FOUND 錯誤。

如要解決這個問題，請在建立目錄時指定主要位置 (例如 US 或 EU)。詳情請參閱「指定美國和歐盟多區域的主要區域」。

注意： 如果您已使用多區域值區建立目錄，並想搭配 BigQuery 多區域 (US 或 EU) 使用，則必須刪除並重新建立目錄，才能指定主要位置。