カタログの詳細を取得する

構成プロパティを取得すると、 ボーダレス Lakehouseのメタデータが公開されます。

Lakehouse ランタイム カタログ内で既存のカタログ （Apache Iceberg REST カタログや Apache Hive カタログなど）を検査すると、その 詳細が表示されます。Apache Iceberg REST カタログの場合、これにはクライアント接続に必要な REST カタログ URI、認証方法、関連付けられたサービス アカウントが含まれます。

始める前に

1. Lakehouse ランタイム カタログについてを読んで、Lakehouse ランタイム カタログの仕組みとサービスの制限事項を理解してください。
アカウントに 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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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 ロールの付与を管理者に依頼してください。

• すべて:
  • BigLake 管理者 （roles/biglake.admin）
  • ストレージ管理者 （roles/storage.admin）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。

カタログの詳細を取得する

カタログの構成とプロパティを検査します。

コンソール

1. Google Cloud コンソールで、[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 を使用してカタログの詳細と構成を取得するには、GET リクエストを GetIcebergCatalog エンドポイントに送信します。

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

レスポンスには、カタログ構成を記述する IcebergCatalog JSON オブジェクトが含まれます。

次のように置き換えます。

• PROJECT_ID: 実際の Google Cloud プロジェクト ID。
• CATALOG_ID: カタログの ID。