列出檢視表,即可查看 Lakehouse 執行階段目錄命名空間中註冊了哪些 Apache Iceberg 檢視表。結果只會包含檢視表 ID,不含資料表,而列出資料表時,同樣會排除檢視表。
事前準備
-
如果尚未啟用 BigLake API,請先啟用。
啟用 API 所需的角色
如要啟用 API,您必須具備
serviceusage.services.enable權限。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。 - 使用 Apache Iceberg REST 目錄端點設定 Lakehouse 執行階段目錄。
- 查看 Iceberg 檢視表的限制。
- 建立檢視表。
必要的角色
如要取得列出清單檢視所需的權限,請要求管理員在專案中授予您下列 IAM 角色:
-
清單檢視:
BigLake 檢視者 (
roles/biglake.viewer) - 您的專案
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這些預先定義的角色具備列出清單檢視所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
必須具備下列權限,才能列出檢視表:
-
清單檢視:
biglake.views.list命名空間
如需查看權限的完整清單,請參閱「必要角色和權限」。
清單檢視表
列出命名空間中的檢視表。
Spark
SHOW VIEWS IN NAMESPACE_NAME;
將 NAMESPACE_NAME 替換為命名空間名稱。
REST
如要使用 REST API 列出清單檢視,請向 ListIcebergViewIdentifiers 端點發出 GET 要求:
GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views
端點支援 pageToken 和 pageSize 查詢參數。
更改下列內容:
PROJECT_ID:您的 Google Cloud專案 ID。CATALOG_ID:目錄 ID。NAMESPACE_NAME:目錄命名空間的名稱。