您可以透過 Lakehouse 執行階段目錄,檢查無邊界 Lakehouse 中目錄端點的設定和中繼資料。如果是 Apache Iceberg REST 目錄端點,您可以擷取用戶端連線所需的 REST 目錄 URI、驗證方式和相關聯的服務帳戶。如要進一步瞭解目錄端點,請參閱「目錄類型和端點設定」。
事前準備
- 請參閱「關於 Lakehouse 執行階段目錄」,瞭解 Lakehouse 執行階段目錄的運作方式和服務限制。
- 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 theresourcemanager.projects.createpermission. Learn how to grant roles. - 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 theresourcemanager.projects.createpermission. Learn how to grant roles.
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
Verify that billing is enabled for your Google Cloud project.
Enable the BigLake API, if it is not already enabled.
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.
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
Verify that billing is enabled for your Google Cloud project.
Enable the BigLake API, if it is not already enabled.
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.
必要的角色
如要取得查看目錄端點詳細資料所需的權限,請要求管理員在專案中授予您下列 IAM 角色:
-
全部:
- BigLake 管理員 (
roles/biglake.admin) - 儲存空間管理員 (
roles/storage.admin)
- BigLake 管理員 (
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
取得目錄端點詳細資料
檢查目錄端點設定和屬性。
控制台
在 Google Cloud 控制台開啟「Lakehouse」Lakehouse頁面。
按一下任一目錄的名稱。
在「Catalog Details」(目錄詳細資料) 頁面中,查看目錄相關資訊,例如目錄 ID、建立時間戳記、REST 目錄 URI、驗證方式和服務帳戶。
如果是聯合目錄,Catalog Details (目錄詳細資料) 頁面也會顯示下列屬性 (如有設定):
- 身分模式:顯示 Databricks Unity Catalog 連線的
Service identity或User identity federation。 - 「Service directory name」(Service Directory 名稱):顯示為 AWS Glue、Snowflake Horizon Catalog 和 Databricks Unity Catalog 連線,設定的私人查詢傳輸 Service Directory 服務資源名稱。
- 「Metadata service directory name」(中繼資料 Service Directory 名稱):顯示 Service Directory 服務資源名稱,用於在 AWS Glue、Snowflake Horizon Catalog 和 Databricks Unity Catalog 連線,設定私人背景中繼資料重新整理。
- 身分模式:顯示 Databricks Unity Catalog 連線的
gcloud
如要使用 Google Cloud CLI 描述目錄端點,請執行 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。