Iceberg REST カタログ リソースを管理する

Lakehouse for Apache Iceberg を使用すると、 Lakehouse ランタイム カタログ 内で Apache Iceberg REST カタログ エンドポイントを管理できます。コンソールまたは REST API を使用して、これらのカタログを作成、構成、モニタリングし、クエリエンジン接続に必要なメタデータ レイヤを確立できます。 Google Cloud

始める前に

  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

必要なロール

Lakehouse ランタイム カタログを使用するために必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

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

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

管理アクション

コンソールまたは REST API を使用して、Apache Iceberg REST カタログ リソースに対して次の管理アクションを実行できます。 Google Cloud

  • カタログを作成する: 基盤となる Cloud Storage ウェアハウスのロケーションを指す Apache Iceberg REST カタログ管理エンドポイントを作成します（CreateIcebergCatalog）。
  • カタログを更新する: 既存の Cloud Storage バケット カタログ（従来の gs:// カタログ）を BigLake カタログ（bl:// カタログ）にアップグレードします（UpdateIcebergCatalog）。
  • 名前空間を作成する: Iceberg REST カタログ内に名前空間を作成して、関連するテーブルをグループ化します（CreateIcebergNamespace）。
  • 認証情報ベンダーを有効にする: 既存のカタログの認証方法を認証情報ベンダー モードに切り替えて、有効期間の短いストレージ トークンをクエリエンジンに直接提供します（UpdateIcebergCatalog）。
  • カタログの詳細を取得する: クライアント接続に必要な REST カタログ URI など、カタログのプロパティとメタデータを表示します（GetIcebergCatalog）。
  • 名前空間 ACL を管理する: カタログの名前空間の IAM ポリシーを表示して更新し、特定のプリンシパルのアクセスを制御します（get-iam-policy、set-iam-policy）。
  • カタログを削除する: Lakehouse ランタイム カタログからカタログ メタデータ管理エンドポイントの登録を解除します（DeleteIcebergCatalog）。
  • 名前空間を削除する: Iceberg REST カタログから不要になった名前空間を削除します（DeleteIcebergNamespace）。
  • 監査ログを表示する: Cloud Audit Logs で、管理アクティビティとデータアクセス アクティビティの検証可能なレコードを確認します。

料金

料金の詳細については、Lakehouse for Apache Iceberg の料金をご覧ください。

次のステップ