Kondisi kesalahan: SYNCED_TABLE_USER_ERROR

SQLSTATE: 42000

Kesalahan pengguna alur tabel yang disinkronkan.

ACCELERATED_SYNC_DATA_TOO_LARGE

Tabel <tableName> yang disinkronkan memiliki terlalu banyak nilai kolom besar untuk menggunakan sinkronisasi dipercepat.

Untuk tabel baru yang disinkronkan, nonaktifkan sinkronisasi dipercepat saat membuatnya dari UI.

Untuk tabel sinkronisasi yang sudah ada, hubungi dukungan Azure Databricks.

ACTIVE_ENDPOINTS_LIMIT

Contoh: <instance>. Proyek basis data telah melebihi batas endpoint aktif secara bersamaan, sehingga pipeline tabel yang disinkronkan tidak dapat terhubung. Detail: <detail>.

Untuk mengatasi masalah ini, kurangi jumlah endpoint aktif secara bersamaan, atau tingkatkan batas untuk proyek Anda.

ACTIVE_TIME_QUOTA_EXCEEDED

Contoh: <instance>. Proyek basis data telah melebihi kuota waktu aktifnya, sehingga pipeline tabel yang disinkronkan tidak dapat terhubung. Detail: <detail>.

Untuk mengatasi masalah ini, tingkatkan kuota waktu aktif untuk proyek Anda.

BRANCH_COMPUTE_TIME_EXCEEDED

Contoh: <instance>. Cabang basis data telah melebihi waktu komputasinya, sehingga pipeline tabel yang disinkronkan tidak dapat terhubung. Detail: <detail>.

Untuk mengatasi masalah ini, tingkatkan waktu komputasi yang tersedia untuk cabang ini.

KUNCI_UTAMA_DIALIHKAN

Kolom kunci utama yang ditentukan untuk tabel <destTableUcName> yang disinkronkan telah diubah.

Kolom kunci utama yang ditentukan: (<primaryKeyColumns>). Kolom kunci utama saat ini: (<existingPrimaryKeyColumns>).

Mengubah kolom kunci utama tabel yang disinkronkan setelah dibuat tidak didukung.

Untuk mengatasi masalah ini, ubah tabel yang disinkronkan kembali ke kolom kunci primer semula, atau buat tabel baru yang disinkronkan dan hapus tabel yang sudah ada.

TIPE_KOLOM_KUNCI_PRIMER_DIUBAH

Jenis data kolom kunci utama telah diubah pada tabel <modifiedPkColumns>yang disinkronkan <destTableUcName> .

Mengubah jenis data kolom kunci utama tidak didukung pada tabel yang disinkronkan setelah dibuat.

Untuk mengatasi masalah ini, buat tabel baru yang disinkronkan dan hapus tabel yang sudah ada.

KARAKTER_TIDAK_DALAM_REPERTOAR

Contoh: <instance>. Ditemukan urutan byte yang tidak valid dalam tabel Delta sumber.

Detil: <detail>

Biasanya ini menunjukkan bahwa tabel Delta sumber berisi karakter yang tidak

kompatibel dengan pengodean database target. Satu solusinya adalah mengonversi

tabel sumber untuk menggunakan BINARY TYPE, lalu buat tabel baru yang disinkronkan.

Perubahan Tipe Kolom Tidak Didukung

Contoh: <instance>. Mengubah tipe kolom saat ini tidak didukung.

Tabel Delta Sumber: <srcTableName>. Tabel tujuan yang disinkronkan: <destTableName>.

Kolom: <columnName>. Jenis yang ada: <existingType>. Jenis baru: <newType>.

Untuk mengatasi masalah ini, pertimbangkan salah satu opsi berikut:

  1. Lakukan refresh penuh tabel yang sudah disinkronkan.

  2. Buat tabel baru yang disinkronkan (yang akan mengadopsi jenis baru)

COMPUTE_TIME_QUOTA_EXCEEDED

Contoh: <instance>. Akun atau proyek database telah melebihi kuota waktu komputasinya, sehingga pipeline tabel yang disinkronkan tidak dapat terhubung. Detail: <detail>.

Untuk mengatasi masalah ini, tingkatkan kuota waktu komputasi untuk akun atau proyek Anda.

