All Products
Search

This Product

    PolarDB:Kode Kesalahan

    Document Center

    PolarDB:Kode Kesalahan

    Last Updated:Apr 24, 2026

    Topik ini menjelaskan kode kesalahan umum PolarDB-X dan solusinya.

    TDDL-1305 ERR_UNKNOWN_SAVEPOINT

    • Deskripsi: Titik simpan yang ditentukan tidak ada.

    • Contoh: ERR-CODE: [TDDL-1305][ERR_UNKNOWN_SAVEPOINT] SAVEPOINT ***** does not exist

    • Di PolarDB-X, kesalahan ini terjadi ketika Anda mengeksekusi pernyataan ROLLBACK TO SAVEPOINT atau RELEASE SAVEPOINT untuk titik simpan yang tidak ada.

      Pastikan nama titik simpan yang Anda gunakan sesuai dengan yang dikembalikan oleh pernyataan titik simpan.

    TDDL-1094 ERR_UNKNOWN_THREAD_ID

    • Deskripsi: ID session yang ditentukan dalam perintah KILL tidak ada.

    • Contoh: ERR-CODE: [TDDL-1094][ERR_UNKNOWN_THREAD_ID] Unknown thread id: *****

    • Kesalahan ini terjadi ketika Anda mengeksekusi perintah KILL pada PolarDB-X untuk menghentikan pernyataan SQL, tetapi ID session yang ditentukan tidak ada atau pernyataan SQL tersebut telah selesai.

      Jalankan SHOW PROCESSLIST untuk mendapatkan ID session dari pernyataan SQL yang sedang berjalan, lalu gunakan KILL hanya pada ID yang dikembalikan oleh perintah tersebut.

    TDDL-4006 ERR_TABLE_NOT_EXIST

    • Deskripsi: Tabel data PolarDB-X tidak ada.

    • Contoh: ERR-CODE: [TDDL-4006][ERR_TABLE_NOT_EXIST] Table '*****' doesn't exist.

    • Kode kesalahan ini menunjukkan bahwa tabel data PolarDB-X tidak ada, atau karena alasan yang tidak diketahui, PolarDB-X tidak dapat memuat metadata untuk tabel data tersebut.

    TDDL-4007 ERR_CANNOT_FETCH_TABLE_META

    • Deskripsi: Kesalahan ini terjadi ketika PolarDB-X gagal memuat metadata tabel.

    • Contoh: ERR-CODE: [TDDL-4007][ERR_CANNOT_FETCH_TABLE_META] Table '*****' metadata cannot be fetched because Table '*****.*****' doesn't exist.

    • Kesalahan ini terjadi ketika PolarDB-X gagal membaca metadata tabel. Kemungkinan penyebabnya meliputi:

      • Tabel belum dibuat.

      • Metadata di metadatabase tidak konsisten.

      • Tabel telah dihapus atau diganti namanya.

      Jika kesalahan ini terjadi, pertama-tama periksa apakah tabel tersebut ada. Atau, jalankan perintah CHECK TABLE untuk memverifikasi konsistensi metadatabase PolarDB-X. Jika tabel dihapus atau diganti namanya secara manual, gunakan fitur pemulihan data PolarDB-X. Jika masalah berlanjut, hubungi dukungan teknis.

    TDDL-4018 ERR_INVALID_DDL_PARAMS

    • Deskripsi: PolarDB-X gagal mengeksekusi operasi DDL.

    • Contoh: ERR-CODE: [TDDL-4018][ERR_INVALID_DDL_PARAMS] invalid '*****'.

    • Kesalahan ini terjadi ketika pernyataan DDL berisi parameter yang tidak valid. Verifikasi bahwa semua parameter sudah benar. Jika kesalahan berlanjut, hubungi dukungan teknis.

    TDDL-4100 ERR_ATOM_NOT_AVALILABLE

    • Deskripsi: Node data backend PolarDB-X sementara tidak tersedia.

    • Contoh: ERR-CODE: [TDDL-4100][ERR_ATOM_NOT_AVALILABLE] Atom : ***** isNotAvailable

    • Jika PolarDB-X mendeteksi node data backend yang tidak normal, sistem akan sementara memblokir akses ke instans tersebut dan mengembalikan kesalahan ini.

      Jika Anda mengalami kesalahan ini, periksa status semua node data backend PolarDB-X. Ketika node data pulih, PolarDB-X secara otomatis memulihkan ketersediaannya dan memungkinkan aplikasi melanjutkan akses normal.

    TDDL-4101 ERR_ATOM_GET_CONNECTION_FAILED_UNKNOWN_REASON

    • Deskripsi: Node komputasi PolarDB-X tidak dapat terhubung ke node data.

    • Contoh: ERR-CODE: [TDDL-4101][ERR_ATOM_GET_CONNECTION_FAILED_UNKNOWN_REASON] Get connection for db '*****' from pool failed. AppName:*****, Env:*****, UnitName:null. Message from pool: wait millis 5000, active 0, maxActive 5. Anda harus mencari log berikut yang berisi alasan sebenarnya.

    • Saat PolarDB-X memproses permintaan, sistem membuat koneksi ke node data secara asinkron. Jika koneksi tidak terbentuk dalam periode timeout dan tugas asinkron tidak mengembalikan kesalahan spesifik, PolarDB-X mengembalikan kesalahan TDDL-4101 ke aplikasi.

      Eksepsi pada node data backend biasanya menyebabkan kesalahan ini. Jika kesalahan berlanjut setelah Anda melakukan troubleshooting pada node data, hubungi dukungan teknis.

    TDDL-4102 ERR_ATOM_GET_CONNECTION_FAILED_KNOWN_REASON

    • Deskripsi: Kegagalan mendapatkan koneksi backend di PolarDB-X karena alasan yang diketahui.

    • Contoh: ERR-CODE: [TDDL-4102][ERR_ATOM_GET_CONNECTION_FAILED_KNOWN_REASON] Get connection for db '*****' failed because wait millis 5000, active 0, maxActive 5

    • Node komputasi PolarDB-X gagal mendapatkan koneksi ke node data. Alasan kegagalannya disediakan dalam pesan ERR-CODE. Alasan umum kegagalan koneksi ke node data PolarDB-X adalah sebagai berikut:

      • Node data backend telah mencapai jumlah maksimum koneksi.

      • Koneksi dari node komputasi ke node data mengalami timeout.

      • Node data menolak koneksi.

      Jika kesalahan berlanjut setelah menyingkirkan masalah pada node data backend, hubungi dukungan teknis.

    TDDL-4103 ERR_ATOM_CONNECTION_POOL_FULL

    • Deskripsi: Kolam koneksi untuk node data backend PolarDB-X penuh.

    • Contoh: ERR-CODE: [TDDL-4103][ERR_ATOM_CONNECTION_POOL_FULL] Pool of DB '*****' is full. Message from pool: wait millis 5000, active 5, maxActive 5. AppName:*****, Env:*****, UnitName:null.

    • Kesalahan ini terjadi ketika kolam koneksi backend untuk PolarDB-X penuh. Penyebab umum kesalahan ini meliputi:

      • Pernyataan SQL yang berjalan lambat dari aplikasi memegang koneksi dalam waktu lama, menyebabkan kekurangan koneksi yang tersedia.

      • Terjadi kebocoran koneksi ketika aplikasi tidak menutup koneksi database dengan benar.

      • Banyak kueri lintas database secara konkuren, seperti kueri agregasi atau kueri tanpa kondisi kunci sharding, mengonsumsi banyak koneksi.

      Untuk mengatasi masalah ini, coba solusi berikut:

      • Gunakan framework, seperti Spring JDBC atau MyBatis, untuk mengakses database.

      • Optimalkan pernyataan SQL berdasarkan laporan analisis kinerja dan rekomendasi dari administrator basis data.

      • Gunakan fitur Pemisahan baca/tulis PolarDB-X untuk meneruskan kueri lintas database ke node read-only.

      • Upgrade instans PolarDB-X Anda ke spesifikasi yang lebih tinggi untuk meningkatkan kapasitas pemrosesan backend.

      • Hubungi dukungan teknis untuk menyesuaikan jumlah koneksi pada backend PolarDB-X.

    TDDL-4104 ERR_ATOM_CREATE_CONNECTION_TOO_SLOW

    • Deskripsi: Pembuatan koneksi ke node data PolarDB-X terlalu lambat.

    • Contoh: ERR-CODE: [TDDL-4104][ERR_ATOM_CREATE_CONNECTION_TOO_SLOW] Get connection for db '*****' from pool timeout. AppName:*****, Env:*****, UnitName:null. Message from pool: wait millis 5000, active 3, maxActive 5.

    • PolarDB-X membuat koneksi ke node datanya secara asinkron. Proses ini dapat mengalami timeout jika terlalu banyak koneksi diminta terlalu cepat atau jika node data lambat menerima koneksi tersebut. Masalah ini biasanya disebabkan oleh beban berlebih atau eksepsi pada node data. Untuk mengurangi beban backend, gunakan fitur Pemisahan baca/tulis PolarDB-X atau upgrade instans Anda ke spesifikasi yang lebih tinggi.

      Jika kesalahan berlanjut setelah menyingkirkan masalah pada node data, hubungi dukungan teknis. Jika masalah disebabkan oleh pembuatan terlalu banyak koneksi terlalu cepat, hubungi dukungan teknis untuk menyesuaikan jumlah minimum koneksi untuk PolarDB-X.

    TDDL-4105 ERR_ATOM_ACCESS_DENIED

    • Deskripsi: Node data backend PolarDB-X menolak permintaan koneksi.

    • Contoh: ERR-CODE: [TDDL-4105][ERR_ATOM_ACCESS_DENIED] DB '*****' Access denied for user '*****'@'*****'. AppName:*****, Env:*****, UnitName:null. Please contact DBA to check.

    • Kesalahan ini menunjukkan bahwa PolarDB-X gagal terhubung ke node data karena username dan password yang ditentukan tidak memiliki otorisasi. Untuk mengatasi masalah ini, hubungi dukungan teknis.

    TDDL-4106 ERR_ATOM_DB_DOWN

    • Deskripsi: Kesalahan ini menunjukkan bahwa PolarDB-X tidak dapat terhubung ke node data backend.

    • Contoh: ERR-CODE: [TDDL-4106][ERR_ATOM_DB_DOWN] DB '*****' cannot be connected. AppName:*****, Env:*****, UnitName:null. It seems a very real possibility that this DB IS DOWN. Please contact DBA to check.

    • Kesalahan ini terjadi ketika koneksi dari PolarDB-X ke node data backend mengalami timeout atau node tersebut gagal merespons. Kegagalan node data biasanya menyebabkan masalah ini. Untuk mengatasi masalah ini, hubungi dukungan teknis.

    TDDL-4108 ERR_VARIABLE_CAN_NOT_SET_TO_NULL_FOR_NOW

    • Deskripsi: Variabel tertentu tidak dapat diatur ke NULL.

    • Contoh: ERR-CODE: [TDDL-4108][ERR_VARIABLE_CAN_NOT_SET_TO_NULL_FOR_NOW] System variable ***** can''t set to null for now;

    • Anda tidak dapat mengatur variabel node data tertentu ke NULL dengan pernyataan SET var = x. Jika Anda melakukannya, PolarDB-X mengembalikan kesalahan TDDL-4108.

    TDDL-4200 ERR_GROUP_NOT_AVALILABLE

    • Deskripsi: Node data di PolarDB-X sementara tidak tersedia.

    • Contoh: ERR-CODE: [TDDL-4200][ERR_GROUP_NOT_AVALILABLE] The TDDL Group ***** is running in fail-fast status, caused by this SQL:***** which threw a fatal exception as *****.

    • Ketika node data dalam shard database menjadi tidak dapat diakses dan tidak ada node data lain yang tersedia dalam shard tersebut, PolarDB-X menempatkan shard database dalam status fail-fast dan mengembalikan kesalahan TDDL-4200.

      Kegagalan node data biasanya menyebabkan kesalahan ini. Temukan dan atasi masalah berdasarkan informasi eksepsi untuk node data yang terpengaruh. Setelah node data yang gagal pulih, PolarDB-X secara otomatis menghapus status fail-fast.

      Jika kesalahan TDDL-4200 berlanjut setelah Anda mengatasi kegagalan node data, hubungi dukungan teknis.

    TDDL-4201 ERR_GROUP_NO_ATOM_AVALILABLE

    • Deskripsi: Tidak ada node data yang tersedia di shard database PolarDB-X.

    • Contoh: ERR-CODE: [TDDL-4201][ERR_GROUP_NO_ATOM_AVALILABLE] Semua bobot basis data dalam Grup '*****' bernilai 0. Bobotnya adalah: *****.

    • PolarDB-X mengembalikan kesalahan TDDL-4201 ketika semua node data dalam shard database tidak tersedia atau dalam status fail-fast.

      Kegagalan node data biasanya menyebabkan kesalahan ini. Periksa status node data backend untuk menemukan dan mengatasi masalah tersebut. Jika kesalahan berlanjut setelah Anda mengatasi kegagalan tersebut, hubungi dukungan teknis.

    TDDL-4202 ERR_SQL_QUERY_TIMEOUT

    • Deskripsi: Kueri PolarDB-X mengalami timeout.

    • Contoh: ERR-CODE: [TDDL-4202][ERR_SQL_QUERY_TIMEOUT] Slow query leads to a timeout exception, please contact DBA to check slow sql. SocketTimout:*** ms, Atom:*****, Group:*****, AppName:*****, Env:*****, UnitName:null.

    • Kesalahan ini terjadi ketika waktu eksekusi pernyataan SQL pada node data backend melebihi batas socketTimeout di PolarDB-X. Secara default, timeout kueri PolarDB-X (socketTimeout) adalah 900 detik.

      Untuk mengatasi masalah ini, optimalkan pernyataan SQL dan buat indeks yang sesuai pada node data backend untuk meningkatkan kinerja. Jika pernyataan SQL masih lambat setelah dioptimalkan, Anda dapat menggunakan sintaks hint berikut untuk sementara mengatur timeout kueri PolarDB-X: /*TDDL:SOCKET_TIMEOUT=900000*/ SELECT * FROM dual;. Nilai SOCKET_TIMEOUT ditentukan dalam milidetik. Untuk informasi selengkapnya tentang penggunaan hint di PolarDB-X, lihat Cara menyesuaikan periode timeout SQL. Hubungi dukungan teknis untuk menyesuaikan secara permanen timeout kueri PolarDB-X.

    TDDL-4203 ERR_SQL_QUERY_MERGE_TIMEOUT

    • Deskripsi: Kueri terdistribusi PolarDB-X mengalami timeout.

    • Contoh: ERR-CODE: [TDDL-4203][ERR_SQL_QUERY_MERGE_TIMEOUT] Kueri SQL yang lambat menyebabkan pengecualian waktu habis saat menggabungkan hasil. Harap optimalkan kueri SQL tersebut. Waktu habis default adalah *** ms. DB adalah *****

    • Kesalahan ini terjadi ketika kueri terdistribusi PolarDB-X mengalami timeout. Secara default, timeout adalah 900 detik. Kesalahan ini berarti pernyataan SQL yang memindai beberapa shard database memerlukan waktu lebih dari batas 900 detik untuk dieksekusi.

      Kami merekomendasikan optimasi berikut:

      • Sertakan kondisi kunci shard dalam klausa WHERE untuk mengoptimalkan pernyataan SQL agar berjalan pada satu shard database saja.

      • Buat indeks yang sesuai pada node data backend untuk meningkatkan kinerja pemindaian data pada setiap shard database.

      • Hilangkan operasi yang memakan waktu seperti JOIN lintas database dan pengurutan ulang data dalam kueri terdistribusi untuk mengurangi konsumsi sumber daya selama fase penggabungan data PolarDB-X.

      Jika kueri masih lambat setelah dioptimalkan, gunakan hint berikut untuk sementara menambah timeout untuk PolarDB-X: /*TDDL:SOCKET_TIMEOUT=900000*/ SELECT * FROM dual;. Nilai SOCKET_TIMEOUT dalam milidetik. Untuk informasi selengkapnya tentang penggunaan hint di PolarDB-X, lihat Cara menyesuaikan periode timeout SQL.

    TDDL-4400 ERR_SEQUENCE

    • Deskripsi: Gagal memproses sequence (sequence unik global).

    • Contoh: ERR-CODE: [TDDL-4400][ERR_SEQUENCE] Sequence : All dataSource faild to get value!

    • Kesalahan ini menunjukkan kegagalan memproses sequence. Detail kesalahan mengikuti string Sequence :. Penyebab umum TDDL-4400 adalah kegagalan node data yang mencegah akses ke tabel terkait sequence.

      Pertama, periksa status node data backend. Jika kesalahan berlanjut setelah Anda menyingkirkan kegagalan node data, hubungi dukungan teknis.

    TDDL-4401 ERR_MISS_SEQUENCE

    • Deskripsi: Sequence yang ditentukan tidak ada.

    • Contoh: ERR-CODE: [TDDL-4401][ERR_MISS_SEQUENCE] Sequence '*****' is not found

    • Nama sequence yang ditentukan dalam pernyataan tidak ada. Jalankan pernyataan SHOW SEQUENCES untuk memeriksa nama semua sequence yang telah dibuat di PolarDB-X dan gunakan nama sequence yang valid.

      Jika sequence tidak ada, gunakan pernyataan berikut untuk membuatnya:

      CREATE SEQUENCE <nama sequence> [ START WITH <nilai numerik> ] 
