清單檢視表

列出檢視表,即可查看 Lakehouse 執行階段目錄命名空間中註冊了哪些 Apache Iceberg 檢視表。結果只會包含檢視表 ID,不含資料表,而列出資料表時,同樣會排除檢視表。

事前準備

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

必要的角色

如要取得列出清單檢視所需的權限,請要求管理員在專案中授予您下列 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:目錄命名空間的名稱。

後續步驟