SALIN PEKERJAAN

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 menggunakan perintah COPY JOB, Anda harus memiliki salah satu izin berikut selain semua izin yang diperlukan untuk menggunakan COPY:

• Superuser

• Semua hal berikut:

  • Izin cakupan CREATE, ALTER, atau DROP yang relevan untuk COPY JOBS dalam database yang ingin Anda SALIN.

  • Izin PENGGUNAAN untuk skema yang ingin Anda SALIN, atau izin cakupan PENGGUNAAN untuk skema dalam database yang ingin Anda SALIN.

  • Izin INSERT untuk tabel yang ingin Anda SALIN, atau INSERT izin cakupan untuk tabel dalam skema atau database yang ingin Anda SALIN.

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_ROLE parameter 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_ROLE dalam 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.

• SaatON, 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.

• SaatOFF, 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;