取得檢視詳細資料

您可以使用 Spark 或 Apache Iceberg REST 目錄端點,檢查在 Lakehouse 執行階段目錄中註冊的 Apache Iceberg 檢視表結構定義、資料欄註解、屬性和 SQL 定義。

事前準備

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

必要的角色

如要取得查看詳細資料所需的權限,請要求管理員在專案和 Storage bucket 中,授予您下列 IAM 角色:

  • 取得檢視表詳細資料:BigLake 檢視者 (roles/biglake.viewer) - 您的專案
  • 在使用者憑證模式中讀取檢視表中繼資料檔案:Storage 物件檢視者 (roles/storage.objectViewer) - Cloud Storage bucket

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

這些預先定義的角色具備取得檢視詳細資料所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

必須具備下列權限,才能取得檢視表詳細資料:

  • 取得檢視表詳細資料: biglake.views.get 檢視表
  • 在使用者憑證模式下讀取檢視表中繼資料檔案:Cloud Storage bucket 上的 storage.objects.get

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

如需查看權限的完整清單,請參閱「必要角色和權限」。

取得檢視詳細資料

檢查檢視畫面。

Spark

顯示檢視表結構定義、資料欄註解和檢視表屬性:

DESCRIBE EXTENDED NAMESPACE_NAME.VIEW_NAME;

顯示定義檢視表的 SQL 陳述式:

SHOW CREATE TABLE NAMESPACE_NAME.VIEW_NAME;

只顯示檢視畫面屬性:

SHOW TBLPROPERTIES NAMESPACE_NAME.VIEW_NAME;

更改下列內容:

  • NAMESPACE_NAME:命名空間的名稱。
  • VIEW_NAME:檢視表名稱。

REST

如要使用 REST API 載入檢視畫面的目前中繼資料,請向 GetIcebergView 端點發出 GET 要求:

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME

回應包含檢視畫面的 metadata-location 和 metadata。

如要檢查檢視表是否存在,而不載入其中繼資料,請向相同路徑發出 HEAD 要求。如果檢視畫面存在,CheckIcebergViewExists 端點會傳回 204 No Content,否則會傳回 404 Not Found。

更改下列內容:

  • PROJECT_ID:您的 Google Cloud專案 ID。
  • CATALOG_ID:目錄 ID。
  • NAMESPACE_NAME:目錄命名空間的名稱。
  • VIEW_NAME:檢視表名稱。

後續步驟