CONNECTION_ERROR

Contoh: <instance>. Kesalahan koneksi. Detail: <detail>.

Untuk mengatasi masalah ini, pastikan instans database berjalan, tidak dijeda atau dihentikan.

Mulai ulang alur untuk mencoba kembali.

DATABASE_TIDAK_ADA

Database <databaseName> tujuan tidak ada pada instans <instance> lakebase. Harap verifikasi apakah database tujuan ada.

DATABASE_ROLE_NOT_EXIST

Contoh: <instance>. Peran <roleName> Postgres yang menjadi dasar pipeline tabel tersinkronisasi tidak ada. Detail: <detail>.

Hal ini biasanya terjadi ketika peran dihapus dari instance database, misalnya setelah identitas dihapus dari workspace.

Untuk mengatasi masalah ini, buat ulang peran <roleName> Postgres pada instance database, atau hapus dan buat ulang tabel yang disinkronkan menggunakan identitas yang masih ada.

DATA_TRANSFER_QUOTA_EXCEEDED

Contoh: <instance>. Proyek basis data telah melebihi kuota transfer datanya, sehingga pipeline tabel yang disinkronkan tidak dapat terhubung. Detail: <detail>.

Untuk mengatasi masalah ini, tingkatkan kuota transfer data untuk proyek Anda.

DELTA_TRUNCATED_TRANSACTION_LOG

Detail: <detail>.

Ini menunjukkan log transaksi tabel delta telah dipotong karena penghapusan manual atau kebijakan penyimpanan log.

Untuk mengatasi masalah ini, lakukan refresh penuh tabel yang disinkronkan.

OBJEK_DEPENDEN_MASIH_ADA

Contoh: <instance>. Tidak dapat menghapus kolom karena ada data yang bergantung pada kolom tersebut.

Objek PostgreSQL masih mengacu pada kolom . Detail: <detail>.

Untuk mengatasi masalah ini, pertimbangkan salah satu opsi berikut:

  1. Tambahkan kembali kolom yang hilang ke tabel sumber dengan jenis data yang sama seperti sebelumnya.

  2. Jatuhkan objek dependen di PostgreSQL.

DESTINATION_NAME_NOT_A_TABLE

Contoh: <instance>. Tidak dapat membuat tabel <destTableUcName> yang disinkronkan karena nama tujuannya sudah digunakan oleh a <objectType> di database target.

Pipeline tabel yang disinkronkan tidak membuat atau mengelola objek ini.

Hapus atau ganti nama yang sudah ada <objectType>, atau buat tabel yang disinkronkan dengan nama berbeda, lalu coba ulang.

DESTINATION_SCHEMA_ACCESS_ERROR

Contoh: <instance>. Pipeline tabel yang disinkronkan tidak memiliki izin pada skema <schemaName>tujuan. Detail: <detail>.

Pipeline terhubung sebagai peran <databaseUser>Postgres , yang membutuhkan USAGE dan CREATE pada skema tujuan untuk membuat dan memelihara tabel target.

Untuk mengatasi masalah ini, jalankan: GRANT USAGE, CREATE ON SCHEMA <quotedSchemaName> TO <quotedDatabaseUser>; lalu restart pipeline.

KOLOM_KUNCI_PRI_MA_GANDA

Kolom <duplicatedPkColumns> ditentukan beberapa kali dalam kunci utama untuk tabel yang disinkronkan <destTableUcName>.

Untuk mengatasi masalah ini, hapus kolom duplikat dari kunci primer sehingga setiap kolom hanya muncul sekali.

ENDPOINT_DISABLED

Contoh: <instance>. Instance database target telah dinonaktifkan dan tidak dapat menerima koneksi. Detail: <detail>.

Hal ini biasanya terjadi ketika instance telah dihentikan. Instance yang dinonaktifkan tidak dapat dimulai dengan upaya koneksi.

Untuk mengatasi masalah ini, aktifkan kembali atau mulai instance database, lalu restart pipeline.

Jika instance dihentikan secara sengaja, jeda atau hapus tabel yang disinkronkan sebagai gantinya.

ENDPOINT_NOT_FOUND

Contoh: <instance>. Endpoint database target tidak dapat ditemukan atau tidak dapat diakses. Detail: <detail>.

