Hologres:Diagnosis SQL

Item diagnosis

Deskripsi

Total kueri

Jumlah total kueri dalam rentang waktu yang dipilih.

Kueri berhasil

Jumlah total kueri yang berhasil dalam rentang waktu yang dipilih.

Kueri gagal

Jumlah total kueri yang gagal dalam rentang waktu yang dipilih.

Detail kueri gagal

Menampilkan kode kesalahan dan jumlah kegagalan terkait untuk membantu Anda mengelola kueri yang gagal. Bagian ini juga menunjukkan kueri khas dan detail kesalahan.

Anda dapat menuju ke Query Insight untuk melihat detail lebih lanjut. Anda juga dapat melihat Tabel referensi kode kesalahan untuk mengetahui penyebab kesalahan secara rinci guna meningkatkan stabilitas instans.

Tren kueri berhasil dan gagal

Menunjukkan rasio antara kueri berhasil dan gagal dalam rentang waktu yang dipilih. Hal ini membantu Anda memahami status eksekusi kueri secara keseluruhan pada instans tersebut.

Tren rasio konsumsi waktu kueri

Menunjukkan tren rasio konsumsi waktu kueri dalam rentang waktu yang dipilih.

Secara default, analisis ini hanya mencakup rasio konsumsi waktu untuk kueri SELECT, INSERT, UPDATE, dan DELETE.

Tren DML

Menunjukkan tren eksekusi untuk kueri DML.

Secara default, analisis ini hanya mencakup kueri SELECT, INSERT, UPDATE, dan DELETE.

Tren DDL

Menunjukkan tren eksekusi untuk kueri DDL.

Analisis ini hanya mencakup pernyataan DDL berikut: CREATE TABLE, DROP TABLE, TRUNCATE TABLE, ALTER TABLE, CALL, CREATE EXTENSION, CREATE FOREIGN TABLE, ALTER FOREIGN TABLE, IMPORT FOREIGN SCHEMA, DROP FOREIGN TABLE, CREATE SCHEMA, CREATE VIEW, DROP VIEW, GRANT, CREATE ROLE, ALTER ROLE, dan COMMENT.

Rasio atau tren sumber aplikasi kueri

Menunjukkan rasio atau tren kueri berdasarkan application_name.

Anda dapat menganalisis aplikasi yang memiliki rasio tinggi. Kami merekomendasikan menetapkan application_name yang relevan untuk berbagai jenis tugas. Praktik ini memberikan grafik rasio dan tren sumber aplikasi yang lebih akurat untuk membantu Anda memantau tugas yang tidak normal.

Rasio atau tren kueri berdasarkan pengguna

Menunjukkan rasio atau tren kueri berdasarkan usename.

Hal ini memungkinkan Anda menganalisis eksekusi kueri pengguna dengan lebih jelas. Kami merekomendasikan menggunakan username berbeda untuk tugas yang berbeda, bukan satu akun tunggal. Praktik ini mempermudah troubleshooting masalah.

Tren kueri berdasarkan mesin eksekusi

Menunjukkan tren eksekusi kueri untuk mesin eksekusi berbeda dalam rentang waktu yang dipilih.

Hologres menggunakan mesin eksekusi berbeda berdasarkan karakteristik kueri, seperti HQE, PQE, SDK, atau FixedQE. Untuk informasi selengkapnya, lihat Arsitektur layanan. Kami merekomendasikan menghindari kueri PQE. Anda dapat menulis ulang kueri tersebut menjadi kueri HQE untuk mendapatkan performa yang lebih baik.

Kode kesalahan

Deskripsi

Pesan kesalahan lengkap umum

Solusi

HG_ERRCODE_FDW_ERROR

Terjadi kesalahan saat mengimpor metadata dari tabel eksternal MaxCompute ke Hologres. Kesalahan ini biasanya disebabkan oleh tipe tabel yang tidak didukung.

failed to import foreign schema from odps: Can't find file system factory

Untuk informasi selengkapnya, lihat HG_ERRCODE_FDW_ERROR.

ERRCODE_FDW_ERROR

Terjadi kesalahan saat mengkueri tabel eksternal.

• failed to import foreign schema from odps: Authorization Failed: xxx

• failed to import foreign schema from odps:Table not found -xxx

Selesaikan masalah berdasarkan pesan kesalahan spesifik. Untuk informasi selengkapnya, lihat ERRCODE_FDW_ERROR.

• ERRCODE_UNIQUE_VIOLATION

