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 Google Cloud konsol, perintah DESCRIBE SQL di Spark dan Trino, atau REST API.

Sebelum memulai

1. Pastikan penagihan diaktifkan untuk Google Cloud project Anda.

2. Aktifkan BigLake API.

   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 Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

   Mengaktifkan API

3. Siapkan katalog runtime Lakehouse dengan endpoint katalog REST Apache Iceberg.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk melihat detail tabel, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

• Melihat detail tabel: 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.

Kemampuan dan dukungan tabel

Saat menggunakan tabel di katalog runtime Lakehouse, sebaiknya pahami berbagai jenis tabel dan kemampuan keikutsertaannya. Untuk mempelajari lebih lanjut penggunaan tabel Apache Iceberg secara khusus, lihat Ringkasan tabel Apache Iceberg tabel.

Tabel Iceberg yang didukung

Hanya tabel Apache Iceberg V2 (GA) dan V3 (Pratinjau) yang didukung. Tabel Iceberg V1 tidak didukung. Untuk mengupgrade tabel V1 yang ada, lihat Mengupgrade Iceberg tabel V1 ke V2.

Mendapatkan detail tabel

Periksa skema dan properti tabel.

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

TBLPROPERTIES (
  'gcp.biglake.bigquery-dml.enabled' = true,
  'gcp.biglake.table-management.enabled' = true
)

DESCRIBE SCHEMA_NAME.TABLE_NAME;

WITH (
  "gcp.biglake.bigquery-dml.enabled" = 'true',
  "gcp.biglake.table-management.enabled" = 'true'
)

gcloud biglake iceberg tables describe TABLE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID" \
    --namespace="NAMESPACE_NAME"

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

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

Langkah berikutnya

• Pelajari cara membuat kueri tabel.
• Pelajari cara mengubah tabel.