Untuk mengatasi masalah ini, pastikan instance database ada dan tabel yang disinkronkan dikonfigurasi dengan instance yang benar.

Pelanggaran Batasan Kunci Asing

Contoh: <instance>. Pelanggaran batasan kunci asing saat menyinkronkan dari tabel sumber:

<srcTableName>. Detil: <detail>

Membuat batasan kunci asing yang mereferensikan tabel sinkronisasi tidak didukung. Tolong

hilangkan batasan kunci asing dan coba kembali sinkronisasi.

Ukuran Baris Indeks Terlampaui

Contoh: <instance>. Nilai kunci utama dalam tabel Delta sumber <srcTableName> terlalu besar untuk

Indeks B-tree PostgreSQL. PostgreSQL membatasi entri indeks hingga sekitar 2704 byte di semua kunci primer

kolom digabungkan. Detail: <detail>.

Untuk mengatasi masalah ini, kurangi ukuran data yang disimpan di kolom kunci utama, atau gunakan lebih sedikit atau

kolom kunci primer yang lebih pendek.

INSUFFICIENT_INSTANCE_SPACE

Tidak dapat melakukan sinkronisasi tabel <tableName> ke dalam instans <instance> karena ukuran database.

Penggunaan instans saat ini: <instanceSize> byte.

Estimasi ukuran tabel yang tidak dikompresi: <estimatedLoadSize> byte.

Batas ukuran instans: <maxInstanceSize> byte.

Kurangi jumlah data untuk disinkronkan, atau hapus beberapa tabel yang ada dalam instance untuk mengosongkan ruang.

INVALID_ENDPOINT

Contoh: <instance>. Instansi database menolak koneksi karena endpoint yang diminta tidak valid untuk operasi ini. Detail: <detail>.

Hal ini dapat terjadi ketika koneksi hanya-baca tidak diizinkan, atau komputasi yang diminta tidak ada.

Untuk mengatasi masalah ini, verifikasi konfigurasi instance target dan endpoint tabel yang disinkronkan, lalu restart pipeline.

INVALID_TABLE_NAME

Nama <tableName>tabel tidak valid : diharapkan nama tiga bagian (catalog.schema.table).

INVALID_TYPE_OVERRIDE

Contoh: <instance>. Penggantian tipe tidak valid untuk kolom <columnName>: <reason>.

INVALID_VECTOR_DATA

Data vektor tidak valid untuk kolom <columnName>: <reason>.

IP_NOT_ALLOWED

Contoh: <instance>. Alamat IP pipeline tabel yang disinkronkan tidak diperbolehkan terhubung ke instance database. Detail: <detail>.

Untuk mengatasi masalah ini, perbarui daftar izin IP instance database agar memungkinkan koneksi.

LOCK_TIMEOUT

Contoh: <instance>. Basis Data: <databaseName>. Alur tabel yang disinkronkan tidak dapat memperoleh kunci dalam batas waktu yang dikonfigurasi (<timeoutSeconds> detik).

Transaksi yang terdeteksi <numBlockingTransactions> sedang memegang kunci pada tabel target (dengan durasi penahanan kunci maksimum: <lockDurationSeconds> detik).

Transaksi pengguna menahan kunci yang memblokir alur tabel yang disinkronkan agar tidak memperbarui tabel target.

Untuk informasi selengkapnya tentang transaksi yang terlibat dalam kesalahan, periksa log driver Spark (cari '[LOCK TIMEOUT DIAGNOSTICS]').

Untuk mengatasi masalah ini, temukan koneksi dengan transaksi jangka panjang di instans postgres menggunakan pg_stat_activity, dan tutup transaksi tersebut (juga dapat menggunakan pg_terminate_backend untuk mengakhiri koneksi jika koneksi tidak diperlukan lagi).

Untuk mencegah masalah ini terjadi di masa mendatang, pertimbangkan opsi berikut:

  1. Pastikan aplikasi Anda menerapkan atau mengembalikan transaksi.

  2. Hindari transaksi yang berjalan lama. Atur auto_commit ke aktif jika pekerjaan dalam aplikasi tidak perlu terjadi dalam transaksi.

  3. Mengatur parameter idle_in_transaction_session_timeout di database untuk menghentikan transaksi menganggur secara otomatis.