[ INCREMENT BY <nilai numerik> ] [ MAXVALUE <nilai numerik> ] 
[ CYCLE | NOCYCLE ]`

      Jika sequence ada tetapi kesalahan TDDL-4401 berlanjut, hubungi dukungan teknis. Untuk detail tentang penggunaan sequence di PolarDB-X, lihat Ikhtisar.

    TDDL-4403 ERR_MISS_SEQUENCE_TABLE_ON_DEFAULT_DB

    • Deskripsi: Tabel sequence tidak ada.

    • Contoh: ERR-CODE: [TDDL-4403][ERR_MISS_SEQUENCE_TABLE_ON_DEFAULT_DB] Sequence table is not in default db.

    • Tabel bernama sequence atau sequence_opt tidak dapat diakses di database backend PolarDB-X. Untuk mengatasi masalah ini, hubungi dukungan teknis.

    TDDL-4404 ERR_SEQUENCE_TABLE_META

    • Deskripsi: Skema tabel sequence tidak valid.

    • Contoh: ERR-CODE: [TDDL-4404][ERR_SEQUENCE_TABLE_META] the meta of sequence table is error, some columns missed

    • Kolom wajib hilang dari tabel sequence (seperti sequence atau sequence_opt). Hubungi dukungan teknis.

    TDDL-4405 ERR_INIT_SEQUENCE_FROM_DB

    • Deskripsi: Kesalahan ini menunjukkan kegagalan inisialisasi sequence.

    • Contoh: ERR-CODE: [TDDL-4405][ERR_INIT_SEQUENCE_FROM_DB] init sequence manager error: *****

    • Kesalahan ini terjadi ketika sequence gagal diinisialisasi. Pesan setelah 'init sequence manager error' menjelaskan penyebab spesifiknya. Pertama, periksa status node data backend PolarDB-X. Jika kesalahan TDDL-4405 berlanjut setelah mengatasi kegagalan node data, hubungi dukungan teknis.

    TDDL-4407 ERR_OTHER_WHEN_BUILD_SEQUENCE

    • Deskripsi: Gagal mengakses tabel sequence.

    • Contoh: ERR-CODE: [TDDL-4407][ERR_OTHER_WHEN_BUILD_SEQUENCE] error when build sequence: *****

    • Kesalahan ini terjadi saat mengakses tabel terkait sequence, seperti sequence atau sequence_opt. Pesan kesalahan spesifik muncul setelah string error when build sequence:.

      Pertama, periksa status node data backend PolarDB-X. Jika kesalahan TDDL-4407 berlanjut setelah Anda menyingkirkan kegagalan node data, hubungi dukungan teknis.

    TDDL-4408 ERR_SEQUENCE_NEXT_VALUE

    • Deskripsi: Terjadi saat pengambilan nilai berikutnya dari sequence gagal.

    • Contoh: ERR-CODE: [TDDL-4408][ERR_SEQUENCE_NEXT_VALUE] error when get sequence's next value, sequence is: *****, error: *****

    • Kesalahan ini terjadi ketika Anda menggunakan primary key auto-increment di PolarDB-X atau mengambil GUID secara manual dengan menggunakan sintaks <nama sequence>.NEXTVAL. Prompt error: menjelaskan penyebab spesifiknya.

      Kegagalan node data backend biasanya menyebabkan kesalahan ini. Periksa status dan beban akses node data backend PolarDB-X. Jika kesalahan berlanjut setelah melakukan troubleshooting pada node data backend, hubungi dukungan teknis.

    TDDL-4500 ERR_PARSER

    • Deskripsi: Gagal mengurai pernyataan SQL.

    • Contoh: ERR-CODE: [TDDL-4500][ERR_PARSER] not support statement: '*****'

    • PolarDB-X mendukung sintaks SQL yang sesuai dengan standar SQL-92, serta ekstensi sintaks dan fungsi yang didukung oleh MySQL. Pastikan pernyataan SQL yang Anda eksekusi sesuai dengan standar SQL yang didukung oleh PolarDB-X dan spesifikasi MySQL.

      Untuk informasi selengkapnya, lihat sintaks SQL standar. Untuk informasi selengkapnya tentang kompatibilitas SQL, lihat batasan sintaks SQL. Jika pernyataan SQL Anda mengikuti aturan ini tetapi Anda masih menerima kesalahan TDDL-4500, hubungi dukungan teknis.

    TDDL-4501 ERR_OPTIMIZER

    • Deskripsi: Pengoptimal gagal mengonversi pernyataan SQL.

    • Contoh: ERR-CODE: [TDDL-4501][ERR_OPTIMIZER] optimize error by: Unknown column '*****' in 'order clause'

    • Kesalahan ini terjadi ketika PolarDB-X pengoptimal tidak dapat mengonversi pernyataan SQL menjadi pohon sintaks internal karena kesalahan logika dalam pernyataan tersebut.

      Gunakan pesan setelah 'optimize error by' untuk memperbaiki pernyataan SQL Anda. Jika kesalahan berlanjut, hubungi dukungan teknis.

    TDDL-4502 ERR_OPTIMIZER_MISS_ORDER_FUNCTION_IN_SELECT

    • Deskripsi: kolom fungsi dalam klausa ORDER BY tidak ada di klausa SELECT.

    • Contoh: ERR-CODE: [TDDL-4502][ERR_OPTIMIZER_MISS_ORDER_FUNCTION_IN_SELECT] Syntax Error: orderBy/GroupBy Column ***** is not existed in select clause`

    • Di PolarDB-X, kolom fungsi apa pun (seperti RAND()) yang digunakan dalam klausa ORDER BY juga harus muncul di klausa SELECT dari pernyataan SQL yang sama. Kegagalan melakukannya memicu kesalahan TDDL-4502.

      Tambahkan kolom fungsi yang sesuai ke klausa SELECT.

    TDDL-4504 ERR_OPTIMIZER_SELF_CROSS_JOIN

    • Deskripsi: Kondisi kunci shard yang diperlukan hilang untuk SELF JOIN.

    • Contoh: ERR-CODE: [TDDL-4504][ERR_OPTIMIZER_SELF_CROSS_JOIN] self cross join case, add shard column filter on right table

    • Kesalahan ini terjadi selama SELF JOIN di PolarDB-X jika klausa where hanya menentukan kondisi kunci shard untuk tabel kiri atau tabel kanan.

      Untuk mengatasinya, pastikan klausa where pernyataan SQL mencakup kondisi kunci shard untuk kedua tabel kiri dan kanan.

    TDDL-4506 ERR_MODIFY_SHARD_COLUMN

    • Deskripsi: Anda tidak dapat memperbarui kunci sharding.

    • Contoh: ERR-CODE: [TDDL-4506][ERR_MODIFY_SHARD_COLUMN] Column '*****' is a sharding key of table '*****', which is forbidden to be modified.

    • Kesalahan ini terjadi ketika Anda mencoba memodifikasi kunci sharding. Di PolarDB-X, Anda tidak dapat memodifikasi kunci sharding tabel yang memiliki indeks sekunder global.

      Sebagai solusi sementara, ganti pernyataan UPDATE dengan pernyataan INSERT dan DELETE yang setara.

    TDDL-4508 ERR_OPTIMIZER_NOT_ALLOWED_SORT_MERGE_JOIN

    • Deskripsi: Tidak dapat melakukan sort-merge join.

    • Contoh: ERR-CODE: [TDDL-4508][ERR_OPTIMIZER_NOT_ALLOWED_SORT_MERGE_JOIN] sort merge join is not allowed when missing equivalent filter

    • Jika pernyataan SQL melakukan join tabel yang berada di node data berbeda, PolarDB-X memprioritaskan algoritma sort-merge join. Algoritma ini memerlukan kondisi join kesetaraan antara tabel kiri dan kanan. Jika tidak, PolarDB-X melaporkan kesalahan TDDL-4508.

      Untuk mengatasinya, tambahkan kondisi join kesetaraan ke klausa JOIN atau WHERE.

    TDDL-4509 ERR_OPTIMIZER_ERROR_HINT

    • Contoh: ERR-CODE: [TDDL-4509][ERR_OPTIMIZER_ERROR_HINT] Hint Syntax Error: unexpected operation: *****.

    • Kesalahan ini terjadi ketika PolarDB-X tidak dapat mengurai sintaks hint dalam pernyataan SQL. Untuk informasi selengkapnya, lihat Cara menggunakan hint.

    TDDL-4510 ERR_CONTAINS_NO_SHARDING_KEY

    • Deskripsi: Kondisi kunci shard hilang.

    • Contoh: ERR-CODE: [TDDL-4510][ERR_CONTAINS_NO_SHARDING_KEY] Your SQL contains NO SHARDING KEY '*****' for table '*****', which is not allowed in DEFAULT.

    • Kesalahan ini terjadi ketika kueri tanpa kondisi kunci shard mencoba melakukan pemindaian tabel penuh pada tabel tempat pemindaian tabel penuh dinonaktifkan. Secara default, PolarDB-X mengaktifkan pemindaian tabel penuh saat tabel dibuat. Jika Anda menonaktifkan fitur ini secara manual, pastikan semua pernyataan SQL untuk tabel tersebut mencakup kondisi kunci shard.

    TDDL-4511 ERR_INSERT_CONTAINS_NO_SHARDING_KEY

    • Deskripsi: Pernyataan INSERT tidak menyertakan kunci shard.

    • Contoh: ERR-CODE: [TDDL-4511][ERR_INSERT_CONTAINS_NO_SHARDING_KEY] Your INSERT SQL contains NO SHARDING KEY '*****' for table '*****'.

    • Pernyataan INSERT untuk tabel ter-shard PolarDB-X harus menyertakan nilai kunci shard. Persyaratan ini tidak berlaku jika kunci shard adalah primary key auto-increment. Jika tidak, PolarDB-X mengembalikan kesalahan TDDL-4511.

      Untuk mengatasi kesalahan ini, sertakan nilai kunci shard dalam pernyataan INSERT.

    TDDL-4515 ERR_CONNECTION_CHARSET_NOT_MATCH

    • Deskripsi: Set karakter string input tidak sesuai dengan set karakter database.

    • Contoh: ERR-CODE: [TDDL-4515][ERR_CONNECTION_CHARSET_NOT_MATCH] Disebabkan oleh ketidaksesuaian character_set_connection MySQL dengan charset input Anda. Partisi DDL hanya mendukung nama kolom dalam karakter ASCII atau Tiongkok. Jika ingin menggunakan nama tabel atau kolom beraksara Tiongkok, pastikan charset koneksi MySQL mendukung karakter tersebut. Gunakan perintah "set names xxx" untuk mengatur charset yang sesuai.

    • PolarDB-X mendukung karakter Cina dalam nama tabel dan nama kolom. Kesalahan ini terjadi ketika Anda menjalankan pernyataan SQL yang berisi karakter Cina, tetapi set karakter koneksi, yang ditentukan oleh variabel character_set_connection, diatur ke nilai yang tidak kompatibel, seperti latin1.

      Jalankan SHOW VARIABLES LIKE 'character_set_connection' untuk menanyakan set karakter koneksi klien MySQL saat ini. Untuk mengubah set karakter koneksi, gunakan perintah SET NAMES. Saat terhubung ke PolarDB-X dari aplikasi Java menggunakan JDBC, atur parameter characterEncoding.

    TDDL-4517 ERR_MODIFY_SYSTEM_TABLE

    • Deskripsi: Anda tidak dapat memodifikasi tabel sistem.

    • Contoh: ERR-CODE: [TDDL-4517][ERR_MODIFY_SYSTEM_TABLE] Table '*****' is PolarDB-XSYSTEM TABLE, which is forbidden to be modified.

    • PolarDB-X memelihara serangkaian tabel sistem internal yang penting untuk operasinya. PolarDB-X mengembalikan kesalahan ini ketika pernyataan SQL mencoba memodifikasi data dalam tabel-tabel tersebut. Tabel sistem yang dilindungi termasuk sequence, sequence_opt, dan txc_undo_log. Jangan gunakan nama-nama yang dicadangkan ini untuk tabel yang ditentukan pengguna.

    TDDL-4520 ERR_DML_WITH_SUBQUERY

    • Deskripsi: Subkueri tidak didukung dalam pernyataan DML.

    • Contoh: ERR-CODE: [TDDL-4520][ERR_DML_WITH_SUBQUERY] DO NOT support UPDATE/DELETE with subQuery

    • PolarDB-X melarang subkueri dalam pernyataan DML. Untuk mengatasi masalah ini, tulis ulang pernyataan SQL agar tidak menggunakan subkueri.

    TDDL-4521 ERR_INSERT_SHARD

    • Deskripsi: Catatan dipetakan ke beberapa shard selama operasi INSERT.

    • Contoh: ERR-CODE: [TDDL-4521][ERR_INSERT_SHARD] Cannot decide which group to insert

    • Kesalahan ini terjadi karena catatan dipetakan ke beberapa shard, dan sistem tidak dapat menentukan mana yang akan digunakan. Jika Anda mengalami masalah ini, hubungi dukungan teknis.

    TDDL-4523 ERR_TODNF_LIMIT_EXCEED

    • Deskripsi: Jumlah kondisi dalam klausa WHERE melebihi batas.

    • Contoh: ERR-CODE: [TDDL-4523][ERR_TODNF_LIMIT_EXCEED] toDnf has exceed the limit size

    • PolarDB-X mengonversi kondisi klausa WHERE ke bentuk normal konjungtif (CNF) dan bentuk normal disjungtif (DNF) untuk deduksi dan optimasi kondisi. Untuk memastikan stabilitas sistem, PolarDB-X membatasi jumlah kondisi hingga 2.000. Anda dapat meningkatkan batas ini dengan menyesuaikan parameter DNF_REX_NODE_LIMIT.

    TDDL-4524 ERR_TOCNF_LIMIT_EXCEED

    • Deskripsi: Jumlah kondisi dalam klausa WHERE melebihi batas.

    • Contoh: ERR-CODE: [TDDL-4524][ERR_TOCNF_LIMIT_EXCEED] toCnf has exceeded the limit

    • Untuk melakukan deduksi dan optimasi kondisi, PolarDB-X mengonversi kondisi kueri dalam klausa WHERE SQL menjadi bentuk normal konjungtif (CNF) dan bentuk normal disjungtif (DNF). Untuk memastikan stabilitas optimasi, PolarDB-X membatasi jumlah kondisi hingga 2.000. Anda dapat meningkatkan batas ini dengan menyesuaikan parameter CNF_REX_NODE_LIMIT.

    TDDL-4526 ERR_FUNCTION_NOT_FOUND

    • Deskripsi: Fungsi yang ditentukan tidak didukung.

    • Contoh: ERR-CODE: [TDDL-4526][ERR_FUNCTION_NOT_FOUND] No match found for function signature

    • Kesalahan ini terjadi ketika kueri SQL menggunakan sintaks yang salah atau fungsi yang tidak didukung. Pastikan pemanggilan fungsi menggunakan jumlah dan jenis parameter yang benar.

    TDDL-4527 ERR_MODIFY_SHARD_COLUMN_ON_TABLE_WITHOUT_PK

    • Anda tidak dapat memodifikasi kunci shard pada tabel tanpa primary key.

    • Contoh: ERR-CODE: [TDDL-4527][ERR_MODIFY_SHARD_COLUMN_ON_TABLE_WITHOUT_PK]

    • PolarDB-X tidak mendukung modifikasi kunci shard pada tabel yang tidak memiliki primary key.

    TDDL-4595 ERR_UNKNOWN_TZ

    • Deskripsi: Zona waktu yang ditentukan tidak valid.

    • Contoh: ERR-CODE: [TDDL-4595][ERR_UNKNOWN_TZ]

    • Periksa sintaks dan format zona waktu yang ditentukan.

    TDDL-4600 ERR_FUNCTION

    • Deskripsi: Pemanggilan fungsi tidak valid.

    • Contoh: ERR-CODE: [TDDL-4600][ERR_FUNCTION] function compute error by Incorrect parameter count in the call to native function '*****'

    • Kesalahan ini menunjukkan bahwa pemanggilan fungsi dalam kueri SQL memiliki sintaks atau parameter yang salah. Tinjau pemanggilan fungsi untuk memverifikasi bahwa jumlah dan jenis parameternya benar.

    TDDL-4601 ERR_EXECUTOR

    • Contoh:

      ERR-CODE: [TDDL-4601][ERR_EXECUTOR] only one column is supported in 
