Membuat kueri tampilan

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

  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

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:

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.get pada tampilan dan tampilan bertingkat apa pun
    • biglake.tables.get di setiap tabel Iceberg yang dirujuk oleh tampilan
  • Membaca data tabel dalam mode penjualan kredensial: biglake.tables.getData di setiap tabel Iceberg yang direferensikan tampilan
  • Membaca metadata tampilan dan data tabel dalam mode kredensial pengguna akhir: storage.objects.get 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.

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