• pk violates

Kendala unik dilanggar. Kesalahan ini sering terjadi ketika menulis kunci primer duplikat.

duplicate key value violates unique constraint DETAIL: xxx already exists.

• Atasi data yang berisi kunci primer duplikat.

• Jika pernyataan INSERT gagal, Anda dapat menulis ulang menjadi pernyataan INSERT ... ON CONFLICT untuk menghapus kunci primer duplikat. Untuk informasi selengkapnya, lihat INSERT ON CONFLICT (UPSERT).

• Jika pernyataan INSERT ... ON CONFLICT gagal, hal ini karena sumber data berisi data duplikat. Untuk solusinya, lihat INSERT ON CONFLICT (UPSERT).

• ERRCODE_CHECK_VIOLATION

• partition constraint

Konstraint CHECK dilanggar. Kesalahan ini sering terjadi ketika Anda menulis data ke tabel partisi Hologres dan nilai partisi tidak sesuai dengan partisi yang ditentukan. Misalnya, data untuk partisi 20240229 ditulis ke partisi 20240301.

new row for relation xx violates partition constraint DETAIL: Failing row contains (column1)=(xxxx).

Periksa apakah data partisi sesuai dengan nilai partisi yang ditentukan. Jika tidak sesuai, modifikasi datanya.

• ERRCODE_NOT_NULL_VIOLATION

• not-null constraint

• UsageProblem

Kendala NOT NULL dilanggar. Kesalahan ini sering terjadi ketika data null ditulis ke bidang yang memiliki kendala NOT NULL.

null value in column xxx violates not-null constraint DETAIL: Failing row contains (null).

Bersihkan data kotor.

ERRCODE_UNDEFINED_TABLE

Tabel tidak ada. Kesalahan ini biasanya terjadi ketika metadata belum diperbarui setelah tabel dibuat, atau ketika tabel dipotong (truncate) atau dihapus (drop) selama eksekusi kueri.

Dispatch query failed: Table not found

Gunakan Query Insight untuk memeriksa adanya tugas TRUNCATE atau DROP konkuren, lalu coba ulang tugas tersebut. Untuk informasi selengkapnya, lihat Query Insight.

• ERRCODE_INTERNAL_ERROR

• ERPC_ERROR_CONNECTION_CLOSED

Terjadi kesalahan internal yang tidak terduga. Instans mungkin mati, atau kueri terputus secara tak terduga.

• Transaction xx is not found or it was expired and cancelled.

• Query is cancelled

• ERPC_ERROR_CONNECTION_CLOSED

Tidak ada.

• ERRCODE_QUERY_CANCELED

• User canceled

• CANCELLED

• Query Is Cancelled

• InternalQueryIsClosed

Kueri dibatalkan. Kesalahan ini biasanya disebabkan oleh timeout klien, atau karena tabel dipotong (truncate) atau dihapus (drop).

• ERROR: canceling statement due to statement timeout

• canceling statement due to user request

Untuk solusinya, lihat Kelola kueri.

• ERRCODE_FEATURE_NOT_SUPPORTED

• Unsupported Feature

Fitur yang diminta tidak didukung.

• Dynamic partition selector is not supported

• ALTER TABLE CHANGE OWNER is not supported in SPM (Simple Permission Mode)

• Feature not supported: insert into parent table

Untuk solusinya, lihat FAQ tentang pernyataan SQL Hologres.

ERRCODE_UNDEFINED_OBJECT

Objek tidak didefinisikan. Kesalahan ini biasanya terjadi ketika kolom atau kelompok tabel yang ditentukan tidak ada.

• column xxx does not exist

• Table group xxx does not exist.

• Buat objek yang dilaporkan tidak ada.

• Pastikan nama objek yang benar digunakan dalam pernyataan SQL.

• ERRCODE_INSUFFICIENT_PRIVILEGE

• permission denied

Akun saat ini memiliki izin yang tidak mencukupi. Anda harus memberikan izin yang diperlukan kepada akun tersebut.

• ERROR: permission denied for schema xxx

• ERROR: permission denied for foreign table table_info

Untuk solusinya, lihat Masalah izin Hologres.

• ERRCODE_OUT_OF_MEMORY

• OOM

Kueri menyebabkan kesalahan kehabisan memori (OOM) karena memori tidak mencukupi.

Total memory used by all existing queries exceeded memory limitation

Untuk solusinya, lihat Panduan troubleshooting kesalahan OOM.

