COPY JOB (pratinjau)

Ini adalah dokumentasi prarilis untuk autocopy (SQL COPY JOB), yang dalam rilis pratinjau. Dokumentasi dan fitur dapat berubah. Sebaiknya gunakan fitur ini hanya dalam lingkungan pengujian, bukan dalam lingkungan produksi. Pratinjau publik akan berakhir pada 31 Juli 2024. Cluster pratinjau akan dihapus secara otomatis dua minggu setelah akhir pratinjau. Untuk syarat dan ketentuan pratinjau, lihat Beta dan Pratinjau dalam Persyaratan Layanan AWS.

Untuk informasi tentang menggunakan perintah ini di pratinjau, lihatKonsumsi file berkelanjutan dari Amazon S3 (pratinjau).

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 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 penyalinan. Parameter perintah COPY disimpan dengan pekerjaan salin.

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.

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.

[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://mybucket-bucket/staging-folder'
IAM_ROLE 'arn:aws:iam::123456789012:role/MyLoadRoleName' 
JOB CREATE my_copy_job_name
AUTO ON;