Amazon Redshift tidak akan lagi mendukung pembuatan Python UDFs baru mulai Patch 198. Python yang ada UDFs akan terus berfungsi hingga 30 Juni 2026. Untuk informasi lebih lanjut, lihat [posting blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Memecahkan masalah beban data Saat memuat data ke tabel Amazon Redshift, Anda mungkin mengalami kesalahan dari Amazon S3, data input tidak valid, dan kesalahan perintah COPY. Bagian berikut memberikan informasi tentang mengidentifikasi dan menyelesaikan kesalahan pemuatan data. **Topics** + [Memecahkan masalah integrasi acara S3 dan kesalahan COPY JOB](s3-integration-troubleshooting.md) + [Kesalahan S3 ServiceException](s3serviceexception-error.md) + [Tabel sistem untuk memecahkan masalah beban data](system-tables-for-troubleshooting-data-loads.md) + [Kesalahan pemuatan karakter multibyte](multi-byte-character-load-errors.md) + [Referensi kesalahan muat](r_Load_Error_Reference.md) # Memecahkan masalah integrasi acara S3 dan kesalahan COPY JOB Gunakan informasi berikut untuk memecahkan masalah umum dengan integrasi acara Amazon S3 dan COPY JOB dengan Amazon Redshift. ## Pembuatan integrasi acara S3 gagal Jika pembuatan integrasi acara S3 gagal, status integrasinya adalah`Inactive`. Pastikan bahwa berikut ini benar untuk gudang data Amazon Redshift Anda. + Anda menambahkan sumber utama dan integrasi resmi yang benar untuk namespace target Anda di Amazon Redshift. Lihat [Prasyarat untuk membuat integrasi acara S3](loading-data-copy-job.md#loading-data-copy-job-prerequisites). + Anda menambahkan kebijakan berbasis sumber daya yang benar ke bucket Amazon S3 sumber. Lihat [Prasyarat untuk membuat integrasi acara S3](loading-data-copy-job.md#loading-data-copy-job-prerequisites). ## Data Amazon S3 Anda tidak muncul di database target Jika data dari COPY JOB tidak muncul, periksa berikut ini. + Kueri SYS\$1COPY\$1JOB\$1DETAIL untuk melihat apakah file Amazon S3 telah dimuat, apakah konsumsi yang tertunda, atau ada kesalahan. Untuk informasi selengkapnya, lihat [SYS\$1COPY\$1JOB\$1DETAIL](SYS_COPY_JOB_DETAIL.md). + Konsultasikan STL\$1ERROR atau SYS\$1COPY\$1JOB\$1INFO jika file Amazon S3 tidak ada atau ada waktu tunggu yang tidak terduga. Cari kesalahan kredensi atau apa pun yang menunjukkan bahwa integrasi tidak aktif. Untuk informasi selengkapnya, lihat [STL\$1ERROR](r_STL_ERROR.md) dan [SYS\$1COPY\$1JOB\$1INFO](SYS_COPY_JOB_INFO.md). # Kesalahan S3 ServiceException ServiceException Kesalahan s3 yang paling umum disebabkan oleh string kredensyal yang diformat dengan tidak benar atau salah, klaster dan bucket Anda berada di Wilayah yang berbeda AWS , serta izin Amazon S3 yang tidak mencukupi. Bagian ini menyediakan informasi pemecahan masalah untuk setiap jenis kesalahan. ## String kredensial tidak valid Jika string kredensil Anda tidak diformat dengan benar, Anda akan menerima pesan galat berikut: ``` ERROR: Invalid credentials. Must be of the format: credentials 'aws_access_key_id=;aws_secret_access_key= [;token=]' ``` Verifikasi bahwa string kredensil tidak mengandung spasi atau jeda baris, dan diapit dalam tanda kutip tunggal. ## ID kunci akses tidak valid Jika ID kunci akses Anda tidak ada, Anda akan menerima pesan galat berikut: ``` [Amazon](500310) Invalid operation: S3ServiceException:The AWS Access Key Id you provided does not exist in our records. ``` Ini sering merupakan kesalahan salin dan tempel. Verifikasi bahwa ID kunci akses telah dimasukkan dengan benar. Juga, jika Anda menggunakan kunci sesi sementara, periksa apakah nilai untuk `token` disetel. ## Kunci akses rahasia tidak valid Jika kunci akses rahasia Anda salah, Anda akan menerima pesan galat berikut: ``` [Amazon](500310) Invalid operation: S3ServiceException:The request signature we calculated does not match the signature you provided. Check your key and signing method.,Status 403,Error SignatureDoesNotMatch ``` Ini sering merupakan kesalahan salin dan tempel. Verifikasi bahwa kunci akses rahasia dimasukkan dengan benar dan itu adalah kunci yang benar untuk ID kunci akses. ## Bucket berada di Wilayah yang berbeda Bucket Amazon S3 yang ditentukan dalam perintah COPY harus berada di AWS Wilayah yang sama dengan cluster. Jika bucket Amazon S3 dan kluster Anda berada di Wilayah yang berbeda, Anda akan menerima kesalahan yang mirip dengan berikut ini: ``` ERROR: S3ServiceException:The bucket you are attempting to access must be addressed using the specified endpoint. ``` Anda dapat membuat bucket Amazon S3 di Wilayah tertentu baik dengan memilih Wilayah saat membuat bucket menggunakan Konsol Manajemen Amazon S3, atau dengan menentukan titik akhir saat membuat bucket menggunakan Amazon S3 API atau CLI. Untuk informasi selengkapnya, lihat [Mengunggah file ke Amazon S3 untuk digunakan dengan COPY](t_uploading-data-to-S3.md). Untuk informasi selengkapnya tentang wilayah Amazon S3, lihat [Mengakses Bucket di Panduan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingBucket.html#access-bucket-intro) Pengguna *Layanan Penyimpanan Sederhana Amazon*. Atau, Anda dapat menentukan Wilayah menggunakan [REGION](copy-parameters-data-source-s3.md#copy-region) opsi dengan perintah COPY. ## Akses ditolak Jika pengguna tidak memiliki izin yang memadai, Anda akan menerima pesan galat berikut: ``` ERROR: S3ServiceException:Access Denied,Status 403,Error AccessDenied ``` Salah satu kemungkinan penyebabnya adalah pengguna yang diidentifikasi oleh kredensialnya tidak memiliki LIST dan GET akses ke bucket Amazon S3. Untuk penyebab lainnya, lihat [Memecahkan masalah kesalahan Akses Ditolak (403 Terlarang) di Amazon S3 di Panduan Pengguna](https://docs.aws.amazon.com/AmazonS3/latest/userguide/troubleshoot-403-errors.html) Layanan Penyimpanan *Sederhana Amazon*. Untuk informasi tentang mengelola akses pengguna ke bucket, lihat [Manajemen identitas dan akses di Amazon](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) S3 di Panduan Pengguna *Layanan Penyimpanan Sederhana Amazon*. # Tabel sistem untuk memecahkan masalah beban data Tabel sistem Amazon Redshift berikut dapat membantu dalam memecahkan masalah pemuatan data: + Kueri [STL\$1LOAD\$1ERRORS](r_STL_LOAD_ERRORS.md) untuk menemukan kesalahan yang terjadi selama pemuatan tertentu. + Kueri [STL\$1FILE\$1SCAN](r_STL_FILE_SCAN.md) untuk melihat waktu muat untuk file tertentu atau untuk melihat apakah file tertentu bahkan dibaca. + Kueri [STL\$1S3CLIENT\$1ERROR](r_STL_S3CLIENT_ERROR.md) untuk menemukan detail untuk kesalahan yang ditemui saat mentransfer data dari Amazon S3. **Untuk menemukan dan mendiagnosis kesalahan beban** 1. Buat tampilan atau tentukan kueri yang mengembalikan detail tentang kesalahan pemuatan. Contoh berikut menggabungkan tabel STL\$1LOAD\$1ERRORS ke tabel STV\$1TBL\$1PERM untuk mencocokkan tabel dengan nama tabel yang sebenarnya. IDs ``` 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); ``` 1. Setel opsi MAXERRORS dalam perintah COPY Anda ke nilai yang cukup besar untuk mengaktifkan COPY untuk mengembalikan informasi yang berguna tentang data Anda. Jika COPY menemukan kesalahan, pesan kesalahan mengarahkan Anda untuk melihat tabel STL\$1LOAD\$1ERRORS untuk detailnya. 1. Kueri tampilan LOADVIEW untuk melihat detail kesalahan. Contoh: ``` select * from loadview where table_name='venue'; ``` ``` tbl | table_name | query | starttime --------+------------+-------+---------------------------- 100551 | venue | 20974 | 2013-01-29 19:05:58.365391 | input | line_number | colname | err_code | reason +----------------+-------------+---------+----------+-------------------- | venue_pipe.txt | 1 | 0 | 1214 | Delimiter not found ``` 1. Perbaiki masalah dalam file input atau skrip pemuatan, berdasarkan informasi yang dikembalikan tampilan. Beberapa kesalahan pemuatan khas yang harus diperhatikan meliputi: + Ketidakcocokan antara tipe data dalam tabel dan nilai di bidang data input. + Ketidakcocokan antara jumlah kolom dalam tabel dan jumlah bidang dalam data input. + Tanda kutip yang tidak cocok. Amazon Redshift mendukung tanda kutip tunggal dan ganda; Namun, tanda kutip ini harus diseimbangkan dengan tepat. + Format date/time data yang salah dalam file input. + Out-of-range nilai dalam file input (untuk kolom numerik). + Jumlah nilai yang berbeda untuk kolom melebihi batasan untuk pengkodean kompresi. # Kesalahan pemuatan karakter multibyte Kolom dengan tipe data CHAR hanya menerima karakter UTF-8 byte tunggal, hingga nilai byte 127, atau 7F hex, yang juga merupakan kumpulan karakter ASCII. Kolom VARCHAR menerima karakter multibyte UTF-8, hingga maksimal empat byte. Untuk informasi selengkapnya, lihat [Jenis karakter](r_Character_types.md). Jika baris dalam data pemuatan Anda berisi karakter yang tidak valid untuk tipe data kolom, COPY mengembalikan kesalahan dan mencatat baris dalam tabel log sistem STL\$1LOAD\$1ERRORS dengan nomor kesalahan 1220. Bidang ERR\$1REASON menyertakan urutan byte, dalam hex, untuk karakter yang tidak valid. Alternatif untuk memperbaiki karakter yang tidak valid dalam data pemuatan Anda adalah dengan mengganti karakter yang tidak valid selama proses pemuatan. Untuk mengganti karakter UTF-8 yang tidak valid, tentukan opsi ACCEPTINVCHARS dengan perintah COPY. Jika opsi ACCEPTINVCHARS diatur, karakter yang Anda tentukan menggantikan titik kode. Jika opsi ACCEPTINVCHARS tidak disetel, Amazon Redshift menerima karakter sebagai UTF-8 yang valid. Untuk informasi selengkapnya, lihat [ACCEPTINVCHARS](copy-parameters-data-conversion.md#acceptinvchars). Daftar poin kode berikut adalah UTF-8 yang valid, operasi COPY tidak mengembalikan kesalahan jika opsi ACCEPTINVCHARS tidak disetel. Namun, poin kode ini bukan karakter yang valid. Anda dapat menggunakan [ACCEPTINVCHARS](copy-parameters-data-conversion.md#acceptinvchars) opsi untuk mengganti titik kode dengan karakter yang Anda tentukan. Poin kode ini mencakup rentang nilai dari `0xFDD0` ke `0xFDEF` dan nilai hingga`0x10FFFF`, diakhiri dengan `FFFE` atau`FFFF`: + `0xFFFE`, `0x1FFFE`, `0x2FFFE`, …, `0xFFFFE`, `0x10FFFE` + `0xFFFF`, `0x1FFFF`, `0x2FFFF`, …, `0xFFFFF`, `0x10FFFF` Contoh berikut menunjukkan alasan kesalahan ketika COPY mencoba untuk memuat karakter UTF-8 `e0 a1 c7a4` ke dalam kolom CHAR. ``` Multibyte character not supported for CHAR (Hint: Try using VARCHAR). Invalid char: e0 a1 c7a4 ``` Jika kesalahan terkait dengan tipe data VARCHAR, alasan kesalahan mencakup kode kesalahan serta urutan hex UTF-8 yang tidak valid. Contoh berikut menunjukkan alasan kesalahan saat COPY mencoba memuat UTF-8 `a4` ke dalam bidang VARCHAR. ``` String contains invalid or unsupported UTF-8 codepoints. Bad UTF-8 hex sequence: a4 (error 3) ``` Tabel berikut mencantumkan deskripsi dan solusi yang disarankan untuk kesalahan pemuatan VARCHAR. Jika salah satu kesalahan ini terjadi, ganti karakter dengan urutan kode UTF-8 yang valid atau hapus karakter. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/dg/multi-byte-character-load-errors.html) # Referensi kesalahan muat Jika terjadi kesalahan saat memuat data dari file, kueri [STL\$1LOAD\$1ERRORS](r_STL_LOAD_ERRORS.md) tabel untuk mengidentifikasi kesalahan dan menentukan penjelasan yang mungkin. Tabel berikut mencantumkan semua kode kesalahan yang mungkin terjadi selama pemuatan data: ## Memuat kode kesalahan [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/dg/r_Load_Error_Reference.html)