Memecahkan masalah umum Lakehouse untuk Apache Iceberg

Halaman ini menunjukkan cara mengatasi masalah umum terkait Lakehouse for Apache Iceberg dan resource terkait.

Tidak dapat membuat tampilan di atas tabel endpoint katalog REST Lakehouse Apache Iceberg

Masalah ini terjadi saat Anda mencoba membuat tampilan di BigQuery di atas tabel Lakehouse Iceberg REST catalog yang dikelola oleh endpoint Iceberg REST catalog.

Pembuatan tampilan di atas tabel ini tidak didukung.

Tidak dapat mengkueri tabel metadata

Masalah ini terjadi saat Anda mengkueri tabel metadata, seperti .snapshots atau .files, untuk tabel Apache Iceberg yang didukung oleh katalog runtime Lakehouse di BigQuery menggunakan ID nama lima bagian.

Untuk mengatasi masalah ini, kueri tabel ini menggunakan Apache Spark.

Batas ukuran file metadata.json

Ukuran file metadata.json Apache Iceberg dibatasi hingga 1 MB. Batas ini berlaku untuk file metadata yang melacak snapshot tabel, skema, dan spesifikasi partisi. Jika file metadata Anda melebihi ukuran ini, Anda mungkin mengalami error saat melakukan operasi tabel melalui endpoint katalog REST Apache Iceberg.

Untuk mengatasi masalah ini, minta peningkatan batas dengan menghubungi tim akun Google Anda.

Error NOT_FOUND saat mengkueri katalog multi-region

Masalah ini terjadi saat Anda membuat katalog di Lakehouse runtime catalog menggunakan bucket Cloud Storage multi-region tanpa menentukan lokasi utama, lalu mencoba mengkueri katalog dengan menentukan region virtual BigQuery (seperti US atau EU).

Saat katalog dibuat dengan bucket multi-region, metadatanya disimpan di lokasi regional tertentu dalam cakupan geografis multi-region, bukan di region virtual BigQuery yang sesuai. Jika Anda memaksa kueri untuk berjalan di region virtual tempat metadata tidak ada, kueri akan gagal dengan error NOT_FOUND.

Untuk mengatasi masalah ini, tentukan lokasi utama (misalnya, US atau EU) saat Anda membuat katalog. Untuk mengetahui informasi selengkapnya, lihat Menentukan region utama untuk multi-region AS dan Uni Eropa.