View a markdown version of this page

STL_LOAD_ERROR - Amazon Redshift

Amazon Redshift tidak akan lagi mendukung penggunaan Python UDF setelah 30 Juni 2026. Kami akan mulai menegakkannya secara bertahap. Untuk informasi lebih lanjut tentang detail opsi akhir masa pakai dan migrasi Python, lihat posting blog yang diterbitkan pada 30 Juni 2025.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

STL_LOAD_ERROR

Menampilkan catatan semua kesalahan pemuatan Amazon Redshift.

STL_LOAD_ERRORS berisi riwayat semua kesalahan pemuatan Amazon Redshift. Lihat Referensi kesalahan muat untuk daftar lengkap kemungkinan kesalahan beban dan penjelasan.

Kueri STL_LOADERROR_DETAIL untuk detail tambahan, seperti baris data dan kolom yang tepat tempat kesalahan penguraian terjadi, setelah Anda menanyakan STL_LOAD_ERRORS untuk mengetahui informasi umum tentang kesalahan.

STL_LOAD_ERRORS dapat dilihat oleh semua pengguna. Pengguna super dapat melihat semua baris; pengguna biasa hanya dapat melihat data mereka sendiri. Untuk informasi selengkapnya, lihat Visibilitas data dalam tabel dan tampilan sistem.

catatan

STL_LOAD_ERRORS hanya berisi kueri yang dijalankan pada cluster utama yang disediakan. Itu tidak berisi kueri yang dijalankan pada cluster penskalaan konkurensi atau pada ruang nama tanpa server. Untuk mengakses rencana penjelasan untuk kueri yang dijalankan pada klaster utama, cluster penskalaan konkurensi, dan ruang nama tanpa server, sebaiknya gunakan tampilan pemantauan SYS. SYS_LOAD_ERROR_DETAIL Data dalam tampilan pemantauan SYS diformat agar lebih mudah digunakan dan dipahami.

Kolom tabel

Nama kolom Jenis data Deskripsi
Userid integer ID pengguna yang membuat entri.
mengiris integer Iris tempat kesalahan terjadi.
tbl integer ID tabel.
waktu mulai timestamp Waktu mulai dalam UTC untuk beban.
sesi integer ID sesi untuk sesi yang melakukan pemuatan.
kueri integer ID kueri. Kolom query dapat digunakan untuk bergabung dengan tabel dan tampilan sistem lainnya.
nama berkas karakter (256) Jalur lengkap ke file input untuk beban.
bilangan garis bigint Nomor baris dalam file muat dengan kesalahan. Untuk COPY dari JSON, nomor baris dari baris terakhir objek JSON dengan kesalahan.
colname karakter (127) Bidang dengan kesalahan.
jenis karakter (10) Jenis data bidang.
col_length karakter (10) Panjang kolom, jika berlaku. Bidang ini diisi ketika tipe data memiliki batas panjang. Misalnya, untuk kolom dengan tipe data “karakter (3)”, kolom ini akan berisi nilai “3".
posisi integer Posisi kesalahan di lapangan.
raw_line karakter (1024) Data beban mentah yang berisi kesalahan. Karakter multibyte dalam data beban diganti dengan titik.
nilai_bidang raw_ karakter (1024) Nilai pra-penguraian untuk bidang “colname” yang menyebabkan kesalahan penguraian.
kode kesalahan integer Kode kesalahan.
alasan_kesalahan karakter (100) Penjelasan untuk kesalahan tersebut.
adalah_sebagian integer Nilai yang jika benar (1) menunjukkan file input dibagi menjadi rentang selama operasi COPY. Jika nilai ini false (0), file input tidak dibagi.
awal_offset bigint Nilai yang, jika file input dibagi selama operasi COPY, menunjukkan nilai offset pemisahan (dalam byte). Jika nomor baris dalam file tidak diketahui, nomor baris adalah -1. Jika file tidak dibagi, nilai ini adalah 0.
salin_job_id bigint Pengidentifikasi pekerjaan menyalin. A 0 menunjukkan tidak ada pengidentifikasi pekerjaan.

Kueri Sampel

Kueri berikut menggabungkan STL_LOAD_ERRORS ke STL_LOADERROR_DETAIL untuk melihat detail kesalahan yang terjadi selama pemuatan terbaru.

select d.query, substring(d.filename,14,20), d.line_number as line, substring(d.value,1,16) as value, substring(le.err_reason,1,48) as err_reason from stl_loaderror_detail d, stl_load_errors le where d.query = le.query and d.query = pg_last_copy_id(); query | substring | line | value | err_reason -------+-------------------+------+----------+---------------------------- 558| allusers_pipe.txt | 251 | 251 | String contains invalid or unsupported UTF8 code 558| allusers_pipe.txt | 251 | ZRU29FGR | String contains invalid or unsupported UTF8 code 558| allusers_pipe.txt | 251 | Kaitlin | String contains invalid or unsupported UTF8 code 558| allusers_pipe.txt | 251 | Walter | String contains invalid or unsupported UTF8 code

Contoh berikut menggunakan STL_LOAD_ERRORS dengan STV_TBL_PERM untuk membuat tampilan baru, dan kemudian menggunakan tampilan itu untuk menentukan kesalahan apa yang terjadi saat memuat data ke tabel EVENT:

create view loadview as (select distinct tbl, trim(name) as table_name, query, starttime, trim(filename) as input, line_number, colname, err_code, trim(err_reason) as reason from stl_load_errors sl, stv_tbl_perm sp where sl.tbl = sp.id);

Selanjutnya, query berikut benar-benar mengembalikan kesalahan terakhir yang terjadi saat memuat tabel EVENT:

select table_name, query, line_number, colname, starttime, trim(reason) as error from loadview where table_name ='event' order by line_number limit 1;

Kueri mengembalikan kesalahan pemuatan terakhir yang terjadi untuk tabel EVENT. Jika tidak terjadi kesalahan pemuatan, kueri mengembalikan nol baris. Dalam contoh ini, query mengembalikan kesalahan tunggal:

table_name | query | line_number | colname | error | starttime ------+-----+----+----+--------------------------------------------------------+---------------------- event | 309 | 0 | 5 | Error in Timestamp value or format [%Y-%m-%d %H:%M:%S] | 2014-04-22 15:12:44 (1 row)

Dalam kasus di mana perintah COPY secara otomatis membagi data file besar, tidak terkompresi, dan dibatasi teks untuk memfasilitasi paralelisme, kolom line_number, is_partial, dan start_offset menampilkan informasi yang berkaitan dengan pem is ahan. (Nomor baris dapat tidak diketahui dalam kasus di mana nomor baris dari file asli tidak tersedia.)

--scan ranges information SELECT line_number, POSITION, btrim(raw_line), btrim(raw_field_value), btrim(err_reason), is_partial, start_offset FROM stl_load_errors WHERE query = pg_last_copy_id(); --result -1,51,"1008771|13463413|463414|2|28.00|38520.72|0.06|0.07|NO|1998-08-30|1998-09-25|1998-09-04|TAKE BACK RETURN|RAIL|ans cajole sly","NO","Char length exceeds DDL length",1,67108864