Mengupgrade tabel Iceberg V1 ke V2

Jika memiliki tabel Apache Iceberg versi 1 (V1), Anda harus mengupgradenya menggunakan mesin kueri sebelum menggunakannya dengan endpoint katalog REST Apache Iceberg. Untuk mengetahui informasi selengkapnya, lihat Mengubah tabel.

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

  3. Siapkan katalog runtime Lakehouse dengan endpoint katalog REST Apache Iceberg.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengupgrade tabel, minta administrator untuk memberi Anda peran IAM berikut di project dan bucket penyimpanan Anda:

  • Mengupgrade tabel dalam mode penyediaan kredensial: BigLake Editor (roles/biglake.editor) - project
  • Mengupgrade tabel dalam mode penyediaan non-kredensial:
    • Editor BigLake (roles/biglake.editor) - project
    • Storage Object User (roles/storage.objectUser) - bucket Cloud Storage

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.

Mengupgrade tabel

Untuk mengupgrade tabel Iceberg V1 ke V2, jalankan perintah berikut di mesin kueri Anda:

Spark 

ALTER TABLE CATALOG_NAME.SCHEMA_NAME.TABLE_NAME SET TBLPROPERTIES ('format-version'='2');

Ganti kode berikut:

  • CATALOG_NAME: nama katalog Anda.
  • SCHEMA_NAME: nama skema Anda.
  • TABLE_NAME: nama tabel Anda.

Langkah berikutnya