Lakehouse ランタイム カタログを使用すると、ボーダーレス Lakehouse のカタログ エンドポイントに名前空間を作成して、関連するテーブルをグループ化して整理できます。
名前空間を作成するときに、必要に応じて、カスタム Cloud Storage バケットまたはパスに関連付けるか、カタログのデフォルトのストレージ ロケーションを継承できます。
始める前に
- Lakehouse ランタイム カタログについてを読み、Lakehouse ランタイム カタログの仕組みとサービスの制限事項を理解する。
- 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 theresourcemanager.projects.createpermission. Learn how to grant roles.
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
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.
必要なロール
名前空間の作成に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。
-
すべて:
- BigLake 管理者(
roles/biglake.admin) - ストレージ管理者(
roles/storage.admin)
- BigLake 管理者(
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
名前空間の作成
カタログ内に名前空間を作成します。
考慮事項
名前空間を作成するときに、必要に応じて、名前空間に関連付ける Cloud Storage バケットまたはパスを指定できます。
- マルチバケット カタログ(推奨): カタログで許可されているロケーション(
default_locationまたはrestricted_locations)であれば、任意のカスタム ロケーションを設定できます。ロケーションを指定しない場合、名前空間はカタログのデフォルトの場所(gs://{default_location}/{namespace_name}など)に作成されます。 単一バケット カタログ: 名前空間のロケーションは、カタログの単一バケットから自動的に継承されます。
コンソール
Google Cloud コンソールで、[Lakehouse] ページを開きます。
既存のカタログを選択するか、カタログがない場合は作成します。
メニューバーで [名前空間を作成] をクリックします。
[Namespace name] に、Namespace の一意の名前を入力します。
省略可: [ロケーション] に、名前空間に関連付ける Cloud Storage バケットまたはパスを指定します。ロケーションがウェアハウス バケットと一致している。
[作成] をクリックします。
名前空間が作成され、カタログの詳細リストに表示されます。
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)。
次のステップ
- 名前空間 ACL を管理する方法を確認する。