Contoh: ALTER DATABASE <databaseName> SET idle_in_transaction_session_timeout = '5 menit';

LOGICAL_SIZE_QUOTA_EXCEEDED

Contoh: <instance>. Proyek basis data telah melebihi kuota ukuran logisnya, sehingga pipeline tabel yang disinkronkan tidak dapat terhubung. Detail: <detail>.

Untuk mengatasi masalah ini, tingkatkan kuota ukuran logis untuk proyek Anda atau kurangi jumlah data yang tersimpan.

MIS_CONFIGURED_PRIMARY_KEY (kunci utama dikonfigurasi tidak benar)

Kunci primer yang disediakan untuk tabel Delta sumber: <srcTableName> tidak tersedia dalam tabel sumber.

Kunci primer: <primaryKeys>. Kolom yang tersedia: <availableColumns>. Kunci primer hilang: <missingPkColumns>.

Untuk mengatasi masalah ini, pertimbangkan salah satu opsi berikut:

  1. Tambahkan kolom yang hilang ke tabel sumber.

  2. Buat tabel baru yang disinkronkan dengan konfigurasi kunci utama yang benar.

NATIVE_LOGIN_BLOCKED

Contoh: <instance>. Login native (kata sandi) dinonaktifkan untuk peran database yang digunakan oleh pipeline tabel yang disinkronkan. Detail: <detail>.

Untuk mengatasi masalah ini, aktifkan login native untuk peran database pipeline, atau konfigurasikan ulang peran tersebut agar menggunakan metode autentikasi yang didukung.

NETWORK_BLOCKED

Contoh: <instance>. Pipeline tabel yang disinkronkan tidak diizinkan untuk terhubung ke instance database dari jaringannya. Detail: <detail>.

Untuk mengatasi masalah ini, perbarui konfigurasi akses jaringan instance database agar memungkinkan koneksi.

PERMISSION_DENIED

Detail: <detail>.

Harap verifikasi apakah Anda memiliki izin yang memadai.

PIPELINE_ROLE_NOT_EXIST

Contoh: <instance>. Peran penulis database untuk alur tabel yang disinkronkan hilang. Detail: <detail>.

Ini biasanya terjadi ketika database tujuan telah dihapus, yang menghapus peran penulis dari pipeline.

Untuk mengatasi masalah ini, verifikasi bahwa database tujuan ada dan belum dihilangkan.

Jika database sengaja dihilangkan, hapus tabel yang disinkronkan dan buat ulang setelah membuat ulang database.

PRIMARY_KEY_CONSTRAINT_VIOLATION

Contoh: <instance>. Baris duplikat terdeteksi berdasarkan kunci primer. Detil: <detail>

Ini kemungkinan menunjukkan kesalahan konfigurasi kolom kunci utama.

Harap verifikasi bahwa Anda menggunakan sekumpulan kunci primer yang benar

dari tabel Delta sumber: <srcTableName>.

Untuk mengatasi masalah ini, buat tabel baru yang disinkronkan dengan benar

konfigurasi kunci utama.

QUOTA_EXCEEDED

Contoh: <instance>. Akun atau proyek basis data target telah melebihi kuotanya. Detail: <detail>.

Untuk mengatasi masalah ini, kurangi penggunaan atau tingkatkan rencana untuk meningkatkan kuota, lalu restart pipeline.

REFRESH_WITH_FOREIGN_KEY

Contoh: <instance>. Gagal menyegarkan tabel <destTableName> yang disinkronkan karena tabel

<childTableName> memiliki batasan kunci asing yang mereferensikan tabel yang disinkronkan.

Penyegaran tabel yang disinkronkan tidak didukung ketika terdapat kendala kunci asing.

mereferensikannya. Silakan hilangkan batasan kunci asing dan coba kembali refresh.

REQUIRED_EXTENSION_NOT_INSTALLED

Contoh: <instance>. Ekstensi PostgreSQL yang diperlukan '<extension>' belum terpasang. Instal di instance Lakebase sebelum membuat sinkronisasi ini.

SCHEMA_BUILDER_NOT_ENABLED

