Mengelola tabel katalog REST Iceberg Lakehouse

Lakehouse untuk Apache Iceberg mendukung pembuatan, pengelolaan, dan kueri tabel katalog REST Lakehouse Iceberg yang disimpan di Cloud Storage.

Dikelola melalui katalog runtime Lakehouse, tabel ini dapat dibaca oleh BigQuery dan mesin open source yang terhubung. Operasi tulis tetap dibatasi untuk mesin tertentu yang awalnya membuat tabel. Selain integrasi mesin kueri, katalog runtime Lakehouse menerapkan spesifikasi Iceberg REST Catalog API open source, sehingga memungkinkan klien REST yang kompatibel berinteraksi langsung dengan resource tabel.

Sebelum memulai

Lihat ringkasan tabel untuk memahami berbagai jenis tabel dan implikasi penggunaannya.

  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 mengelola tabel katalog REST Iceberg Lakehouse, minta administrator untuk memberi Anda peran IAM berikut pada project dan bucket penyimpanan Anda:

  • Membuat dan menghapus tabel:
    • Admin BigLake (roles/biglake.admin) - project
    • Storage Admin (roles/storage.admin) - bucket Cloud Storage
  • Membaca data tabel dalam mode penyediaan kredensial: BigLake Viewer (roles/biglake.viewer) - project
  • Menulis data tabel dalam mode penyediaan kredensial: BigLake Editor (roles/biglake.editor) - project
  • Membaca data tabel dalam mode penyediaan non-kredensial:
    • Pelihat BigLake (roles/biglake.viewer) - project
    • Storage Object Viewer (roles/storage.objectViewer) - bucket Cloud Storage
  • Menulis data tabel dalam mode penjualan non-kredensial:
    • 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.

Tindakan pengelolaan

Anda dapat melakukan tindakan pengelolaan berikut pada tabel katalog REST Iceberg Lakehouse:

  • Buat tabel: Buat tabel Apache Iceberg dalam namespace katalog menggunakan konsol Google Cloud , Spark, Trino, atau Iceberg REST Catalog API (CreateIcebergTable).
  • Mencantumkan tabel: Melihat ID tabel dalam namespace menggunakan konsol Google Cloud , Spark, Trino, atau Iceberg REST Catalog API (ListIcebergTableIdentifiers).
  • Mendapatkan detail tabel: Periksa skema, properti, dan kredensial tabel menggunakan konsol Google Cloud , Spark, Trino, atau Iceberg REST Catalog API (GetIcebergTable, LoadIcebergTableCredentials).
  • Menyisipkan data: Tambahkan baris data ke tabel Iceberg menggunakan Spark atau Trino.
  • Mengkueri tabel: Jalankan kueri terhadap tabel Iceberg dari Spark, Trino, atau BigQuery menggunakan penamaan tabel empat bagian.
  • Mengubah tabel: Mengembangkan skema tabel dan memperbarui properti metadata menggunakan konsol Google Cloud , Spark, Trino, atau Iceberg REST Catalog API (UpdateIcebergTable).
  • Menghapus tabel: Menghapus pendaftaran tabel dari katalog tanpa menghapus file penyimpanan pokok menggunakan konsol Google Cloud , Spark, Trino, atau Iceberg REST Catalog API (DeleteIcebergTable).

Langkah berikutnya