distinct aggregate

    • Kesalahan ini menunjukkan kegagalan internal dalam PolarDB-X selama eksekusi SQL, biasanya disebabkan oleh masalah pada instans RDS MySQL backend.

    TDDL-4602 ERR_CONVERTOR

    • Deskripsi: Konversi tipe tidak valid.

    • Contoh: ERR-CODE: [TDDL-4602][ERR_CONVERTOR] convertor error by Unsupported convert: [*****]

    • Kesalahan ini terjadi ketika PolarDB-X gagal mengonversi tipe data selama eksekusi kueri SQL. Periksa kueri SQL untuk konversi tipe implisit dan gunakan tipe data yang cocok untuk perbandingan dan perhitungan.

    TDDL-4603 ERR_ACCROSS_DB_TRANSACTION

    • Deskripsi: Transaksi lintas database gagal.

    • Contoh: ERR-CODE: [TDDL-4603][ERR_ACCROSS_DB_TRANSACTION] Transaction accross db is not supported in current transaction policy, transaction node is: {0}, but this sql execute on: *****.

    • Meskipun PolarDB-X mendukung transaksi lintas database secara default, kesalahan ini menunjukkan bahwa kebijakan transaksi yang berbeda telah ditetapkan.

    TDDL-4604 ERR_CONCURRENT_TRANSACTION

    • Deskripsi: Transaksi bersarang tidak didukung.

    • Contoh: ERR-CODE: [TDDL-4604][ERR_CONCURRENT_TRANSACTION] Concurrent query is not supported on transaction group, transaction group is: {0}.

    • PolarDB-X tidak mendukung transaksi bersarang. Kesalahan ini terjadi ketika Anda memulai transaksi baru pada koneksi database yang sudah memiliki transaksi aktif.

      Untuk mengatasi masalah ini, hindari penggunaan transaksi bersarang dalam logika aplikasi Anda. Atau, gunakan framework transaksi tingkat aplikasi untuk mencegah bersarang.

    TDDL-4606: ERR_QUERY_CANCLED

    • Deskripsi: Pernyataan SQL saat ini dibatalkan.

    • Contoh: ERR-CODE: [TDDL-4606][ERR_QUERY_CANCLED] Getting connection is not allowed when query has been canceled, group is *****

    • Kesalahan ini terjadi ketika pernyataan KILL membatalkan pernyataan SQL. Jika kesalahan ini sering terjadi, periksa apakah klien atau program mengeluarkan pernyataan KILL.

    TDDL-4610 ERR_CONNECTION_CLOSED

    • Deskripsi: Koneksi telah ditutup.

    • Contoh: ERR-CODE: [TDDL-4610][ERR_CONNECTION_CLOSED] connection has been closed

    • Kesalahan ini terjadi ketika Anda mencoba menggunakan kembali koneksi database yang telah ditutup. Koneksi ditutup jika pernyataan SQL dalam transaksi gagal atau dibatalkan oleh perintah KILL.

      Untuk mengatasi masalah ini, tutup koneksi yang tidak valid dan peroleh koneksi baru.

    TDDL-4612 ERR_CHECK_SQL_PRIV

    • Deskripsi: Akun saat ini tidak memiliki izin yang cukup untuk mengeksekusi pernyataan SQL.

    • Contoh: ERR-CODE: [TDDL-4612][ERR_CHECK_SQL_PRIV] check user ***** on db ***** sql privileges failed.

    • Versi baru PolarDB-X mencakup sistem otorisasi akun yang mirip dengan sistem izin MySQL. Hanya akun dengan izin yang diperlukan yang dapat mengeksekusi pernyataan SQL. Jika akun tidak memiliki izin yang diperlukan, PolarDB-X mengembalikan kesalahan TDDL-4612.

      Untuk mengatasi masalah ini, periksa izin PolarDB-X akun tersebut. Jika izin tidak mencukupi, berikan izin yang diperlukan di Konsol PolarDB-X. Untuk informasi selengkapnya tentang cara mengelola akun dan izin PolarDB-X, lihat Mengelola akun database.

    TDDL-4614 ERR_EXECUTE_ON_MYSQL

    • Deskripsi: Kesalahan ini terjadi ketika pernyataan SQL gagal dieksekusi pada node data.

    • Contoh:

      ERR-CODE: [TDDL-4614][ERR_EXECUTE_ON_MYSQL] Error occurs when execute on  GROUP '*****': Duplicate entry '*****' for key 'PRIMARY'
