Memecahkan masalah tampilan Apache Iceberg

Saat membuat, mengkueri, mengubah, atau menghapus tampilan Apache Iceberg di katalog runtime Lakehouse, Anda mungkin mengalami error seperti konflik nama dengan tabel, penolakan akses, perjalanan waktu pada tampilan, snapshot yang sudah tidak berlaku, jenis katalog yang tidak didukung, atau lokasi tampilan yang tidak dapat diubah. Dokumen ini membantu Anda mengidentifikasi penyebab error umum ini dan menyelesaikannya. Untuk masalah katalog umum, lihat Pemecahan masalah.

409 Conflict atau AlreadyExistsException saat membuat atau mengganti tampilan atau tabel

Tabel dan tampilan memiliki namespace ID yang sama dalam namespace katalog, dan katalog memblokir penimpaan lintas jenis. Anda tidak dapat membuat tampilan dengan nama yang sama seperti tabel yang ada, atau tabel dengan nama yang sama seperti tampilan yang ada.

Untuk menemukan tabrakan nama, cantumkan tabel dan tampilan di namespace:

SHOW TABLES IN NAMESPACE_NAME;
SHOW VIEWS IN NAMESPACE_NAME;

Pilih nama lain, atau hapus objek yang bertentangan terlebih dahulu.

403 Forbidden atau AccessDeniedException pada operasi tampilan

Karena Compute Engine Anda mengevaluasi tampilan di sisi klien, membuat kueri tampilan memerlukan izin pada tampilan dan pada setiap tabel yang dirujuk oleh tampilan. Pastikan hal berikut:

  • Untuk DDL tampilan, pemanggil memiliki BigLake Editor (roles/biglake.editor) atau BigLake Admin (roles/biglake.admin).
  • Untuk kueri SELECT, pemanggil memiliki BigLake Viewer (roles/biglake.viewer), yang memberikan biglake.views.get pada tampilan dan biglake.tables.get serta biglake.tables.getData pada tabel yang direferensikan.
  • Dalam mode kredensial pengguna akhir, pemanggil memiliki Storage Object User (roles/storage.objectUser) di bucket Cloud Storage untuk DDL tampilan, atau Storage Object Viewer (roles/storage.objectViewer) untuk kueri hanya baca.
  • Dalam mode penjualan kredensial, akun layanan katalog memiliki Storage Object User (roles/storage.objectUser) di bucket Cloud Storage, dan Spark dikonfigurasi dengan spark.sql.catalog.CATALOG_NAME.header.X-Iceberg-Access-Delegation=vended-credentials.

Untuk mengetahui informasi selengkapnya, lihat Peran dan izin yang diperlukan.

UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW

Spark menampilkan AnalysisException: [UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW] Cannot time travel on view saat kueri menerapkan TIMESTAMP AS OF atau VERSION AS OF langsung ke ID tampilan.

Hapus klausa perjalanan waktu dari kueri. Jika Anda memerlukan data historis, tentukan tampilan yang definisi SQL-nya menerapkan TIMESTAMP AS OF ke tabel pokok, atau gunakan CTE yang mengkueri tabel pokok secara langsung. Untuk mengetahui informasi selengkapnya, lihat Membuat tampilan dengan perjalanan waktu pada tabel pokok.

ValidationException: Cannot find snapshot older than timestamp

Tabel virtual yang ditentukan dengan klausa perjalanan waktu mereferensikan snapshot yang telah berakhir masa berlakunya atau dihapus dari tabel pokok.

Ganti tampilan dengan CREATE OR REPLACE VIEW menggunakan stempel waktu atau ID snapshot yang lebih baru, atau sesuaikan setelan retensi snapshot pada tabel Iceberg yang mendasarinya.

409 Conflict: Namespace is not empty saat menghapus namespace

Anda tidak dapat menghapus namespace yang masih berisi tampilan. Cantumkan dan hapus tampilan yang tersisa, lalu hapus namespace:

SHOW VIEWS IN NAMESPACE_NAME;
DROP VIEW IF EXISTS NAMESPACE_NAME.VIEW_NAME;

400 Bad Request dengan FAILED_PRECONDITION pada operasi tampilan

Tampilan Iceberg hanya didukung di katalog multi-bucket dan katalog single-bucket. Katalog menolak operasi tampilan pada katalog BigQuery atau katalog gabungan. Buat tampilan dalam jenis katalog yang didukung.

400 Bad Request: View location is immutable

Anda tidak dapat mengubah lokasi penyimpanan tampilan setelah membuat tampilan. Hapus pembaruan lokasi dari permintaan Anda.

Di Trino 481 dan yang lebih lama, CREATE OR REPLACE VIEW mengirimkan pembaruan lokasi yang memicu error ini. Upgrade ke Trino 482 atau yang lebih baru, atau jalankan DROP VIEW diikuti dengan CREATE VIEW untuk memperbarui definisi tampilan. Untuk mengetahui informasi selengkapnya, lihat Dukungan Trino.

Langkah berikutnya