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] ページを開きます。
カタログの名前をクリックします。
[カタログの詳細] ページで、カタログ ID、作成タイムスタンプ、REST カタログ URI、認証方法、サービス アカウントなど、カタログに関する情報を確認します。
連携カタログの場合、[カタログの詳細] ページには、構成されている場合に次のプロパティも表示されます。
- ID モード: Databricks Unity Catalog 接続の
Service identityまたはUser identity federationを表示します。 - サービス ディレクトリ名: AWS Glue、Snowflake Horizon Catalog、Databricks Unity Catalog 接続でプライベート クエリ転送用に構成された Service Directory サービス リソース名が表示されます。
- メタデータ Service Directory 名: AWS Glue、Snowflake Horizon Catalog、Databricks Unity Catalog 接続でプライベート バックグラウンド メタデータ更新用に構成された Service Directory サービス リソース名が表示されます。
- ID モード: 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。