名前空間の作成

Lakehouse ランタイム カタログを使用すると、ボーダーレス Lakehouse のカタログ エンドポイントに名前空間を作成して、関連するテーブルをグループ化して整理できます。

名前空間を作成するときに、必要に応じて、カスタム Cloud Storage バケットまたはパスに関連付けるか、カタログのデフォルトのストレージ ロケーションを継承できます。

始める前に

  1. Lakehouse ランタイム カタログについてを読み、Lakehouse ランタイム カタログの仕組みとサービスの制限事項を理解する。
  2. 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, 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.

    Enable the API

必要なロール

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

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

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

名前空間の作成

カタログ内に名前空間を作成します。

考慮事項

名前空間を作成するときに、必要に応じて、名前空間に関連付ける Cloud Storage バケットまたはパスを指定できます。

  • マルチバケット カタログ(推奨): カタログで許可されているロケーション(default_location または restricted_locations)であれば、任意のカスタム ロケーションを設定できます。ロケーションを指定しない場合、名前空間はカタログのデフォルトの場所(gs://{default_location}/{namespace_name} など)に作成されます。
  • 単一バケット カタログ: 名前空間のロケーションは、カタログの単一バケットから自動的に継承されます。

コンソール

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

    [レイクハウス] に移動

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

  3. メニューバーで [名前空間を作成] をクリックします。

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

  5. 省略可: [ロケーション] に、名前空間に関連付ける Cloud Storage バケットまたはパスを指定します。ロケーションがウェアハウス バケットと一致している。

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

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

gcloud

マルチバケット カタログに名前空間を作成する(推奨)

複数バケット カタログに名前空間を作成するには(必要に応じてカスタム ロケーションを指定できます)、--properties フラグを指定して gcloud biglake iceberg namespaces create コマンドを実行します。

gcloud biglake iceberg namespaces create NAMESPACE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID" \
    [--properties="location=LOCATION"]

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

  • NAMESPACE_NAME: 名前空間の名前。
  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • CATALOG_ID: カタログの ID。
  • LOCATION: (省略可)名前空間に関連付けるカスタム Cloud Storage バケットまたはパス(例: gs://my-bucket/my-path)。

単一バケット カタログに Namespace を作成する

単一バケット カタログに名前空間を作成するには、--properties フラグを省略します。名前空間のロケーションは、カタログの単一バケットから自動的に継承されます。

gcloud biglake iceberg namespaces create NAMESPACE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID"

REST

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

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

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

{
  "namespace": [
    "NAMESPACE_NAME"
  ],
  "properties": {
    "location": "LOCATION"
  }
}

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

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • CATALOG_ID: カタログの ID。
  • NAMESPACE_NAME: 名前空間の名前。
  • LOCATION: (省略可)名前空間に関連付けるカスタム Cloud Storage バケットまたはパス(例: gs://my-bucket/my-path)。

次のステップ