• ERRCODE_DATATYPE_MISMATCH

• Unmatched Data Row Schema Number

• Dataset Schema Not Match

Terjadi ketidaksesuaian tipe data. Kesalahan ini biasanya terjadi ketika tipe data aktual suatu bidang tidak sesuai dengan tipe data yang dibutuhkan oleh ekspresi.

• unmatched data row schema number

• Datasets has different schema

Periksa apakah kolom dalam pernyataan SQL sesuai.

• ERRCODE_DIVISION_BY_ZERO

• division by zero

Pernyataan SQL berisi pembagian dengan 0.

division by zero

Bersihkan data kotor atau gunakan parameter GUC untuk mencegah kesalahan akibat pembagian dengan nol. Untuk informasi selengkapnya, lihat Penggunaan fungsi.

ERRCODE_STRING_DATA_RIGHT_TRUNCATION

Data string terpotong. Kesalahan ini sering terjadi ketika nilai bidang VARCHAR melebihi panjang yang ditentukan saat tabel dibuat.

value too long for type character varying(xx)

Buat ulang tabel dan ubah panjang bidang VARCHAR, atau atur tipe bidang menjadi TEXT.

• ERRCODE_PROGRAM_LIMIT_EXCEEDED

• Exceed Odps Scan Limit

Batas Hologres terlampaui. Kesalahan ini biasanya terjadi ketika jumlah partisi yang dipindai dari tabel eksternal, jumlah baris yang dibaca, atau jumlah byte yang dibaca melebihi batas yang ditentukan.

• number of read rows (xxxxx) exceeds limit (xxxxxxx)

• number of partitions (xxx) scanned for "xxxx" exceeds the maximum allowed (xxx)

• scan (xxx GB) for "xxxxx" exceeds the maximum allowed (xxx GB)

Kueri tabel eksternal melebihi batas. Untuk solusinya, lihat FAQ dan diagnosis untuk koneksi ke MaxCompute.

ERRCODE_SYNTAX_ERROR

Pernyataan SQL berisi kesalahan sintaksis.

syntax error at or near "xxxxx"

Periksa sintaksis SQL.

ERRCODE_UNDEFINED_FUNCTION

Fungsi yang tidak didukung digunakan. Kesalahan ini dapat terjadi karena sintaksis fungsi salah, ekstensi yang diperlukan belum dibuat, atau fungsi tersebut tidak didukung.

• function xxxxx does not exist

• operator does not exist: xxxxxx

Ikuti sintaksis fungsi untuk menghindari kesalahan akibat sintaksis salah atau ekstensi yang hilang. Untuk informasi selengkapnya, lihat Referensi fungsi.

ERRCODE_E_R_E_READING_SQL_DATA_NOT_PERMITTED

Akun tidak memiliki izin baca pada tabel eksternal.

check permission for foreign table scan failed: failed to check permission:MaxCompute error,Authorization Failed [4019], You have NO privilege 'odps:Select' on {xxxxxxxxxx}

Untuk solusinya, lihat Masalah izin MaxCompute.

• ERRCODE_DUPLICATE_OBJECT

• already exist

Objek duplikat ada. Kesalahan ini biasanya terjadi ketika Anda mencoba membuat ekstensi, publikasi, atau role yang duplikat.

• publication "xxxxx" already exists

• extension "xxxxx" already exists

• role "xxxxxxxx" already exists

Jika objek sudah ada, Anda tidak perlu membuatnya lagi.

• ERRCODE_INVALID_TEXT_REPRESENTATION

• invalid input

Representasi teks tidak valid. Kesalahan ini sering terjadi ketika mengonversi string ke tipe data lain dan data string tidak valid, seperti mengonversi string kosong ("") ke INT.

invalid input syntax for integer: xxx

Bersihkan data kotor.

ERRCODE_BAD_COPY_FILE_FORMAT

Format file atau data salah untuk perintah COPY. Kesalahan ini sering terjadi ketika data berisi delimiter yang ditentukan oleh perintah COPY, seperti spasi, sehingga menyebabkan ketidaksesuaian jumlah kolom.

• extra data after last expected column. failed to query next

• missing data for column "xxx". failed to query next

Bersihkan data kotor.

ERRCODE_UNDEFINED_COLUMN

Kueri berisi kolom yang tidak ada.

column xxxxx does not exist

Periksa sintaksis SQL.

ERRCODE_NUMERIC_VALUE_OUT_OF_RANGE

Nilai numerik di luar jangkauan:

