Mengubah tabel

Katalog runtime Lakehouse memungkinkan Anda mengubah tabel Apache Iceberg untuk mengembangkan skema, seperti menambahkan kolom, dan mengonfigurasi properti tabel. Update ini membantu Anda menyimpan metadata kustom atau mengaktifkan kemampuan yang dikelola BigQuery (Pratinjau), termasuk Bahasa Manipulasi Data (DML) BigQuery dan pemeliharaan tabel otomatis.

Anda dapat mengubah tabel menggunakan konsol Google Cloud , Apache Spark, Trino, BigQuery (Pratinjau), atau REST API. Untuk memperbarui properti tabel dari command line, Anda juga dapat menggunakan Google Cloud CLI.

Sebelum memulai

  1. Pastikan penagihan diaktifkan untuk project Google Cloud Anda.

  2. Aktifkan BigLake API, jika belum diaktifkan.

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). 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 mengubah tabel, minta administrator untuk memberi Anda peran IAM berikut pada project dan bucket penyimpanan Anda:

  • Mengubah tabel dalam mode penyediaan kredensial: BigLake Editor (roles/biglake.editor) - project
  • Mengubah tabel dalam mode non-credential vending:
    • BigLake Editor (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.

Kemampuan dan dukungan tabel

Saat menggunakan tabel di katalog runtime Lakehouse, sebaiknya pahami berbagai jenis tabel dan kemampuan keikutsertaannya. Untuk mempelajari lebih lanjut cara menggunakan tabel Apache Iceberg, lihat Ringkasan tabel Apache Iceberg.

Tabel Iceberg yang didukung

Hanya tabel Apache Iceberg V2 (GA) dan V3 (Pratinjau) yang didukung. Tabel Iceberg V1 tidak didukung. Untuk mengupgrade tabel V1 yang ada, lihat Mengupgrade tabel Iceberg V1 ke V2.

Menggunakan opsi tabel (Pratinjau)

Anda dapat memilih untuk menggunakan kemampuan yang dikelola BigQuery, seperti Bahasa Pengolahan Data (DML) BigQuery dan pengelolaan tabel otomatis, dengan mengonfigurasi properti tabel tertentu. Fitur ini diaktifkan dengan cara yang berbeda, bergantung pada tempat tabel dibuat:

  • Dari BigQuery: DML BigQuery dan pengelolaan tabel otomatis diaktifkan secara default.
  • Dari mesin open source: Untuk memilih ikut serta, Anda harus mengonfigurasi properti tabel secara eksplisit. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi opsi tabel.

Lihat Mengonfigurasi opsi tabel untuk mengetahui petunjuk mendetail.

Mengubah tabel

Pilih salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Lakehouse.

    Buka Lakehouse

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

  3. Pilih namespace yang ada, atau buat namespace jika Anda belum memilikinya.

  4. Di halaman Namespace details, pada tab Tables, klik nama tabel yang ingin Anda ubah. Halaman Table details akan terbuka.

  5. Untuk menambahkan kolom ke skema tabel, lakukan tindakan berikut:

    1. Klik tab Schema.
    2. Klik Edit schema.
    3. Di bagian New fields, klik Add field. Di Field name, masukkan nama kolom, dan di daftar Type, pilih jenis data. Untuk memasukkan kolom sebagai teks, klik tombol Edit as text ke posisi aktif, lalu masukkan JSON atau pasangan name:type yang dipisahkan koma.
    4. Klik Simpan.
  6. Untuk memperbarui properti tabel, lakukan hal berikut:

    1. Klik tab Details.
    2. Klik Edit detail.
    3. Di bagian Properties, perbarui nilai properti yang ada. Untuk menambahkan properti kustom, klik Add property, lalu di kolom Key dan Value, masukkan kunci dan nilai properti.

      Misalnya, untuk mengaktifkan DML BigQuery atau pemeliharaan tabel otomatis, di kolom Value untuk gcp.biglake.bigquery-dml.enabled atau gcp.biglake.table-management.enabled, masukkan true. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi opsi tabel.

    4. Klik Update.

Spark

spark.sql("ALTER TABLE TABLE_NAME ADD COLUMNS ( desc string);")
spark.sql("DESCRIBE NAMESPACE_NAME.TABLE_NAME").show()

Untuk mengaktifkan interoperabilitas baca/tulis dan pemeliharaan tabel, tetapkan properti menggunakan klausa SET TBLPROPERTIES:

SET TBLPROPERTIES (
  'gcp.biglake.bigquery-dml.enabled' = true,
  'gcp.biglake.table-management.enabled' = true
)

Trino

ALTER TABLE TABLE_NAME ADD COLUMN desc varchar;
DESCRIBE SCHEMA_NAME.TABLE_NAME;

Untuk mengaktifkan interoperabilitas baca/tulis dan pemeliharaan tabel, Anda dapat mengonfigurasi properti tabel berikut:

  • 'gcp.biglake.bigquery-dml.enabled' = true
  • 'gcp.biglake.table-management.enabled' = true

gcloud

Untuk memperbarui properti tabel menggunakan gcloud, jalankan perintah gcloud biglake iceberg tables update.

gcloud biglake iceberg tables update TABLE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID" \
    --namespace="NAMESPACE_NAME" \
    --update-properties="KEY=VALUE,..."

Ganti kode berikut:

  • TABLE_NAME: nama tabel Iceberg Anda.
  • PROJECT_ID: project ID Google Cloud Anda.
  • CATALOG_ID: ID katalog Anda.
  • NAMESPACE_NAME: nama namespace katalog Anda.
  • KEY=VALUE,...: properti tabel yang akan ditambahkan atau diupdate.

BigQuery

Untuk memperbarui properti tabel untuk tabel Apache Iceberg di katalog runtime Lakehouse dari BigQuery (seperti mengaktifkan DML BigQuery atau pemeliharaan tabel otomatis), gunakan pernyataan ALTER TABLE GoogleSQL berikut:

ALTER TABLE `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME`
SET OPTIONS (`properties.gcp.biglake.table-management` = "enabled");

Untuk memperbarui skema dan menambahkan kolom dalam tabel Apache Iceberg di katalog runtime Lakehouse dari BigQuery, gunakan pernyataan ALTER TABLE GoogleSQL berikut:

ALTER TABLE `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME`
ADD COLUMN new_column STRING;

Ganti kode berikut:

  • PROJECT_ID: project ID Google Cloud Anda.
  • CATALOG_ID: ID katalog runtime Lakehouse Anda.
  • NAMESPACE: nama namespace Iceberg Anda.
  • TABLE_NAME: nama tabel Iceberg Anda.

REST

Untuk meng-commit perubahan pada tabel Iceberg menggunakan REST API, buat permintaan POST ke endpoint UpdateIcebergTable (CommitTable):

POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME

Isi permintaan harus berisi payload JSON CommitTableRequest Iceberg yang valid yang menentukan persyaratan dasar dan daftar update metadata yang akan diterapkan.

Ganti kode berikut:

  • PROJECT_ID: Project ID Google Cloud Anda.
  • CATALOG_ID: ID katalog Anda.
  • NAMESPACE_NAME: nama namespace katalog Anda.
  • TABLE_NAME: nama tabel Iceberg Anda.

Langkah berikutnya