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
-
Pastikan penagihan diaktifkan untuk project Google Cloud Anda.
-
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. - Siapkan katalog runtime Lakehouse dengan endpoint katalog REST Apache Iceberg.
- Tinjau batasan tampilan Iceberg.
- 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.updatepada tampilan -
biglake.tables.getdi setiap tabel Iceberg yang dirujuk oleh definisi tampilan baru
-
-
Menulis file metadata tampilan dalam mode kredensial pengguna akhir:
storage.objects.createdi 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
- Pelajari cara mendapatkan detail tampilan.
- Pelajari cara menghapus tampilan.