Kustomisasi skema tabel yang disinkronkan (<features>) tidak diaktifkan untuk workspace ini.

SKEMA_TIDAK_ADA

Detail: <detail>.

Harap verifikasi apakah skema ada di Katalog Unity.

KESALAHAN_MEMBACA_SUMBER

Gagal membaca dari tabel sumber <tableName>. Harap verifikasi apakah tabel sumber dapat berhasil dibaca melalui SELECT kueri.

Detil: <detail>

SOURCE_SMART_CLONE_REQUIRED

Tampilan <srcTableName> materialisasi sumber memerlukan SmartClone diaktifkan sebelum dapat digunakan sebagai sumber tabel yang disinkronkan. Lari REPAIR TABLE <srcTableName> SYNC METADATA dan coba lagi.

SPARK_JOB_CANCELLED

Pekerjaan Spark dibatalkan.

Detil: <detail>

KONFLIK_NAMA_KOLOM_SISTEM

Contoh: <instance>. Tabel Delta <srcTableName> sumber berisi kolom yang namanya bertentangan dengan nama kolom sistem PostgreSQL. Detail: <detail>.

PostgreSQL mencadangkan nama kolom tertentu (seperti xmin, xmax, ctid, cmin, cmax, tableoid) untuk penggunaan internal.

Untuk mengatasi masalah ini, ganti nama kolom yang berkonflik dalam tabel Delta sumber dan buat ulang tabel yang disinkronkan.

Atau buat tampilan dengan kolom yang berkonflik dikecualikan dan sinkronkan tampilan sebagai gantinya.

Kesalahan_Akses_Schema_Sistem

Contoh: <instance>. Skema sistem internal (__db_system) tidak dapat diakses oleh alur tabel yang disinkronkan. Detail: <detail>.

Ini dapat terjadi ketika database direset atau skema internal dihilangkan dan dibuat ulang tanpa izin yang tepat.

Untuk mengatasi masalah ini, hilangkan dan buat ulang tabel <destTableUcName>yang disinkronkan .

TABEL_TIDAK_ADA

Detail: <detail>.

Harap verifikasi apakah tabel yang disinkronkan ada di Katalog Unity.

TARGET_DATABASE_FULL

Ruang database <databaseName> target penuh. Tidak dapat terus mencerna.

TERLALU_BANYAK_KONEKSI

Terlalu banyak koneksi terbuka ke instans database: <instance>

Detail: <detail>.

Setiap sinkronisasi tabel dapat menggunakan hingga 16 koneksi ke instans database, yang akan dihitung ke batas koneksi instans.

Untuk mengatasi masalah ini, coba opsi berikut:

  1. Kurangkan jumlah pipeline bersamaan yang menulis ke instans database yang sama.

Misalnya, mengatur jadwal pipeline.

  1. Kurangi jumlah koneksi bersamaan dari beban kerja lain yang terhubung ke instans database yang sama.

TIPE_KOLOM_TIDAK_DIDUKUNG

Contoh: <instance>. Tipe kolom PostgreSQL yang tidak didukung: <columnType>.

UNTRANSLATABLE_CHARACTER

Contoh: <instance>. Ditemukan karakter yang tidak dapat diterjemahkan dalam tabel Delta sumber.

Detil: <detail>

Biasanya ini menunjukkan bahwa tabel Delta sumber berisi karakter yang tidak

kompatibel dengan pengodean database target. Satu solusinya adalah mengonversi

tabel sumber untuk menggunakan BINARY TYPE, lalu buat tabel baru yang disinkronkan.

VPC_ENDPOINT_NOT_ALLOWED

Contoh: <instance>. Endpoint VPC pipeline tabel yang disinkronkan tidak diizinkan untuk terhubung ke instance database. Detail: <detail>.

Untuk mengatasi masalah ini, tambahkan endpoint VPC ke daftar yang diizinkan pada instance database.

WRITTEN_DATA_QUOTA_EXCEEDED

Contoh: <instance>. Proyek basis data telah melebihi kuota data tertulisnya, sehingga pipeline tabel yang disinkronkan tidak dapat terhubung. Detail: <detail>.

Untuk mengatasi masalah ini, tingkatkan kuota data tertulis untuk proyek Anda.