COPYJOB(pratinjau) - Amazon Redshift
Izin yang diperlukanSintaksParameterCatatan penggunaanContoh

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

COPYJOB(pratinjau)

Ini adalah dokumentasi prarilis untuk autocopy (SQLCOPYJOB), 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 Oktober 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, lihatMemuat tabel dengan konsumsi file terus menerus dari Amazon S3 (pratinjau).

Mengelola COPY perintah yang memuat data ke dalam tabel. COPYJOBPerintah ini merupakan perpanjangan dari COPY perintah dan mengotomatiskan pemuatan data dari bucket Amazon S3. Saat Anda membuat COPY pekerjaan, 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 COPY perintah asli digunakan saat memuat data. Amazon Redshift melacak file yang dimuat untuk memverifikasi bahwa file tersebut dimuat hanya satu kali.

catatan

Untuk informasi tentang COPY perintah, termasuk penggunaan, parameter, dan izin, lihatCOPY.

Izin yang diperlukan

Untuk menjalankan COPY perintah a COPYJOB, Anda harus memiliki INSERT hak istimewa tabel yang dimuat.

IAMPeran yang ditentukan dengan COPY perintah harus memiliki izin untuk mengakses data yang akan dimuat. Untuk informasi selengkapnya, lihat IAMizin untukCOPY,UNLOAD, dan CREATE LIBRARY.

Sintaks

Buat pekerjaan salinan. Parameter COPY perintah 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 COPY perintah 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

COPYPerintah yang memuat data dari Amazon S3 ke Amazon Redshift. Klausa berisi COPY parameter yang menentukan bucket Amazon S3, tabel target, peranIAM, dan parameter lain yang digunakan saat memuat data. Semua parameter COPY perintah untuk pemuatan data Amazon S3 didukung kecuali:

  • COPYJOBItu tidak menelan file yang sudah ada sebelumnya di folder yang ditunjukkan oleh perintah. COPY Hanya file yang dibuat setelah stempel waktu COPY JOB pembuatan yang dicerna.

  • Anda tidak dapat menentukan COPY perintah dengan IGNOREALLERRORS opsi MAXERROR atau.

  • Anda tidak dapat menentukan file manifes. COPYJOBmemerlukan lokasi Amazon S3 yang ditunjuk untuk memantau file yang baru dibuat.

  • Anda tidak dapat menentukan COPY perintah dengan jenis otorisasi seperti kunci Akses dan Rahasia. Hanya COPY perintah yang menggunakan IAM_ROLE parameter untuk otorisasi yang didukung. Untuk informasi selengkapnya, lihat Parameter otorisasi.

  • COPYJOBTidak mendukung IAM peran default yang terkait dengan cluster. Anda harus menentukan COPY perintah IAM_ROLE dalam.

Untuk informasi selengkapnya, lihat COPYdari Amazon S3.

nama-pekerjaan

Nama pekerjaan yang digunakan untuk mereferensikan COPY pekerjaan.

[AUTOPADA |OFF]

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, COPY perintah dijalankan dengan parameter dalam COPY definisi pekerjaan. Ini adalah opsi default.

  • KapanOFF, Amazon Redshift tidak berjalan secara otomatis. COPY JOB

Catatan penggunaan

Opsi COPY perintah tidak divalidasi hingga waktu berjalan. Misalnya, sumber data Amazon S3 yang tidak valid IAM_ROLE atau menghasilkan kesalahan runtime saat dimulai. COPY JOB

Jika cluster dijeda, tidak COPY JOBS dijalankan.

Untuk meminta file COPY perintah dimuat dan memuat kesalahan, lihatSTL_LOAD_COMMITS,STL_LOAD_ERRORS,STL_LOADERROR_DETAIL. Untuk informasi selengkapnya, lihat Memverifikasi bahwa data dimuat dengan benar.

Contoh

Contoh berikut menunjukkan pembuatan data COPY JOB untuk memuat 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;