Mendapatkan detail tabel

Melihat detail tabel akan menampilkan skema dasar, properti tabel, dan metadata konfigurasi untuk tabel Apache Iceberg di katalog runtime Lakehouse.

Dalam mode penyediaan kredensial, mesin kueri juga mengambil kredensial akses jangka pendek untuk berinteraksi dengan aman dengan file Cloud Storage yang mendasarinya tanpa memerlukan izin penyimpanan IAM langsung.

Anda dapat memeriksa detail tabel menggunakan konsol Google Cloud , perintah deskripsi SQL di Spark dan Trino, atau spesifikasi Iceberg REST Catalog API open source.

Sebelum memulai

Lihat ringkasan tabel untuk memahami berbagai jenis tabel dan implikasi penggunaannya.

  1. Pastikan penagihan diaktifkan untuk Google Cloud project Anda.

  2. Aktifkan BigLake API.

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

    Mengaktifkan API

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk melihat detail 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.

Mendapatkan detail tabel

Periksa skema dan properti tabel.

Konsol

  1. Di Google Cloud konsol, buka Lakehouse.

    Buka Lakehouse

  2. Pilih katalog yang ada atau buat katalog jika Anda belum memilikinya.

  3. Di tabel Namespace details, klik nama tabel yang ingin Anda periksa.

  4. Di halaman Table details, pelajari skema, spesifikasi partisi, dan properti metadata tabel.

Spark 

spark.sql("DESCRIBE EXTENDED NAMESPACE_NAME.TABLE_NAME").show()

Trino 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

REST

Untuk mengambil metadata tabel menggunakan REST API, buat permintaan GET ke endpoint GetIcebergTable:

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME

Untuk memuat kredensial tabel jangka pendek dalam mode penyediaan kredensial, buat permintaan GET ke endpoint LoadIcebergTableCredentials:

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME/credentials

Ganti kode berikut:

  • PROJECT_ID: Project ID Google Cloud Anda.
  • CATALOG_ID: ID katalog runtime Lakehouse Anda.
  • NAMESPACE_NAME: nama namespace katalog Anda.
  • TABLE_NAME: nama tabel Iceberg Anda.

Langkah berikutnya