名前空間の作成

カタログ（Apache Iceberg REST カタログや Apache Hive カタログなど）に Namespace を作成すると、Lakehouse ランタイム カタログ内のテーブルを整理できます。

始める前に

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

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

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

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

    API の有効化

必要なロール

Namespace の作成に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

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

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

名前空間の作成

カタログ内に Namespace を作成します。

コンソール

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

    [Lakehouse] に移動

  2. 既存のカタログを選択するか、カタログがない場合は作成します。

  3. メニューバーで、[+ Namespace を作成] をクリックします。

  4. [Namespace name] に、Namespace の一意の名前を入力します。

  5. [ロケーション] で、Namespace に関連付ける Cloud Storage バケットを選択します。

  6. [作成] をクリックします。

    Namespace が作成され、カタログの詳細リストに表示されます。

REST

REST API を使用して Namespace を作成するには、CreateIcebergNamespace エンドポイントに POST リクエストを送信します。

POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces

リクエストの本文には、名前空間の識別子とプロパティを定義する有効な Iceberg CreateNamespaceRequest JSON ペイロードを含める必要があります。

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

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