Dengan mengkueri tampilan Apache Iceberg, Anda dapat membaca hasil yang diseleksi dan tanpa salinan dari tabel Iceberg yang mendasarinya dengan menjalankan definisi SQL yang disimpan di katalog runtime Lakehouse. Compute Engine Anda memuat definisi tampilan dari katalog, me-resolve setiap tabel dan tampilan bertingkat yang direferensikan, lalu membaca file data di Cloud Storage.
Anda hanya dapat mengkueri tampilan Iceberg dari mesin open source yang kompatibel dengan Iceberg seperti Spark dan Trino. BigQuery tidak mendukung kueri tampilan Iceberg.
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
Karena Compute Engine Anda mengevaluasi tampilan di sisi klien, Anda memerlukan izin pada tampilan dan pada setiap tabel serta tampilan bertingkat yang dirujuk oleh tampilan tersebut.
Untuk mendapatkan izin yang Anda perlukan untuk mengkueri tampilan, minta administrator untuk memberi Anda peran IAM berikut pada project dan bucket penyimpanan Anda:
-
Membaca tabel tampilan dan tabel yang direferensikan dalam mode penyediaan kredensial: BigLake Viewer (
roles/biglake.viewer) - project Anda -
Baca tabel tampilan dan tabel yang direferensikan dalam mode kredensial pengguna akhir:
- BigLake Viewer (
roles/biglake.viewer) - project Anda - Storage Object Viewer (
roles/storage.objectViewer) - bucket Cloud Storage
- BigLake Viewer (
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 membuat kueri tampilan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat kueri tabel virtual:
-
Membuat kueri tampilan:
-
biglake.views.getpada tampilan dan tampilan bertingkat apa pun -
biglake.tables.getdi setiap tabel Iceberg yang dirujuk oleh tampilan
-
-
Membaca data tabel dalam mode penjualan kredensial:
biglake.tables.getDatadi setiap tabel Iceberg yang direferensikan tampilan -
Membaca metadata tampilan dan data tabel dalam mode kredensial pengguna akhir:
storage.objects.getdi 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.
Membuat kueri tampilan
Memilih semua data dari tabel virtual:
Spark
SELECT * FROM NAMESPACE_NAME.VIEW_NAME;
Ganti kode berikut:
NAMESPACE_NAME: nama namespace Anda.VIEW_NAME: nama tabel virtual Anda.
Anda dapat membuat kueri tampilan yang berisi gabungan, agregasi, CTE, dan tampilan bertingkat dengan cara yang sama. Misalnya, kueri berikut menggunakan tampilan dari Membuat tampilan:
SELECT * FROM my_ns.eng_employees ORDER BY emp_id;
SELECT * FROM my_ns.employee_directory ORDER BY id;
SELECT * FROM my_ns.top_eng_employees;
Perjalanan waktu dan tampilan
Anda tidak dapat menerapkan klausa perjalanan waktu seperti TIMESTAMP AS OF atau
VERSION AS OF langsung ke ID tampilan. Jika Anda memerlukan data historis,
tentukan tampilan yang definisi SQL-nya menerapkan perjalanan waktu ke tabel pokok,
atau gunakan CTE yang mengkueri tabel pokok secara langsung. Untuk mengetahui informasi selengkapnya,
lihat Membuat tampilan dengan perjalanan waktu pada tabel
yang mendasarinya.
Langkah berikutnya
- Pelajari cara mendapatkan detail tampilan.
- Pelajari cara memecahkan masalah tampilan Iceberg.