您可以使用 Spark 或 Apache Iceberg REST 目錄端點,檢查在 Lakehouse 執行階段目錄中註冊的 Apache Iceberg 檢視表結構定義、資料欄註解、屬性和 SQL 定義。
事前準備
-
如果尚未啟用 BigLake API,請先啟用。
啟用 API 所需的角色
如要啟用 API,您必須具備
serviceusage.services.enable權限。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。 - 使用 Apache Iceberg REST 目錄端點設定 Lakehouse 執行階段目錄。
- 查看 Iceberg 檢視表的限制。
- 建立檢視表。
必要的角色
如要取得查看詳細資料所需的權限,請要求管理員在專案和 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:檢視表名稱。