カタログを作成

カタログ（Apache Iceberg REST カタログや Apache Hive カタログなど）を作成すると、Lakehouse ランタイム カタログ 内に管理エンドポイントが確立されます。 このエンドポイントは、基盤となる Cloud Storage ウェアハウス バケットを指し、クエリエンジンとオープンソース ワークロードがテーブルと直接やり取りできるメタデータ レイヤを提供します。

Lakehouse for Apache Iceberg のカタログを作成する場合は、ストレージ アクセスの委任にエンドユーザー認証情報または認証情報ベンダーモードを選択できます。

始める前に

1. プロジェクト Google Cloud に対して課金が有効になっていることを確認します。

2. BigLake API を有効にします。

   API を有効にするために必要なロール

   API を有効にするには、serviceusage.services.enable 権限を含む Service Usage 管理者 IAM ロール（roles/serviceusage.serviceUsageAdmin）が必要です。詳しくは、ロールを付与する方法をご覧ください。

   API の有効化

必要なロール

カタログの作成に必要な権限を取得するには、管理者に次の IAM ロールを付与するよう依頼してください。

• すべて:
  • プロジェクトに対する BigLake 管理者 （roles/biglake.admin）
  • ストレージ管理者 （roles/storage.admin） プロジェクトに対する
• 認証情報ベンダーモードで自動プロビジョニングされた Lakehouse ランタイム カタログ サービス アカウント: Storage オブジェクト ユーザー （roles/storage.objectUser） ターゲット Cloud Storage バケットに対する。カタログを作成したら、ストレージ バケットに対する Storage オブジェクト ユーザーロール（roles/storage.objectUser）を、カタログの自動プロビジョニングされた Lakehouse ランタイム カタログ サービス アカウントに明示的に付与します。

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

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

カタログを作成

カタログ エンドポイントを作成します。

POST /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs?icebergCatalogId=CATALOG_ID