Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Untuk informasi tentang menggunakan perintah ini, lihatBuat integrasi acara S3 untuk menyalin file secara otomatis dari bucket Amazon S3.
Mengelola perintah COPY yang memuat data ke dalam tabel. Perintah COPY JOB adalah perpanjangan dari perintah COPY dan mengotomatiskan pemuatan data dari bucket Amazon S3. Saat Anda membuat pekerjaan COPY, Amazon Redshift mendeteksi kapan file Amazon S3 baru dibuat di jalur yang ditentukan, lalu memuatnya secara otomatis tanpa campur tangan Anda. Parameter yang sama yang digunakan dalam perintah COPY asli digunakan saat memuat data. Amazon Redshift melacak file yang dimuat (berdasarkan nama file) untuk memverifikasi bahwa file tersebut dimuat hanya satu kali.
catatan
Untuk informasi tentang perintah COPY, termasuk penggunaan, parameter, dan izin, lihatMENYONTEK.
Izin yang diperlukan
Untuk menjalankan perintah COPY dari COPY JOB, Anda harus memiliki hak istimewa INSERT dari tabel yang sedang dimuat.
Peran IAM yang ditentukan dengan perintah COPY harus memiliki izin untuk mengakses data yang akan dimuat. Untuk informasi selengkapnya, lihat Izin IAM untuk COPY, UNLOAD, dan CREATE LIBRARY.
Sintaks
Buat pekerjaan salinan. Parameter perintah COPY disimpan dengan pekerjaan salin.
Anda tidak dapat menjalankan COPY JOB CREATE dalam lingkup blok transaksi.
COPY copy-command JOB CREATE job-name [AUTO ON | OFF]
Ubah konfigurasi pekerjaan penyalinan.
COPY JOB ALTER job-name [AUTO ON | OFF]
Jalankan pekerjaan penyalinan. Parameter perintah COPY yang disimpan digunakan.
COPY JOB RUN job-name
Buat daftar semua pekerjaan salinan.
COPY JOB LIST
Tampilkan detail pekerjaan penyalinan.
COPY JOB SHOW job-name
Hapus pekerjaan penyalinan.
Anda tidak dapat menjalankan COPY JOB DROP dalam lingkup blok transaksi.
COPY JOB DROP job-name
Parameter
- salin-perintah
-
Perintah COPY yang memuat data dari Amazon S3 ke Amazon Redshift. Klausa berisi parameter COPY yang menentukan bucket Amazon S3, tabel target, peran IAM, dan parameter lain yang digunakan saat memuat data. Semua parameter perintah COPY untuk pemuatan data Amazon S3 didukung kecuali:
-
COPY JOB tidak menyerap file yang sudah ada sebelumnya di folder yang ditunjuk oleh perintah COPY. Hanya file yang dibuat setelah stempel waktu pembuatan COPY JOB yang dicerna.
Anda tidak dapat menentukan perintah COPY dengan opsi MAXERROR atau IGNOREALLERRORS.
Anda tidak dapat menentukan file manifes. COPY JOB memerlukan lokasi Amazon S3 yang ditunjuk untuk memantau file yang baru dibuat.
Anda tidak dapat menentukan perintah COPY dengan jenis otorisasi seperti kunci Akses dan Rahasia. Hanya perintah COPY yang menggunakan
IAM_ROLEparameter untuk otorisasi yang didukung. Untuk informasi selengkapnya, lihat Parameter otorisasi.COPY JOB tidak mendukung peran IAM default yang terkait dengan cluster. Anda harus menentukan
IAM_ROLEdalam perintah COPY.
Untuk informasi selengkapnya, lihat SALIN dari Amazon S3.
-
- nama-pekerjaan
-
Nama pekerjaan yang digunakan untuk mereferensikan pekerjaan COPY. Nama pekerjaan tidak dapat berisi tanda hubung (‐).
- [OTOMATIS HIDUP | MATI]
-
Klausul yang menunjukkan apakah data Amazon S3 dimuat secara otomatis ke dalam tabel Amazon Redshift.
Saat
ON, Amazon Redshift memantau jalur sumber Amazon S3 untuk file yang baru dibuat, dan jika ditemukan, perintah COPY dijalankan dengan parameter COPY dalam definisi pekerjaan. Ini adalah opsi default.Saat
OFF, Amazon Redshift tidak menjalankan COPY JOB secara otomatis.
Catatan penggunaan
Opsi perintah COPY tidak divalidasi hingga waktu berjalan. Misalnya, sumber data Amazon S3 yang tidak valid IAM_ROLE atau menghasilkan kesalahan waktu proses saat COPY JOB dimulai.
Jika cluster dijeda, COPY JOBS tidak dijalankan.
Untuk menanyakan file perintah COPY yang dimuat dan memuat kesalahan, lihatSTL_LOAD_COMMIT,STL_LOAD_ERRORS,STL_LOADERROR_DETAIL. Untuk informasi selengkapnya, lihat Memverifikasi bahwa data dimuat dengan benar.
Contoh
Contoh berikut menunjukkan pembuatan COPY JOB untuk memuat data dari bucket Amazon S3.
COPY public.target_table
FROM 's3://amzn-s3-demo-bucket/staging-folder'
IAM_ROLE 'arn:aws:iam::123456789012:role/MyLoadRoleName'
JOB CREATE my_copy_job_name
AUTO ON;
