Mengubah tampilan

Dengan mengubah tampilan Apache Iceberg, Anda dapat mengembangkan skema dan definisi SQL tampilan, atau menetapkan dan membatalkan penetapan properti tampilan kustom, tanpa mengubah identitas tampilan di katalog runtime Lakehouse.

Penggantian nama tampilan tidak didukung. Untuk mengganti nama tampilan, buat tampilan dengan nama baru, lalu hapus tampilan asli. Lokasi penyimpanan tampilan juga tidak dapat diubah setelah dibuat, dan update yang menetapkan lokasi berbeda akan gagal dengan error 400 Bad Request.

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.
  4. Tinjau batasan tampilan Iceberg.
  5. Membuat tampilan.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengubah tampilan, minta administrator untuk memberi Anda peran IAM berikut pada project dan bucket penyimpanan Anda:

  • Mengubah tampilan: BigLake Editor (roles/biglake.editor) - project Anda
  • Tulis file metadata tampilan dalam mode kredensial pengguna akhir: Storage Object User (roles/storage.objectUser) - bucket Cloud Storage

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk mengubah tampilan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengubah tampilan:

  • Mengubah tampilan:
    • biglake.views.update pada tampilan
    • biglake.tables.get di setiap tabel Iceberg yang dirujuk oleh definisi tampilan baru
  • Menulis file metadata tampilan dalam mode kredensial pengguna akhir: storage.objects.create di bucket Cloud Storage

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk mengetahui daftar lengkap izin lihat, lihat Peran dan izin yang diperlukan.

Mengganti definisi tampilan

Mengganti skema dan logika SQL dari tampilan yang ada. Saat Anda mengganti tampilan, katalog akan menulis file metadata.json berversi baru (misalnya, 00001-UUID.metadata.json), menambahkan versi tampilan dan skema baru ke metadata tampilan, serta mempertahankan view-uuid tampilan.

Spark

CREATE OR REPLACE VIEW my_ns.eng_employees (
  emp_id,
  emp_name,
  dept,
  salary,
  is_senior
)
COMMENT 'Updated Engineering view with seniority flag'
AS SELECT id, name, dept, salary, (salary >= 140000.0) AS is_senior
FROM my_ns.employees
WHERE dept = 'Engineering';

REST

Untuk memperbarui tampilan menggunakan REST API, buat permintaan POST ke endpoint UpdateIcebergView:

POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME

Isi permintaan harus berisi payload JSON CommitViewRequest Iceberg yang valid dengan requirements dan updates yang akan diterapkan. Katalog memvalidasi persyaratan konkurensi optimis dan meng-commit update ke file metadata.json baru.

Ganti kode berikut:

  • PROJECT_ID: project ID Google Cloud Anda.
  • CATALOG_ID: ID katalog Anda.
  • NAMESPACE_NAME: nama namespace katalog Anda.
  • VIEW_NAME: nama tabel virtual Anda.

Menetapkan dan membatalkan penetapan properti tampilan

Menetapkan atau menghapus properti kustom pada tampilan tanpa mengubah definisinya.

Spark

Tetapkan properti:

ALTER VIEW my_ns.eng_employees
SET TBLPROPERTIES ('tier' = 'gold', 'reviewed' = 'true');

Membatalkan penetapan properti:

ALTER VIEW my_ns.eng_employees
UNSET TBLPROPERTIES IF EXISTS ('reviewed');

Untuk mengetahui detail tentang cara katalog menangani properti seperti write.metadata.compression-codec, lihat Melihat properti.

REST

Kirim CommitViewRequest ke endpoint UpdateIcebergView dengan pembaruan set-properties atau remove-properties. Lihat Mengganti definisi tampilan untuk jalur endpoint.

Langkah berikutnya