• Data untuk tipe numerik melebihi rentang yang ditentukan. Misalnya, untuk tipe data decimal(4,2) atau numeric(4,2), bagian integer maksimal dua digit, tetapi data aktualnya 100.

• Nilai int atau bigint melebihi rentang yang dapat direpresentasikan.

• value "xxxxx" is out of range for type bigint

• numeric field overflow

• bigint out of range

• integer out of range

Periksa data kotor atau definisi tipe yang salah dan ubah tipe kolom jika perlu.

ERRCODE_DATETIME_FIELD_OVERFLOW

Terjadi overflow nilai pada bidang terkait waktu, seperti timestamp, timestamptz, date, time, atau timetz. Misalnya, menulis "877411-01-01 00:00:00+08" ke tipe data timestamptz.

• date/time field value out of range: "xxxxxx"

• date out of range: "xxxxxx"

Bersihkan data kotor.

ERRCODE_INVALID_PARAMETER_VALUE

Nilai parameter tidak valid digunakan. Kesalahan ini biasanya terjadi ketika parameter tidak memenuhi persyaratan. Anda dapat menyelesaikan masalah berdasarkan pesan kesalahan spesifik. Misalnya, kesalahan column "col" with type "float4" cannot be set as "bitmap_columns" menunjukkan bahwa tipe data float4 tidak dapat diatur sebagai kolom bitmap.

• mismatched properties: table orientation is "column" but storage format is "sst"

• resharding insert select table data failed : Dispatch query failed: internal error: Failed to get available shards for query

• InsertOverwrite insert select table data failed : column a.unsign_type does not exist

Periksa sintaksis SQL.

ERRCODE_INVALID_DATETIME_FORMAT

Format tanggal tidak valid digunakan. Data tanggal tidak memenuhi persyaratan format. Misalnya, SELECT TO_DATE('aa', 'YYYY-MM-DD');. Periksa datanya.

• invalid input syntax for type timestamp: ""

• invalid input syntax for type date: ""

• invalid value "" for "yyyy", Value must be an integer.

Bersihkan data kotor.

ERRCODE_CHARACTER_NOT_IN_REPERTOIRE

Karakter tidak termasuk dalam repertoar. Kesalahan ini sering terjadi ketika ada karakter tidak valid yang bukan bagian dari encoding UTF-8.

invalid byte sequence for encoding "UTF8": 0xe9 0x80

Bersihkan data kotor.

ERRCODE_DUPLICATE_TABLE

Tabel duplikat ada. Kesalahan ini sering terjadi ketika Anda mencoba membuat tabel dengan nama yang sama dengan tabel yang sudah ada.

relation "xxxx" already exists

Jika tabel sudah ada, Anda tidak perlu membuatnya lagi.

ERRCODE_UNTRANSLATABLE_CHARACTER

Karakter tidak dapat dikonversi ke format target.

character with byte sequence 0xe4 0x9e 0xab in encoding "UTF8" has no equivalent in encoding "GBK"

Bersihkan data kotor.

ERRCODE_GROUPING_ERROR

Terjadi kesalahan pengelompokan. Kesalahan ini terkait dengan klausa GROUP BY.

column "xxx" must appear in the GROUP BY clause or be used in an aggregate function

Periksa sintaksis SQL. Saat menggunakan fungsi agregat, semua bidang lain harus dimasukkan dalam klausa GROUP BY.

• ERRCODE_INVALID_TRANSACTION_STATE

• Usage Problem

Terjadi status transaksi tidak valid. Operasi terkait transaksi tidak valid. Misalnya, saat Anda menggunakan CALL SET_TABLE_PROPERTY untuk membuat kunci distribusi, operasi tersebut tidak berada dalam transaksi yang sama dengan pembuatan tabel.

SET_TABLE_PROPERTY and CREATE TABLE statement are not in the same transaction

Pernyataan CREATE TABLE harus berada dalam transaksi yang sama dengan pernyataan CALL SET_TABLE_PROPERTY. Gunakan BEGIN; dan COMMIT; untuk membungkus kedua pernyataan tersebut.

ERRCODE_AMBIGUOUS_COLUMN

Referensi kolom ambigu dibuat. Kesalahan ini biasanya terjadi ketika nama kolom yang sama dalam pernyataan SQL dapat merujuk ke kolom berbeda. Misalnya, dalam pernyataan SELECT id FROM t1 INNER JOIN t2 ON t1.id = t2.id, bidang id tidak ditentukan milik t1 atau t2.

