Anda dapat memeriksa skema, komentar kolom, properti, dan definisi SQL dari tampilan Apache Iceberg yang terdaftar di katalog runtime Lakehouse menggunakan Spark atau endpoint katalog REST Apache 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
Untuk mendapatkan izin yang diperlukan untuk melihat detail, minta administrator untuk memberi Anda peran IAM berikut pada project dan bucket penyimpanan Anda:
-
Mendapatkan detail tampilan:
BigLake Viewer (
roles/biglake.viewer) - project Anda -
Membaca file metadata tampilan dalam mode kredensial pengguna akhir:
Storage Object Viewer (
roles/storage.objectViewer) - bucket Cloud Storage
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk mendapatkan detail tampilan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mendapatkan detail tampilan:
-
Mendapatkan detail tabel virtual:
biglake.views.getpada tabel virtual -
Membaca file metadata tampilan 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.
Mendapatkan detail tampilan
Memeriksa tampilan.
Spark
Tampilkan skema tampilan, komentar kolom, dan properti tampilan:
DESCRIBE EXTENDED NAMESPACE_NAME.VIEW_NAME;
Tampilkan pernyataan SQL yang menentukan tampilan:
SHOW CREATE TABLE NAMESPACE_NAME.VIEW_NAME;
Hanya menampilkan properti tampilan:
SHOW TBLPROPERTIES NAMESPACE_NAME.VIEW_NAME;
Ganti kode berikut:
NAMESPACE_NAME: nama namespace Anda.VIEW_NAME: nama tabel virtual Anda.
REST
Untuk memuat metadata tampilan saat ini menggunakan REST API, buat permintaan GET ke endpoint GetIcebergView:
GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME
Responsnya berisi metadata-location dan metadata tampilan.
Untuk memeriksa apakah tampilan ada tanpa memuat metadatanya, buat permintaan HEAD ke jalur yang sama. Endpoint CheckIcebergViewExists menampilkan
204 No Content jika tampilan ada, atau 404 Not Found jika tidak ada.
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.
Langkah berikutnya
- Pelajari cara membuat kueri tampilan.
- Pelajari cara mengubah tampilan.