カタログの更新

カタログ（Apache Iceberg REST カタログなど）を更新すると、認証情報モード、デフォルトのウェアハウスの場所、基盤となるカタログタイプなどのプロパティを変更できます。

たとえば、単一バケット（gs://）カタログをマルチバケット（bl://）カタログタイプにアップグレード できます（推奨）。カタログをアップグレードすると、カタログを複数のストレージ バケットにまたがって配置できるなど、大きなメリットがあります。

始める前に

  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 Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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 Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

必要なロール

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

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

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

カタログの更新

カタログは、 Google Cloud コンソール、gcloud、または REST API を使用して更新できます。

コンソール

  1. コンソールで、[Lakehouse] ページを開きます。 Google Cloud

    [Lakehouse] に移動

  2. 更新するカタログの行で、 [カタログの詳細 > 編集] をクリックします。

  3. [カタログ構成] で、更新する設定を変更します。

  4. [保存] を選択します。

gcloud

オプション 1: カタログ プロパティを更新する

カタログ プロパティ（説明や制限付きロケーションなど）を更新するには、 gcloud beta biglake iceberg catalogs update コマンドを実行します。

gcloud beta biglake iceberg catalogs update CATALOG_ID \
    --project="PROJECT_ID" \
    [--description="DESCRIPTION"] \
    [--credential-mode="CREDENTIAL_MODE"] \
    [--restricted-locations="RESTRICTED_LOCATIONS"]

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

  • CATALOG_ID: Lakehouse ランタイム カタログの ID。
  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • DESCRIPTION: （省略可）カタログの説明。
  • CREDENTIAL_MODE: （省略可）認証方法。[エンドユーザーの認証情報] には end-user を使用し、[認証情報ベンディング モード] には vended-credentials を使用します。
  • RESTRICTED_LOCATIONS: （省略可）追加で許可されるストレージ バケットまたはパスのカンマ区切りのリスト。注意: 複数の重複するパスまたはバケットを指定すると、メタデータの競合、誤ったデータの上書き、権限漏洩などのセキュリティ上の問題が発生する可能性があります。

オプション 2: 単一バケット（gs://）カタログをマルチバケット（bl://）カタログにアップグレードする（推奨）

既存の単一バケット（gs://）カタログを マルチバケット（bl://）カタログ（推奨）にアップグレードするには、gcloud beta biglake iceberg catalogs update コマンド を実行し、--catalog-type パラメータを biglake に設定します。

gcloud beta biglake iceberg catalogs update CATALOG_ID \
    --project="PROJECT_ID" \
    --catalog-type="biglake"

REST

オプション 1: カタログ プロパティを更新する

REST API を使用してカタログのプロパティ（説明など）を変更するには、適切な updateMask を使用して UpdateIcebergCatalog エンドポイントに PATCH リクエスト を行います。

PATCH /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID?updateMask=icebergCatalog.description

リクエストの本文には、更新するフィールドを含む IcebergCatalog JSON ペイロードを含める必要があります。

{
  "description": "Updated catalog description"
}

オプション 2: 単一バケット（gs://）カタログをマルチバケット（bl://）カタログにアップグレードする（推奨）

REST API を使用してタイプをアップグレードするには、PATCH リクエスト UpdateIcebergCatalog エンドポイントに catalogType を指定して updateMask を行います。

PATCH /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID?updateMask=icebergCatalog.catalogType

リクエストの本文には、新しいカタログタイプを含む IcebergCatalog JSON ペイロードを含める必要があります。

{
  "catalogType": "BIGLAKE"
}

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

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