This error occurs when an SQL statement fails on a PolarDB-X data node. The end of the message shows the raw error from the data node. The following are common examples:
 
Duplicate entry '*****' for key 'PRIMARY'
A primary key conflict occurred when writing data to a data node table. To fix this, correct the data and run the statement again.
   
The table '*****' is full
This indicates that a temporary table on the data node is full. To fix this, increase the temporary tablespace or optimize the SQL statement.
     
Deadlock found when trying to get lock;
A deadlock occurred on the data node, often due to a high number of transaction conflicts during write operations.

      Kesalahan dengan pernyataan INSERT INTO ... ON DUPLICATE KEY UPDATE

      • Gejala: Saat Anda menggunakan pernyataan INSERT INTO ... ON DUPLICATE KEY UPDATE... untuk menulis data, Anda menerima kesalahan yang menyerupai berikut: Error occurs when execute on GROUP 'PROMOTION_P00000_GROUP' ATOM 'dskeyxxxxxxx000_group#pxc-xdb-s-xxxxxxxxxxx#x.x.x.x-3080#promotion_p00000': Duplicate entry '2024xxxxxxxx' for key 'uk_orderId'.

      • Penyebab: Tingkat isolasi read committed (RC) tidak menggunakan gap lock, sehingga pernyataan SELECT FOR UPDATE dapat mengembalikan hasil yang tidak akurat selama operasi konkuren. Memodifikasi kunci partisi meningkatkan waktu respons, sehingga membuat masalah ini lebih mungkin terjadi.

      • Solusi: Untuk memperbaikinya, ubah tingkat isolasi database menjadi repeatable read (RR). Menghapus kunci partisi dari pernyataan UPSERT juga secara signifikan mengurangi kemungkinan terjadinya kesalahan ini.

      Kesalahan penyisipan karena primary key auto-increment

      • Gejala: Penyisipan data gagal dengan kesalahan konflik primary key, meskipun pernyataan INSERT tidak menentukan nilai untuk primary key auto-increment id. Pernyataan SHOW CREATE TABLE menunjukkan bahwa nilai auto-increment berikutnya adalah 2900006, tetapi kesalahannya adalah [179473d091c1a001][xxxx:3074][nationaltax]ERR-CODE: [TDDL-4614][ERR_EXECUTE_ON_MYSQL] Error occurs when execute on GROUP 'NATIOXXXXXGROUP' ATOM 'dskey_nationaltax_single_group#pxc-xdb-s-pxcxxxxxxqimhg2639#x.x.x.x-3001#nationaltax_single': Duplicate entry '200001' for key 'PRIMARY'.

      • Penyebab: Perintah SHOW SEQUENCE menampilkan nilai awal auto-increment yang dialokasikan secara internal oleh PolarDB-X. Sebaliknya, perintah SHOW CREATE TABLE untuk tabel non-partisi menampilkan nilai yang sama dengan nilai maksimum data aktual di tabel ditambah satu. Kesalahan dilaporkan karena nilai auto-increment untuk tabel bermasalah adalah 200000. Anda dapat menjalankan perintah SHOW SEQUENCE untuk melihat nilai ini.

      • Solusi: Jalankan pernyataan ALTER SEQUENCE AUTO_SEQ_xxxxxxxx START WITH <max_id> untuk memperbaiki nilai sequence. Untuk informasi selengkapnya, lihat ALTER SEQUENCE.

      Kesalahan UPDATE pada tabel dengan indeks sekunder global (GSI)

      • Gejala: Menjalankan operasi UPDATE pada tabel tertentu dapat menyebabkan banyak kesalahan konflik primary key seperti ini: TDDL-4614 Error occurs when execute on GROUP 'JMXXXXXXXXXXX00000' ATOM 'dskey_xdafdsfads': Duplicate entry '3204347' for key 'PRIMARY'.

      • Penyebab: Pernyataan UPDATE yang gagal semuanya melibatkan modifikasi kunci partisi pada indeks sekunder global.

      • Solusi: Hapus GSI pada tabel sebelum menjalankan pernyataan UPDATE.

      Catatan

      Untuk indeks lokal pada tabel terpartisi, Anda dapat menganggap tabel tersebut dibagi menjadi beberapa tabel fisik berdasarkan kunci partisi id. Indeks lokal adalah batasan pada setiap tabel fisik. Ini berarti bahwa batasan unik berlaku dalam tabel fisik yang berisi baris dengan kunci partisi id yang sama, tetapi tidak berlaku di tingkat global. Untuk memastikan keunikan global untuk tabel logis, Anda harus menggunakan indeks sekunder global (GSI), yang meningkatkan overhead penulisan. PolarDB-X dapat menjamin keunikan untuk tabel fisik tunggal pada DN, tetapi tidak dapat menjamin keunikan global di seluruh instans PolarDB-X. Anda dapat membuat GLOBAL UNIQUE INDEX untuk memastikan keunikan global.

    • Kami merekomendasikan agar Anda merujuk ke pesan kesalahan asli untuk TDDL-4614 untuk melakukan troubleshooting masalah tersebut. Untuk informasi selengkapnya tentang pesan kesalahan pernyataan SQL, lihat dokumentasi MySQL 5.6. Jika kesalahan TDDL-4614 berlanjut setelah Anda menyingkirkan masalah pada aplikasi atau node data backend, hubungi dukungan teknis.

    Kesalahan dengan pernyataan INSERT INTO ... ON DUPLICATE KEY UPDATE

    Kesalahan penyisipan karena primary key auto-increment

    Kesalahan UPDATE pada tabel dengan indeks sekunder global (GSI)

    TDDL-4616 ERR_UNKNOWN_DATABASE

    • Deskripsi: Database yang ditentukan tidak ada.

    • Contoh: ERR-CODE: [TDDL-4616][ERR_UNKNOWN_DATABASE] Unknown database '*****'

    • PolarDB-X memungkinkan Anda menentukan nama database dalam pernyataan DDL. Kesalahan ini terjadi jika nama yang ditentukan tidak cocok dengan nama database PolarDB-X Anda.

      Untuk mengatasi masalah ini, ubah nama database dalam pernyataan DDL agar sesuai dengan nama database PolarDB-X Anda.

    TDDL-4620 ERR_FORBID_EXECUTE_DML_ALL

    PolarDB-X melarang pernyataan delete dan update tanpa klausa where.

    TDDL-4633 ERR_DB_STATUS_READ_ONLY

    • Contoh: ERR-CODE: [TDDL-4633][ERR_DB_STATUS_READ_ONLY] Database is read-only, only read sql are supported

    • Kesalahan ini menunjukkan bahwa database bersifat read-only. Verifikasi izin untuk akun saat ini.

    TDDL-4636 ERR_DDL_JOB_ERROR

    Pernyataan DDL gagal dieksekusi.

    Contoh:

    ERR-CODE: [TDDL-4636][ERR_DDL_JOB_ERROR] xxxx

    Untuk mengatasi masalah ini, lihat Menangani eksepsi DDL.

    TDDL-4642 ERR_UNKNOWN_TABLE

    Kesalahan ini berarti tabel yang ditentukan tidak ada di database.

    Contoh:

    ERR-CODE: [TDDL-4642][ERR_UNKNOWN_TABLE] Unknown table XX.XX

    Untuk mengatasi masalah ini, verifikasi bahwa tabel tersebut ada di database saat ini.

    TDDL-4707 ERR_OUT_OF_MEMORY

    • Deskripsi: Kueri melebihi batas memori untuk tabel sementara.

    • Contoh: ERR-CODE: [TDDL-4707][ERR_OUT_OF_MEMORY]

    • Untuk menjaga stabilitas database, PolarDB-X memberlakukan batas memori pada tabel sementara untuk setiap kueri. Kesalahan ini terjadi ketika kueri yang memproses volume data besar menyebabkan tabel sementaranya melebihi batas memori. Untuk mengatasinya, aktifkan fitur spill to disk atau tingkatkan batas memori untuk tabel sementara kueri tersebut.

    TDDL-4709 ERR_IVENTORY_HINT_NOT_SUPPORT_CROSS_SHARD

    • Contoh: ERR-CODE: [TDDL-4709][ERR_IVENTORY_HINT_NOT_SUPPORT_CROSS_SHARD]

    • Fitur optimasi hot row memerlukan transaksi single-shard. Anda akan menerima kesalahan ini jika transaksi yang menggunakan fitur ini menjadi transaksi cross-shard. Untuk mengatasinya, sesuaikan logika bisnis Anda untuk memastikan transaksi tetap dalam satu shard.

    TDDL-4994 ERR_FLOW_CONTROL

    • Deskripsi: Batas laju permintaan telah terlampaui.

    • Contoh: ERR-CODE: [TDDL-4994][ERR_FLOW_CONTROL] [*****] flow control by *****

    • Kesalahan ini menunjukkan bahwa PolarDB-X telah mencapai batas internalnya untuk memproses permintaan SQL dan karena itu menolak permintaan saat ini. Periksa adanya lonjakan abnormal dalam volume permintaan SQL Anda. Jika kesalahan TDDL-4994 berlanjut bahkan setelah volume permintaan SQL Anda menurun, hubungi dukungan teknis.

    TDDL-4998 ERR_NOT_SUPPORT

    • Deskripsi: Fitur yang ditentukan tidak didukung.

    • Contoh: ERR-CODE: [TDDL-4998][ERR_NOT_SUPPORT] ***** not support yet!

    • Kesalahan ini menunjukkan bahwa sintaks SQL atau fitur dalam pernyataan Anda tidak didukung oleh PolarDB-X. Jika aplikasi Anda memerlukan fitur ini, hubungi dukungan teknis.

    TDDL-5001 ERR_TRANS

    • Deskripsi: Terjadi kesalahan transaksi umum.

    • Contoh: ERR-CODE: [TDDL-5001][ERR_TRANS] Too many lines updated in statement.

    • Lakukan troubleshooting kesalahan berdasarkan pesan spesifiknya.

      • Too many lines updated in statement

        Kesalahan ini terjadi ketika jumlah baris yang diperbarui oleh pernyataan UPDATE dalam transaksi melebihi batas 1.000. Periksa klausa WHERE pernyataan tersebut. Jika Anda perlu memperbarui volume data besar dalam transaksi, gunakan hint PolarDB-X /*TDDL:UNDO_LOG_LIMIT={number}*/ untuk menyesuaikan batas tersebut.

      • Deferred execution is only supported in Flexible or XA Transaction

        Eksekusi ditunda hanya berfungsi dengan kebijakan transaksi fleksibel atau transaksi XA. Sebelum Anda menunda eksekusi menggunakan hint PolarDB-X /*TDDL:DEFER*/, jalankan perintah SET drds_transaction_policy = *** untuk mengubah kebijakan transaksi PolarDB-X.

      • Untuk pesan kesalahan lainnya, hubungi dukungan teknis.

    TDDL-5002 ERR_TRANS_UNSUPPORTED

    • Deskripsi: Transaksi menggunakan sintaks atau fitur yang tidak didukung.

    • Contoh: ERR-CODE: [TDDL-5002][ERR_TRANS_UNSUPPORTED] Table without primary keys is not supported.

    • PolarDB-X tidak mendukung fitur ini dalam transaksi. Jika Anda memerlukan fitur ini, hubungi dukungan teknis.

    TDDL-5003 ERR_TRANS_LOG

    • Deskripsi: Log transaksi tidak dapat diakses.

    • Contoh: ERR-CODE: [TDDL-5003][ERR_TRANS_LOG] Failed to update transaction state: *****

    • Untuk memastikan atomisitas transaksi terdistribusi, PolarDB-X mengakses log transaksi pada node data backend. Kesalahan TDDL-5003 terjadi jika PolarDB-X gagal membaca dari atau menulis ke log transaksi.

      Kegagalan node data backend biasanya menyebabkan kesalahan TDDL-5003. Periksa status dan beban akses node data backend PolarDB-X. Jika kesalahan berlanjut setelah menyingkirkan masalah node data, hubungi dukungan teknis.

    TDDL-5006 ERR_TRANS_COMMIT

    • Deskripsi: Kesalahan ini menunjukkan bahwa transaksi gagal dikomit.

    • Contoh: ERR-CODE: [TDDL-5006][ERR_TRANS_COMMIT] Failed to commit primary group *****: *****, TRANS_ID = *****

    • Kesalahan ini terjadi ketika PolarDB-X gagal mengomit cabang transaksi. Sistem secara otomatis membatalkan transaksi yang diidentifikasi oleh TRANS_ID. Penyebab umumnya adalah kegagalan node data backend. Periksa status dan beban akses node data backend di PolarDB-X. Jika kesalahan berlanjut setelah menyingkirkan masalah node data backend, hubungi dukungan teknis.

    TDDL-5008 ERR_TRANS_TERMINATED

    • Deskripsi: Pernyataan KILL atau timeout menghentikan transaksi.

    • Contoh: ERR-CODE: [TDDL-5008][ERR_TRANS_TERMINATED] Current transaction was killed or timeout. You may need to set a longer timeout value.

    • Kesalahan ini terjadi jika transaksi PolarDB-X dihentikan oleh pernyataan KILL atau jika waktu eksekusinya melebihi nilai parameter drds_transaction_timeout. Jika kesalahan disebabkan oleh timeout transaksi, Anda dapat menjalankan perintah SET drds_transaction_timeout = *** untuk meningkatkan waktu eksekusi maksimum untuk transaksi PolarDB-X. Nilai tersebut ditentukan dalam milidetik.

    TDDL-5010 ERR_TRANS_CONTINUE_AFTER_WRITE_FAIL

    • Deskripsi: Transaksi tidak dapat dilanjutkan setelah operasi tulis gagal.

    • Contoh: ERR-CODE: [TDDL-5010][ERR_TRANS_CONTINUE_AFTER_WRITE_FAIL] Cannot continue or commit transaction after writing failed

    • Ketika operasi tulis gagal dalam transaksi terdistribusi PolarDB-X, transaksi tersebut berhenti. Anda harus mengeluarkan perintah rollback dari antarmuka depan untuk menghentikan transaksi sebelum mencoba lagi. Anda juga dapat menggunakan analisis log untuk melakukan troubleshooting transaksi lambat.

    TDDL-5108 ERR_CHECK_PRIVILEGE_FAILED_ON_TABLE

    Deskripsi: Akun saat ini tidak memiliki izin yang diperlukan untuk tabel yang ditentukan. Periksa izin yang diberikan kepada akun tersebut.

    TDDL-5119 ERR_FILE_CANNOT_BE_CREATE

    Deskripsi: Dukungan untuk pernyataan SELECT INTO OUTFILE dinonaktifkan secara default di PolarDB-X. Untuk mengaktifkannya, hubungi dukungan teknis.

    TDDL-5302 ERR_GLOBAL_SECONDARY_INDEX_UNSUPPORTED

    Anda tidak dapat membuat indeks sekunder global pada tabel ini karena salah satu alasan berikut: 1. Tabel tersebut adalah tabel non-partisi atau tabel broadcast. 2. Kolom indeks sekunder global tidak mencakup kunci partisi. Untuk alasan lainnya, hubungi dukungan teknis.

    TDDL-5306 ERR_GLOBAL_SECONDARY_INDEX_INSERT_DUPLICATE_VALUES

    Kesalahan ini terjadi ketika operasi tulis ke tabel indeks sekunder global menghasilkan konflik primary key. Periksa nilai catatan dalam pesan kesalahan untuk mengidentifikasi catatan yang bertentangan.

    TDDL-5308 ERR_GLOBAL_SECONDARY_INDEX_MODIFY_UNIQUE_KEY

    Kesalahan ini terjadi ketika operasi DML menyebabkan konflik kunci unik pada indeks sekunder global. Untuk mengatasinya, periksa nilai catatan dalam pesan kesalahan untuk mengidentifikasi data yang bertentangan.

    TDDL-5310 ERR_GLOBAL_SECONDARY_INDEX_ONLY_SUPPORT_XA

    PolarDB-X hanya mendukung indeks sekunder global dengan transaksi terdistribusi XA atau Timestamp Oracle (TSO). Kesalahan ini mungkin terjadi jika Anda telah mengubah kebijakan transaksi default. Untuk mengatasi masalah ini, atur kembali kebijakan transaksi terdistribusi ke XA atau TSO, lalu buat indeks sekunder global tersebut.

    TDDL-5313 ERR_GLOBAL_SECONDARY_INDEX_MODIFY_GSI_TABLE_WITH_DDL

    Secara default, PolarDB-X tidak mendukung operasi DDL pada tabel indeks sekunder global. Untuk mengaktifkan kemampuan ini, hubungi dukungan teknis.

    TDDL-5316 ERR_GLOBAL_SECONDARY_INDEX_INDEX_AND_SHARDING_COLUMNS_NOT_MATCH

    Kesalahan ini terjadi karena indeks sekunder global PolarDB-X harus mencakup semua kunci partisinya dalam kolom indeks. Aturan ini berlaku untuk semua kunci partisi, seperti kunci shard database dan kunci partisi tabel. Misalnya, pernyataan CREATE GLOBAL INDEX idx_1 ON t(a, b) DBPARTITION BY HASH(c) memicu kesalahan TDDL-5316. Hal ini terjadi karena klausa ON t(a, b) menentukan a dan b sebagai kolom indeks tetapi menghilangkan kunci partisi, c. Untuk mengatasi kesalahan ini, perbarui pernyataan DDL Anda untuk memastikan kolom indeks mencakup semua kunci partisi dari indeks sekunder global tersebut.

    TDDL-5317 ERR_GLOBAL_SECONDARY_INDEX_CONTINUE_AFTER_WRITE_FAIL

    • Contoh: ERR-CODE: [TDDL-5317][ERR_GLOBAL_SECONDARY_INDEX_CONTINUE_AFTER_WRITE_FAIL] Cannot continue or commit transaction after writing global secondary index failed

    • Deskripsi: Jika kesalahan ini terjadi saat Anda mengeksekusi pernyataan DML pada tabel dengan indeks sekunder global (GSI), Anda tidak dapat mengomit transaksi yang berisi pernyataan yang gagal tersebut. Anda harus memodifikasi kode bisnis Anda untuk melakukan rollback lalu mencoba ulang transaksi tersebut.

    TDDL-5321 ERR_GLOBAL_SECONDARY_INDEX_BACKFILL_DUPLICATE_ENTRY

    Kesalahan ini menunjukkan bahwa primary key duplikat ditemukan di tabel indeks selama pengisian ulang data untuk indeks sekunder global.

    TDDL-8007 ERR_ABANDONED_TASK

    PolarDB-X mengembalikan kesalahan ini ketika menghentikan kueri yang sangat lambat atau telah macet selama lebih dari dua jam. Untuk mengatasi masalah ini, optimalkan kueri Anda. Jika masalah berlanjut, hubungi dukungan teknis.

    TDDL-8008 ERR_EXECUTE_SPILL

    Hasil kueri antara yang besar dapat menyebabkan tabel sementara dituliskan ke disk. Kesalahan ini menunjukkan bahwa terjadi eksepsi selama proses spill-to-disk. Hubungi dukungan teknis.

    TDDL-8011 ERR_OUT_OF_SPILL_SPACE

    Selama eksekusi kueri, hasil antara yang besar dapat menyebabkan tabel sementara dituliskan ke disk. Kesalahan ini terjadi ketika file-file tersebut melebihi ruang disk maksimum untuk spill. Untuk mengatasinya, optimalkan kueri untuk meminimalkan penggunaan tabel sementara. Jika masalah berlanjut, hubungi dukungan teknis.

    TDDL-8012 ERR_OUT_OF_SPILL_FD

    Selama eksekusi kueri, hasil antara yang besar dapat menyebabkan tabel sementara dituliskan ke disk. Kesalahan ini terjadi jika tabel sementara menghasilkan lebih banyak file daripada batas handle file sistem. Hubungi dukungan teknis untuk menyelidiki kemungkinan kebocoran handle file. Jika tidak ditemukan kebocoran, Anda dapat meningkatkan batas handle file sesuai kebutuhan.

    TDDL-8102 ERR_PAGE_TOO_LARGE

    Kesalahan ini terjadi selama pemrosesan paralel masif (MPP) ketika batch data yang dipertukarkan antara node komputasi melebihi batas ukuran panggilan prosedur jarak jauh (RPC). Untuk mengatasinya, kurangi CHUNK_SIZE default.

    TDDL-8103 ERR_NO_NODES_AVAILABLE

    Deskripsi: Kesalahan ini menunjukkan bahwa tidak ada node komputasi yang tersedia untuk penjadwalan tugas, mungkin karena kegagalan node komputasi selama komputasi paralel MPP. Untuk mengatasinya, verifikasi bahwa semua layanan node komputasi berjalan dengan benar. Jika kesalahan berlanjut, hubungi dukungan teknis.

    TDDL-9301 ERR_DUPLICATED_PARTITION_NAME

    Kesalahan ini terjadi ketika pernyataan DDL menggunakan nama partisi yang duplikat.

    TDDL-9305 ERR_PARTITION_NAME_NOT_EXISTS

    Kesalahan ini terjadi ketika operasi DDL pada tabel terpartisi menentukan nama partisi yang tidak ada. Verifikasi bahwa nama partisi tersebut dieja dengan benar. Jalankan show create table dan check table untuk memeriksa konsistensi metadata. Metadata yang tidak konsisten dapat menyebabkan kesalahan ini. Jika masalah berlanjut, hubungi dukungan teknis.

    TDDL-10004 ERR_X_PROTOCOL_RESULT

    • Contoh: ERR-CODE: [TDDL-10004][ERR_X_PROTOCOL_RESULT] Should use chunk2chunk to fetch data

    • Di PolarDB-X, node komputasi menggunakan RPC privat untuk berkomunikasi dengan node data. Kesalahan ini menunjukkan koneksi yang gagal antara node komputasi dan node data. Masalah ini memiliki beberapa penyebab potensial. Periksa pesan kesalahan untuk detail lebih lanjut. Jika Anda tidak dapat mengidentifikasi akar penyebabnya, hubungi dukungan teknis.