取得目錄詳細資料

擷取設定屬性會公開 Lakehouse for Apache Iceberg 的中繼資料。

在 Lakehouse 執行階段目錄中檢查現有目錄 (例如 Apache Iceberg REST 目錄或 Apache Hive 目錄) 時，會顯示目錄詳細資料。如果是 Apache Iceberg REST 目錄，這包括用戶端連線所需的 REST 目錄 URI、驗證方法和相關聯的服務帳戶。

事前準備

  1. 請參閱「關於 Lakehouse 執行階段目錄」，瞭解 Lakehouse 執行階段目錄的運作方式和服務限制。
    2. 登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎 建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

    Enable the BigLake API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

    Enable the BigLake API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

必要的角色

如要取得查看目錄詳細資料所需的權限，請要求管理員在專案中授予您下列 IAM 角色：

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

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

取得目錄詳細資料

檢查目錄設定和屬性。

控制台

  1. 在 Google Cloud 控制台中開啟「Lakehouse」Lakehouse頁面。

    前往 Lakehouse

  2. 按一下任一目錄的名稱。

  3. 在「目錄詳細資料」頁面中，查看目錄相關資訊，例如目錄 ID、建立時間戳記、REST 目錄 URI、驗證方法和服務帳戶。

gcloud

如要使用 gcloud 描述目錄，請執行 gcloud biglake iceberg catalogs describe 指令。

gcloud biglake iceberg catalogs describe CATALOG_ID \
    --project="PROJECT_ID"

更改下列內容：

  • CATALOG_ID：目錄 ID。
  • PROJECT_ID：您的 Google Cloud 專案 ID。

REST

如要使用 REST API 擷取目錄詳細資料和設定，請向 GetIcebergCatalog 端點發出 GET 要求：

GET /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID

回應包含 IcebergCatalog JSON 物件，說明目錄設定。

更改下列內容：

  • PROJECT_ID：您的 Google Cloud 專案 ID。
  • CATALOG_ID：目錄 ID。