查詢 Apache Iceberg 檢視表時,系統會執行儲存在 Lakehouse 執行階段目錄中的 SQL 定義,從基礎 Iceberg 資料表讀取精選的零複製結果。您的 Compute Engine 會從目錄載入檢視表定義、解析每個參照的資料表和巢狀檢視表,然後讀取 Cloud Storage 中的資料檔案。
您只能透過與 Iceberg 相容的開放原始碼引擎 (例如 Spark 和 Trino) 查詢 Iceberg 檢視表。BigQuery 不支援查詢 Iceberg 檢視表。
事前準備
-
如果尚未啟用 BigLake API,請先啟用。
啟用 API 所需的角色
如要啟用 API,您必須具備
serviceusage.services.enable權限。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。 - 使用 Apache Iceberg REST 目錄端點設定 Lakehouse 執行階段目錄。
- 查看 Iceberg 檢視表的限制。
- 建立檢視表。
必要的角色
由於 Compute Engine 會在用戶端評估檢視表,因此您必須具備檢視表的權限,以及檢視表參照的每個資料表和巢狀檢視表的權限。
如要取得查詢檢視表所需的權限,請要求管理員在專案和 Storage bucket 中,授予您下列 IAM 角色:
-
在憑證販售模式中讀取檢視表和參照資料表:BigLake 檢視者 (
roles/biglake.viewer) - 您的專案 -
在使用者憑證模式中讀取檢視表和參照資料表:
- BigLake 檢視者 (
roles/biglake.viewer) - 您的專案 - Storage 物件檢視者 (
roles/storage.objectViewer) - Cloud Storage bucket
- BigLake 檢視者 (
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這些預先定義的角色具備查詢 view 所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
必須具備下列權限,才能查詢檢視表:
-
查詢檢視表:
-
檢視畫面和任何巢狀檢視畫面上的
biglake.views.get -
檢視表參照的每個 Iceberg 資料表上,都有
biglake.tables.get
-
檢視畫面和任何巢狀檢視畫面上的
-
在憑證販售模式中讀取資料表資料:
biglake.tables.getData在檢視表參照的每個 Iceberg 資料表上 -
在使用者憑證模式中讀取檢視表中繼資料和資料表資料:
storage.objects.getCloud Storage bucket
如需查看權限的完整清單,請參閱「必要角色和權限」。
查詢檢視表
選取檢視表中的所有資料:
Spark
SELECT * FROM NAMESPACE_NAME.VIEW_NAME;
更改下列內容:
NAMESPACE_NAME:命名空間的名稱。VIEW_NAME:檢視表名稱。
您可以用相同方式查詢包含彙整、匯總、CTE 和巢狀檢視表的檢視表。舉例來說,下列查詢會使用「建立檢視表」中的檢視表:
SELECT * FROM my_ns.eng_employees ORDER BY emp_id;
SELECT * FROM my_ns.employee_directory ORDER BY id;
SELECT * FROM my_ns.top_eng_employees;
時間回溯和檢視表
您無法直接將 TIMESTAMP AS OF 或 VERSION AS OF 等時間旅行子句套用至檢視表 ID。如需歷來資料,請定義檢視表,並在 SQL 定義中對基礎資料表套用時間旅行,或使用 CTE 直接查詢基礎資料表。詳情請參閱「建立檢視表,並對基礎資料表使用時間旅行功能」。
後續步驟
- 瞭解如何取得檢視詳細資料。
- 瞭解如何排解 Iceberg 檢視表問題。