column reference "xxx" is ambiguous

Periksa sintaksis SQL.

ERRCODE_DUPLICATE_COLUMN

Kolom duplikat didefinisikan. Kesalahan ini sering terjadi ketika bidang yang sama dideklarasikan beberapa kali saat pembuatan tabel.

column "xxx" specified more than once

Periksa sintaksis SQL.

ERRCODE_AMBIGUOUS_FUNCTION

Pemanggilan fungsi ambigu dilakukan. Kesalahan ini biasanya terjadi ketika fungsi mendukung beberapa tipe parameter input, tetapi tipe data parameter yang dilewatkan tidak ditentukan secara jelas.

Fungsi `to_char` memiliki bentuk seperti to_char(timestamp/timestamptz, text),

to_char(double precision, text), atau to_char(int, text). Jika inputnya adalah to_char('2024-02-22', 'YYYY-MM-DD'), terjadi kesalahan karena '2024-02-22' bukan salah satu dari tiga tipe data yang diperlukan. Anda harus melakukan casting tipe secara eksplisit agar operasi berhasil: to_char('2024-02-22'::timestamptz, 'YYYY-MM-DD').

Periksa sintaksis SQL.

ERRCODE_INVALID_COLUMN_DEFINITION

Definisi kolom tidak valid digunakan. Di Hologres, kesalahan ini sering disebabkan oleh tidak menentukan presisi untuk tipe data Numeric atau Decimal.

invalid definition of a numeric type

Anda dapat memproses data kotor.

ERRCODE_INVALID_CATALOG_NAME

ERRCODE_UNDEFINED_DATABASE

Database yang ditentukan tidak ada.

None

Periksa apakah database tersebut ada.

ERRCODE_CANNOT_COERCE

Terjadi kesalahan karena data tidak dapat dikonversi antara dua tipe data.

cannot cast type date to integer

Periksa sintaksis SQL.

ERRCODE_DEPENDENT_OBJECTS_STILL_EXIST

Objek dependen masih ada. Kesalahan ini sering terjadi ketika Anda mencoba menghapus objek yang masih digunakan oleh objek lain. Misalnya, Anda tidak dapat menghapus skema jika masih berisi tabel.

None

Atasi dependensi terkait. Untuk informasi selengkapnya, lihat Hapus akun.

ERRCODE_UNDEFINED_SCHEMA atau

ERRCODE_INVALID_SCHEMA_NAME

Skema yang ditentukan tidak ada.

schema "xxxx" does not exist

Periksa apakah skema tersebut ada. Jika tidak ada, buatlah.

ERRCODE_DUPLICATE_DATABASE

Database duplikat ada. Kesalahan ini terjadi ketika Anda mencoba membuat database yang sudah ada.

None

Jika database sudah ada, Anda tidak perlu membuatnya lagi.

AutoAnalyze-Failed

Tugas Auto Analyze gagal.

• query row count from analyze table

• query from analyze table

Tugas Auto Analyze gagal, yang biasanya disebabkan oleh masalah backend. Kirim tiket untuk troubleshooting masalah tersebut.

Import Foreign Table Not Found

Tabel eksternal tidak ditemukan.

• failed to get foregin table split:Table not found

• Failed to get odps table:Not enable acid table

• failed to get foregin table split:% not found

Periksa apakah tabel eksternal yang ingin Anda akses ada.

Cannot Acquire Lock In Time

Kesalahan ini biasanya disebabkan oleh kegagalan memperoleh lock. Ketika kueri konkurensi tinggi dan operasi drop menargetkan tabel yang sama, deadlock dapat terjadi pada node backend. Hal ini menyebabkan semua operasi pada tabel tersebut macet dan melaporkan kesalahan.

internal error: Cannot acquire lock in time, current owners

Untuk solusinya, lihat Lock dan troubleshooting lock.

• OTHER

• QueryNextFTEFailed

• QueryNextPQEFailed

• ForeignSplitOrSchemaConnectionClosed

• ConnectionRefused

• ERPC_ERROR_TIMEOUT

• ERPC_ERROR_CONNECTION_CLOSED

Kesalahan tak terduga.

• kConnectError: channel is empty

• ERPC_ERROR_CONNECTION_CLOSED

• internal error: Connect timeout, err: std_exception: Connection refused

Ini adalah kesalahan tak terduga. Anda dapat mengirim tiket untuk troubleshooting masalah tersebut.