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 bucket Cloud Storage lama (katalog gs://) ke katalog BigLake (katalog bl://).

Sebelum memulai

  1. Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

  2. Mengaktifkan BigLake API.

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

    Mengaktifkan 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 konfigurasi katalog, seperti mengubah deskripsi, mode kredensial, atau lokasi yang diizinkan.

Selain itu, Anda dapat mengupgrade katalog bucket Cloud Storage yang ada (katalog gs:// lama) ke katalog BigLake (katalog bl://). Katalog yang diupgrade mempertahankan nama bucket asli. Setelah upgrade, Anda dapat mengaitkan beberapa bucket dan mengonfigurasi lokasi terbatas.

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

Konsol

  1. Di konsol Google Cloud , 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 Save.

gcloud

Gunakan gcloud beta biglake iceberg catalogs update perintah.

gcloud beta biglake iceberg catalogs update CATALOG_ID \
    --project="PROJECT_ID" \
    [--description="DESCRIPTION"] \
    [--credential-mode="CREDENTIAL_MODE"] \
    [--restricted-locations="RESTRICTED_LOCATIONS"] \
    [--catalog-type=biglake]

Ganti kode berikut:

  • CATALOG_ID: ID katalog runtime Lakehouse Anda.
  • PROJECT_ID: Google Cloud Project ID Anda.
  • DESCRIPTION: (Opsional) deskripsi untuk katalog.
  • CREDENTIAL_MODE: (Opsional) metode autentikasi. Gunakan end-user untuk End-user credentials atau vended-credentials untuk Credential vending mode.
  • RESTRICTED_LOCATIONS: (Opsional) daftar yang dipisahkan koma dari bucket atau jalur penyimpanan tambahan yang diizinkan.

REST

Untuk mengubah katalog atau mengupgrade jenisnya 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.catalogType,icebergCatalog.description

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

{
  "catalogType": "BIGLAKE",
  "description": "Updated catalog description"
}

Ganti kode berikut:

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