查詢檢視表

查詢 Apache Iceberg 檢視表時,系統會執行儲存在 Lakehouse 執行階段目錄中的 SQL 定義,從基礎 Iceberg 資料表讀取精選的零複製結果。您的 Compute Engine 會從目錄載入檢視表定義、解析每個參照的資料表和巢狀檢視表,然後讀取 Cloud Storage 中的資料檔案。

您只能透過與 Iceberg 相容的開放原始碼引擎 (例如 Spark 和 Trino) 查詢 Iceberg 檢視表。BigQuery 不支援查詢 Iceberg 檢視表。

事前準備

  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. 建立檢視表。

必要的角色

由於 Compute Engine 會在用戶端評估檢視表,因此您必須具備檢視表的權限,以及檢視表參照的每個資料表和巢狀檢視表的權限。

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

  • 在憑證販售模式中讀取檢視表和參照資料表:BigLake 檢視者 (roles/biglake.viewer) - 您的專案
  • 在使用者憑證模式中讀取檢視表和參照資料表:
    • BigLake 檢視者 (roles/biglake.viewer) - 您的專案
    • Storage 物件檢視者 (roles/storage.objectViewer) - Cloud Storage bucket

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

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

所需權限

必須具備下列權限,才能查詢檢視表:

  • 查詢檢視表:
    • 檢視畫面和任何巢狀檢視畫面上的 biglake.views.get
    • 檢視表參照的每個 Iceberg 資料表上,都有 biglake.tables.get
  • 在憑證販售模式中讀取資料表資料: biglake.tables.getData 在檢視表參照的每個 Iceberg 資料表上
  • 在使用者憑證模式中讀取檢視表中繼資料和資料表資料: storage.objects.get Cloud 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 直接查詢基礎資料表。詳情請參閱「建立檢視表,並對基礎資料表使用時間旅行功能」。

後續步驟