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.
# MENYONTEK
| |
| --- |
| Enkripsi sisi klien untuk perintah COPY dan UNLOAD tidak akan lagi terbuka untuk pelanggan baru mulai 30 April 2025. Jika Anda menggunakan enkripsi sisi klien dengan perintah COPY dan UNLOAD dalam 12 bulan sebelum 30 April 2025, Anda dapat terus menggunakan enkripsi sisi klien dengan perintah COPY atau UNLOAD hingga 30 April 2026. Setelah 30 April 2026, Anda tidak akan dapat menggunakan enkripsi sisi klien untuk COPY dan UNLOAD. Kami menyarankan Anda beralih menggunakan enkripsi sisi server untuk COPY dan UNLOAD sesegera mungkin. Jika Anda sudah menggunakan enkripsi sisi server untuk COPY dan UNLOAD, tidak ada perubahan dan Anda dapat terus menggunakannya tanpa mengubah kueri Anda. Untuk informasi selengkapnya tentang enkripsi untuk COPY dan UNLOAD, lihat parameter ENCRYPTED di bawah ini. |
Memuat data ke dalam tabel dari file data atau dari tabel Amazon DynamoDB. File dapat ditemukan di bucket Amazon Simple Storage Service (Amazon S3), cluster EMR Amazon, atau host jarak jauh yang diakses menggunakan koneksi Secure Shell (SSH).
**catatan**
Tabel eksternal Amazon Redshift Spectrum hanya bisa dibaca. Anda tidak dapat MENYALIN ke tabel eksternal.
Perintah COPY menambahkan data input sebagai baris tambahan ke tabel.
Ukuran maksimum satu baris input dari sumber apa pun adalah 4 MB.
**Topics**
+ [Izin yang diperlukan](#r_COPY-permissions)
+ [COPY sintaks](#r_COPY-syntax)
+ [Parameter yang diperlukan](#r_COPY-syntax-required-parameters)
+ [Parameter opsional](#r_COPY-syntax-overview-optional-parameters)
+ [Catatan penggunaan dan sumber daya tambahan untuk perintah COPY](#r_COPY-using-the-copy-command)
+ [COPY contoh perintah](#r_COPY-using-the-copy-command-examples)
+ [SALIN PEKERJAAN](r_COPY-JOB.md)
+ [COPY dengan TEMPLATE](r_COPY-WITH-TEMPLATE.md)
+ [Referensi parameter COPY](r_COPY-parameters.md)
+ [Catatan penggunaan](r_COPY_usage_notes.md)
+ [Contoh COPY](r_COPY_command_examples.md)
## Izin yang diperlukan
Untuk menggunakan perintah COPY, Anda harus memiliki [INSERT](r_GRANT.md#grant-insert) hak istimewa untuk tabel Amazon Redshift.
## COPY sintaks
```
COPY table-name
[ column-list ]
FROM data_source
authorization
[ [ FORMAT ] [ AS ] data_format ]
[ parameter [ argument ] [, ... ] ]
```
Anda dapat melakukan operasi COPY dengan sedikitnya tiga parameter: nama tabel, sumber data, dan otorisasi untuk mengakses data.
Amazon Redshift memperluas fungsionalitas perintah COPY untuk memungkinkan Anda memuat data dalam beberapa format data dari berbagai sumber data, mengontrol akses untuk memuat data, mengelola transformasi data, dan mengelola operasi pemuatan.
Bagian berikut menyajikan parameter perintah COPY yang diperlukan, mengelompokkan parameter opsional berdasarkan fungsi. Mereka juga menjelaskan setiap parameter dan menjelaskan bagaimana berbagai opsi bekerja sama. Anda dapat langsung menuju deskripsi parameter dengan menggunakan daftar parameter alfabet.
## Parameter yang diperlukan
Perintah COPY membutuhkan tiga elemen:
+ [Table Name](#r_COPY-syntax-overview-table-name)
+ [Data Source](#r_COPY-syntax-overview-data-source)
+ [Authorization](#r_COPY-syntax-overview-credentials)
Perintah COPY paling sederhana menggunakan format berikut.
```
COPY table-name
FROM data-source
authorization;
```
Contoh berikut membuat tabel bernama CATDEMO, dan kemudian memuat tabel dengan data sampel dari file data di Amazon `category_pipe.txt` S3 bernama.
```
create table catdemo(catid smallint, catgroup varchar(10), catname varchar(10), catdesc varchar(50));
```
Dalam contoh berikut, sumber data untuk perintah COPY adalah file data bernama `category_pipe.txt` dalam `tickit` folder bucket Amazon S3 bernama. `redshift-downloads` Perintah COPY diizinkan untuk mengakses bucket Amazon S3 melalui peran AWS Identity and Access Management (IAM). Jika klaster Anda memiliki peran IAM yang sudah ada dengan izin untuk mengakses Amazon S3 terlampir, Anda dapat mengganti Nama Sumber Daya Amazon (ARN) peran Anda dalam perintah COPY berikut dan menjalankannya.
```
copy catdemo
from 's3://redshift-downloads/tickit/category_pipe.txt'
iam_role 'arn:aws:iam::{{}}:role/{{}}'
region 'us-east-1';
```
Untuk petunjuk lengkap tentang cara menggunakan perintah COPY untuk memuat data sampel, termasuk petunjuk untuk memuat data dari AWS wilayah lain, lihat Memuat [Data Sampel dari Amazon S3 di Panduan](https://docs.aws.amazon.com/redshift/latest/gsg/rs-gsg-create-sample-db.html) Memulai Amazon Redshift.
*nama-meja*
Nama tabel target untuk perintah COPY. Tabel harus sudah ada dalam basis data. Tabel bisa bersifat sementara atau persisten. Perintah COPY menambahkan data input baru ke setiap baris yang ada dalam tabel.
DARI *data-sumber*
Lokasi data sumber yang akan dimuat ke dalam tabel target. File manifes dapat ditentukan dengan beberapa sumber data.
Repositori data yang paling umum digunakan adalah bucket Amazon S3. Anda juga dapat memuat dari file data yang terletak di kluster EMR Amazon, instans Amazon EC2, atau host jarak jauh yang dapat diakses kluster menggunakan koneksi SSH, atau Anda dapat memuat langsung dari tabel DynamoDB.
+ [SALIN dari Amazon S3](copy-parameters-data-source-s3.md)
+ [SALIN dari Amazon EMR](copy-parameters-data-source-emr.md)
+ [COPY dari host jarak jauh (SSH)](copy-parameters-data-source-ssh.md)
+ [SALIN dari Amazon DynamoDB](copy-parameters-data-source-dynamodb.md)
Otorisasi
Klausa yang menunjukkan metode yang digunakan klaster Anda untuk otentikasi dan otorisasi untuk mengakses sumber daya lain. AWS Perintah COPY memerlukan otorisasi untuk mengakses data di AWS sumber daya lain, termasuk di Amazon S3, Amazon EMR, Amazon DynamoDB, dan Amazon EC2. Anda dapat memberikan otorisasi tersebut dengan mereferensikan peran IAM yang dilampirkan ke klaster Anda atau dengan memberikan ID kunci akses dan kunci akses rahasia untuk pengguna IAM.
+ [Parameter otorisasi](copy-parameters-authorization.md)
+ [Kontrol akses berbasis peran](copy-usage_notes-access-permissions.md#copy-usage_notes-access-role-based)
+ [Kontrol akses berbasis kunci](copy-usage_notes-access-permissions.md#copy-usage_notes-access-key-based)
## Parameter opsional
Anda dapat secara opsional menentukan cara COPY memetakan data bidang ke kolom di tabel target, menentukan atribut data sumber untuk mengaktifkan perintah COPY membaca dan mengurai data sumber dengan benar, dan mengelola operasi mana yang dilakukan perintah COPY selama proses pemuatan.
+ [Opsi pemetaan kolom](copy-parameters-column-mapping.md)
+ [Parameter format data](#r_COPY-syntax-overview-data-format)
+ [Parameter konversi data](#r_COPY-syntax-overview-data-conversion)
+ [Operasi pemuatan data](#r_COPY-syntax-overview-data-load)
### Pemetaan kolom
Secara default, COPY menyisipkan nilai bidang ke kolom tabel target dalam urutan yang sama seperti bidang yang terjadi dalam file data. Jika urutan kolom default tidak akan berfungsi, Anda dapat menentukan daftar kolom atau menggunakan JSONPath ekspresi untuk memetakan bidang data sumber ke kolom target.
+ [Column List](copy-parameters-column-mapping.md#copy-column-list)
+ [JSONPaths File](copy-parameters-column-mapping.md#copy-column-mapping-jsonpaths)
### Parameter format data
Anda dapat memuat data dari file teks dalam lebar tetap, dibatasi karakter, nilai dipisahkan koma (CSV), atau format JSON, atau dari file Avro.
Secara default, perintah COPY mengharapkan data sumber berada dalam file teks UTF-8 yang dibatasi karakter. Pembatas default adalah karakter pipa (\|). Jika data sumber dalam format lain, gunakan parameter berikut untuk menentukan format data.
+ [FORMAT](copy-parameters-data-format.md#copy-format)
+ [CSV](copy-parameters-data-format.md#copy-csv)
+ [DELIMITER](copy-parameters-data-format.md#copy-delimiter)
+ [FIXEDWIDTH](copy-parameters-data-format.md#copy-fixedwidth)
+ [SHAPEFILE](copy-parameters-data-format.md#copy-shapefile)
+ [AVRO](copy-parameters-data-format.md#copy-avro)
+ [JSON format for COPY](copy-parameters-data-format.md#copy-json)
+ [ENCRYPTED](copy-parameters-data-source-s3.md#copy-encrypted)
+ [BZIP2](copy-parameters-file-compression.md#copy-bzip2)
+ [GZIP](copy-parameters-file-compression.md#copy-gzip)
+ [LZOP](copy-parameters-file-compression.md#copy-lzop)
+ [PARQUET](copy-parameters-data-format.md#copy-parquet)
+ [ORC](copy-parameters-data-format.md#copy-orc)
+ [ZSTD](copy-parameters-file-compression.md#copy-zstd)
### Parameter konversi data
Saat memuat tabel, COPY mencoba untuk secara implisit mengonversi string dalam data sumber ke tipe data kolom target. Jika Anda perlu menentukan konversi yang berbeda dari perilaku default, atau jika konversi default menghasilkan kesalahan, Anda dapat mengelola konversi data dengan menentukan parameter berikut.
+ [ACCEPTANYDATE](copy-parameters-data-conversion.md#copy-acceptanydate)
+ [ACCEPTINVCHARS](copy-parameters-data-conversion.md#copy-acceptinvchars)
+ [BLANKSASNULL](copy-parameters-data-conversion.md#copy-blanksasnull)
+ [DATEFORMAT](copy-parameters-data-conversion.md#copy-dateformat)
+ [EMPTYASNULL](copy-parameters-data-conversion.md#copy-emptyasnull)
+ [ENCODING](copy-parameters-data-conversion.md#copy-encoding)
+ [ESCAPE](copy-parameters-data-conversion.md#copy-escape)
+ [EXPLICIT_IDS](copy-parameters-data-conversion.md#copy-explicit-ids)
+ [FILLRECORD](copy-parameters-data-conversion.md#copy-fillrecord)
+ [IGNOREBLANKLINES](copy-parameters-data-conversion.md#copy-ignoreblanklines)
+ [IGNOREHEADER](copy-parameters-data-conversion.md#copy-ignoreheader)
+ [NULL AS](copy-parameters-data-conversion.md#copy-null-as)
+ [REMOVEQUOTES](copy-parameters-data-conversion.md#copy-removequotes)
+ [ROUNDEC](copy-parameters-data-conversion.md#copy-roundec)
+ [TIMEFORMAT](copy-parameters-data-conversion.md#copy-timeformat)
+ [TRIMBLANKS](copy-parameters-data-conversion.md#copy-trimblanks)
+ [TRUNCATECOLUMNS](copy-parameters-data-conversion.md#copy-truncatecolumns)
### Operasi pemuatan data
Kelola perilaku default operasi pemuatan untuk pemecahan masalah atau untuk mengurangi waktu muat dengan menentukan parameter berikut.
+ [COMPROWS](copy-parameters-data-load.md#copy-comprows)
+ [COMPUPDATE](copy-parameters-data-load.md#copy-compupdate)
+ [IGNOREALLERRORS](copy-parameters-data-load.md#copy-ignoreallerrors)
+ [MAXERROR](copy-parameters-data-load.md#copy-maxerror)
+ [NOLOAD](copy-parameters-data-load.md#copy-noload)
+ [STATUPDATE](copy-parameters-data-load.md#copy-statupdate)
## Catatan penggunaan dan sumber daya tambahan untuk perintah COPY
Untuk informasi selengkapnya tentang cara menggunakan perintah COPY, lihat topik berikut:
+ [Catatan penggunaan](r_COPY_usage_notes.md)
+ [Tutorial: Memuat data dari Amazon S3](tutorial-loading-data.md)
+ [Praktik terbaik Amazon Redshift untuk memuat data](c_loading-data-best-practices.md)
+ [Memuat tabel dengan perintah COPY](t_Loading_tables_with_the_COPY_command.md)
+ [Memuat data dari Amazon S3](t_Loading-data-from-S3.md)
+ [Memuat data dari Amazon EMR](loading-data-from-emr.md)
+ [Memuat data dari host jarak jauh](loading-data-from-remote-hosts.md)
+ [Memuat data dari tabel Amazon DynamoDB](t_Loading-data-from-dynamodb.md)
+ [Memecahkan masalah beban data](t_Troubleshooting_load_errors.md)
## COPY contoh perintah
Untuk contoh lainnya yang menunjukkan cara MENYALIN dari berbagai sumber, dalam format yang berbeda, dan dengan opsi COPY yang berbeda, lihat. [Contoh COPY](r_COPY_command_examples.md)