Memperbarui katalog

Memperbarui katalog (seperti katalog REST Apache Iceberg) memungkinkan Anda mengubah propertinya, seperti mode kredensial, lokasi data warehouse default, atau jenis katalog yang mendasarinya.

Misalnya, Anda dapat mengupgrade katalog satu bucket (gs://) ke jenis katalog multi-bucket (bl://) (direkomendasikan). Mengupgrade katalog memberikan manfaat signifikan, seperti memungkinkan katalog Anda mencakup beberapa bucket penyimpanan.

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 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

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk memperbarui katalog, minta administrator untuk memberi Anda peran IAM berikut:

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.

Memperbarui katalog

Anda dapat memperbarui katalog menggunakan Google Cloud konsol, gcloud, atau REST API.

Konsol

  1. Di Google Cloud konsol, buka halaman Lakehouse.

    Buka Lakehouse

  2. Di baris katalog yang ingin Anda perbarui, klik Tindakan katalog lainnya > Edit.

  3. Di bagian Konfigurasi katalog, ubah setelan yang ingin Anda perbarui.

  4. Pilih Simpan.

gcloud

Opsi 1: Memperbarui properti katalog

Untuk memperbarui properti katalog (seperti deskripsi atau lokasi yang dibatasi), jalankan perintah 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"]

Ganti kode berikut:

  • CATALOG_ID: ID katalog runtime Lakehouse Anda.
  • PROJECT_ID: ID Google Cloud project Anda.
  • DESCRIPTION: (Opsional) deskripsi untuk katalog.
  • CREDENTIAL_MODE: (Opsional) metode autentikasi. Gunakan end-user untuk Kredensial pengguna akhir atau vended-credentials untuk Mode vending kredensial.
  • RESTRICTED_LOCATIONS: (Opsional) daftar bucket atau jalur penyimpanan tambahan yang diizinkan dan dipisahkan koma. Perhatian: Jika Anda menentukan beberapa jalur atau bucket yang tumpang-tindih, hal ini dapat menyebabkan konflik metadata, penimpaan data yang tidak disengaja, atau masalah keamanan seperti kebocoran izin.

Opsi 2: Mengupgrade katalog satu bucket (gs://) ke katalog multi-bucket (bl://) (direkomendasikan)

Untuk mengupgrade katalog satu bucket (gs://) yang ada ke katalog multi-bucket (bl://) (direkomendasikan), jalankan perintah gcloud beta biglake iceberg catalogs update dan tetapkan parameter --catalog-type ke biglake:

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

REST

Opsi 1: Memperbarui properti katalog

Untuk mengubah properti katalog (seperti deskripsinya) menggunakan REST API, buat permintaan PATCH ke endpoint UpdateIcebergCatalog dengan updateMask yang sesuai:

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

Isi permintaan harus berisi payload JSON IcebergCatalog dengan kolom yang akan diperbarui:

{
  "description": "Updated catalog description"
}

Opsi 2: Mengupgrade katalog satu bucket (gs://) ke katalog multi-bucket (bl://) (direkomendasikan)

Untuk mengupgrade jenisnya menggunakan REST API, buat PATCH permintaan ke endpoint UpdateIcebergCatalog dengan catalogType di updateMask:

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

Isi permintaan harus berisi payload JSON IcebergCatalog dengan jenis katalog baru:

{
  "catalogType": "BIGLAKE"
}

Ganti kode berikut:

  • PROJECT_ID: ID Google Cloud project Anda.
  • CATALOG_ID: ID katalog runtime Lakehouse Anda.