Mencantumkan tabel memungkinkan Anda melihat semua entity tabel terdaftar dalam namespace di katalog runtime Lakehouse.
Mesin kueri dapat mencantumkan tabel menggunakan perintah SQL standar, dan klien REST dapat mengambil ID tabel langsung melalui spesifikasi Iceberg REST Catalog API open source (GET /v1/{prefix}/namespaces/{namespace}/tables).
Sebelum memulai
Lihat ringkasan tabel untuk memahami berbagai jenis tabel dan implikasi penggunaannya.
-
Pastikan penagihan diaktifkan untuk Google Cloud project Anda.
-
Aktifkan BigLake API.
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (
roles/serviceusage.serviceUsageAdmin), yang berisi izinserviceusage.services.enable. Pelajari cara memberikan peran.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk mencantumkan tabel, minta administrator Anda untuk memberi Anda peran IAM berikut di project Anda:
-
Semua:
BigLake Viewer (
roles/biglake.viewer) - project Anda
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Mencantumkan tabel
Mencantumkan tabel.
Konsol
Di Google Cloud konsol, buka Lakehouse.
Pilih katalog yang ada atau buat katalog jika Anda belum memilikinya.
Tabel Anda akan muncul di halaman Namespace details.
Spark
spark.sql("SHOW TABLES").show()
Trino
SHOW TABLES;
REST
Untuk mencantumkan ID tabel dalam namespace menggunakan REST API, buat permintaan GET ke endpoint ListIcebergTableIdentifiers:
GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables
Responsnya berisi array JSON ID tabel yang terdaftar di namespace yang ditentukan.
Ganti kode berikut:
PROJECT_ID: ID project Anda Google Cloud .CATALOG_ID: ID katalog runtime Lakehouse Anda.NAMESPACE_NAME: nama namespace katalog Anda.
Langkah berikutnya
- Pelajari cara mendapatkan detail tabel.
- Pelajari cara membuat kueri tabel.