Buat namespace

Membuat namespace dalam katalog (seperti katalog REST Apache Iceberg atau katalog Apache Hive) membantu Anda mengatur tabel dalam katalog runtime Lakehouse.

Sebelum memulai

  1. Baca Tentang katalog runtime Lakehouse untuk memahami cara kerja katalog runtime Lakehouse dan batasan untuk layanan ini.
    2. Login keakun Anda. Google Cloud Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

    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

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk membuat namespace, minta administrator Anda untuk memberi Anda peran IAM berikut di project Anda:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat namespace

Buat namespace dalam katalog.

Pertimbangan

Saat membuat namespace, Anda dapat secara opsional menentukan bucket Cloud Storage atau jalur untuk dikaitkan dengan namespace:

  • Katalog multi-bucket (bl://) (direkomendasikan): Anda dapat menetapkan lokasi kustom apa pun selama berada di bawah lokasi yang diizinkan oleh katalog (default_location atau restricted_locations). Jika Anda tidak menentukan lokasi, namespace akan dibuat di lokasi default katalog (misalnya, gs://{default_location}/{namespace_name}).

  • Katalog bucket tunggal (gs://): Lokasi namespace otomatis diwarisi dari bucket tunggal katalog.

Konsol

  1. Dikonsol, buka halaman Lakehouse. Google Cloud

    Buka Lakehouse

  2. Pilih katalog yang ada atau buat katalog jika Anda belum memilikinya.

  3. Di menu bar, klik + Buat namespace.

  4. Untuk Nama namespace, masukkan nama unik untuk namespace Anda.

  5. Untuk Lokasi, tentukan bucket atau jalur Cloud Storage secara opsional untuk dikaitkan dengan namespace Anda. Lokasi tersebut cocok dengan bucket data warehouse.

  6. Klik Buat.

    Namespace Anda akan dibuat dan muncul dalam daftar detail katalog Anda.

gcloud

Membuat namespace dalam katalog multi-bucket (bl://) (direkomendasikan)

Untuk membuat namespace dalam katalog multi-bucket (tempat Anda dapat menentukan lokasi kustom secara opsional), jalankan gcloud biglake iceberg namespaces create perintah dengan tanda --properties:

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

Ganti kode berikut:

  • NAMESPACE_NAME: nama untuk namespace Anda.
  • PROJECT_ID: Project ID Google Cloud Anda.
  • CATALOG_ID: ID katalog Anda.
  • LOCATION: (Opsional) bucket atau jalur Cloud Storage kustom untuk dikaitkan dengan namespace (misalnya, gs://my-bucket/my-path).

Membuat namespace dalam katalog bucket tunggal (gs://)

Untuk membuat namespace dalam katalog bucket tunggal, hapus tanda --properties. Lokasi namespace otomatis diwarisi dari bucket tunggal katalog.

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

REST

Untuk membuat namespace menggunakan REST API, buat permintaan POST ke CreateIcebergNamespace endpoint:

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

Isi permintaan harus berisi payload JSON CreateNamespaceRequest Iceberg yang valid yang menentukan properti dan ID namespace:

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

Ganti kode berikut:

  • PROJECT_ID: Project ID Google Cloud Anda.
  • CATALOG_ID: ID katalog Anda.
  • NAMESPACE_NAME: nama untuk namespace Anda.
  • LOCATION: (Opsional) bucket atau jalur Cloud Storage kustom untuk dikaitkan dengan namespace (misalnya, gs://my-bucket/my-path).

Langkah berikutnya