Amazon Redshift tidak akan lagi mendukung pembuatan UDF Python baru mulai Patch 198. UDF Python yang ada 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.
# Parameter otorisasi
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 AWS Identity and Access Management (IAM)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) yang dilampirkan ke klaster Anda (kontrol akses berbasis *peran*). Anda dapat mengenkripsi data pemuatan Anda di Amazon S3.
Topik berikut memberikan rincian lebih lanjut dan contoh opsi otentikasi:
+ [Izin IAM untuk COPY, UNLOAD, dan CREATE LIBRARY](copy-usage_notes-access-permissions.md#copy-usage_notes-iam-permissions)
+ [Role-based kontrol akses](copy-usage_notes-access-permissions.md#copy-usage_notes-access-role-based)
+ [Key-based kontrol akses](copy-usage_notes-access-permissions.md#copy-usage_notes-access-key-based)
Gunakan salah satu dari berikut ini untuk memberikan otorisasi untuk perintah COPY:
+ [Menggunakan parameter IAM\_ROLE](#copy-iam-role)parameter
+ Parameter [Menggunakan parameter ACCESS\_KEY\_ID dan SECRET\_ACCESS\_KEY](#copy-access-key-id)
+ Klausa [Menggunakan parameter CREDENTIALS](#copy-credentials)
## Menggunakan parameter IAM\_ROLE
### IAM\_ROLE
Gunakan kata kunci default agar Amazon Redshift menggunakan peran IAM yang ditetapkan sebagai default dan terkait dengan cluster saat perintah COPY berjalan.
Gunakan Amazon Resource Name (ARN) untuk peran IAM yang digunakan klaster Anda untuk autentikasi dan otorisasi. Jika Anda menentukan IAM\_ROLE, Anda tidak dapat menggunakan ACCESS\_KEY\_ID dan SECRET\_ACCESS\_KEY, SESSION\_TOKEN, atau CREDENTIALS.
Berikut ini menunjukkan sintaks untuk parameter IAM\_ROLE.
```
IAM_ROLE { default | 'arn:aws:iam::{{}}:role/{{}}' }
```
Untuk informasi selengkapnya, lihat [Role-based kontrol akses](copy-usage_notes-access-permissions.md#copy-usage_notes-access-role-based).
## Menggunakan parameter ACCESS\_KEY\_ID dan SECRET\_ACCESS\_KEY
### ACCESS\_KEY\_ID, SECRET\_ACCESS\_KEY
Metode otorisasi ini tidak disarankan.
**catatan**
Alih-alih memberikan kredensyal akses sebagai teks biasa, kami sangat menyarankan menggunakan otentikasi berbasis peran dengan menentukan parameter IAM\_ROLE. Untuk informasi selengkapnya, lihat [Role-based kontrol akses](copy-usage_notes-access-permissions.md#copy-usage_notes-access-role-based).
### SESSION\_TOKEN
Token sesi untuk digunakan dengan kredensil akses sementara. Ketika SESSION\_TOKEN ditentukan, Anda juga harus menggunakan ACCESS\_KEY\_ID dan SECRET\_ACCESS\_KEY untuk memberikan kredensyal kunci akses sementara. Jika Anda menentukan SESSION\_TOKEN, Anda tidak dapat menggunakan IAM\_ROLE atau CREDENTIALS. Untuk informasi selengkapnya, lihat [Kredensial keamanan sementara](copy-usage_notes-access-permissions.md#r_copy-temporary-security-credentials) di Panduan Pengguna IAM.
**catatan**
Alih-alih membuat kredensyal keamanan sementara, kami sangat menyarankan untuk menggunakan otentikasi berbasis peran. Saat Anda mengotorisasi penggunaan peran IAM, Amazon Redshift secara otomatis membuat kredensyal pengguna sementara untuk setiap sesi. Untuk informasi selengkapnya, lihat [Role-based kontrol akses](copy-usage_notes-access-permissions.md#copy-usage_notes-access-role-based).
Berikut ini menunjukkan sintaks untuk parameter SESSION\_TOKEN dengan parameter ACCESS\_KEY\_ID dan SECRET\_ACCESS\_KEY.
```
ACCESS_KEY_ID '{{}}'
SECRET_ACCESS_KEY '{{}}'
SESSION_TOKEN '{{}}';
```
Jika Anda menentukan SESSION\_TOKEN, Anda tidak dapat menggunakan CREDENTIALS atau IAM\_ROLE.
## Menggunakan parameter CREDENTIALS
### KREDENSIAL
Klausa yang menunjukkan metode yang akan digunakan cluster Anda saat mengakses AWS sumber daya lain yang berisi file data atau file manifes. Anda tidak dapat menggunakan parameter CREDENTIALS dengan IAM\_ROLE atau ACCESS\_KEY\_ID dan SECRET\_ACCESS\_KEY.
Berikut ini menunjukkan sintaks untuk parameter CREDENTIALS.
```
[WITH] CREDENTIALS [AS] 'credentials-args'
```
**catatan**
Untuk meningkatkan fleksibilitas, sebaiknya gunakan [IAM\_ROLE](#copy-iam-role-iam) parameter alih-alih parameter CREDENTIALS.
Secara opsional, jika [ENCRYPTED](copy-parameters-data-source-s3.md#copy-encrypted) parameter digunakan, string *credentials-args* juga menyediakan kunci enkripsi.
String *credentials-args* bersifat case-sensitive dan tidak boleh berisi spasi.
Kata kunci WITH dan AS bersifat opsional dan diabaikan.
Anda dapat menentukan [role-based access control](copy-usage_notes-access-permissions.md#copy-usage_notes-access-role-based.phrase) atau [key-based access control](copy-usage_notes-access-permissions.md#copy-usage_notes-access-key-based.phrase). Dalam kedua kasus, peran IAM atau pengguna harus memiliki izin yang diperlukan untuk mengakses sumber daya yang ditentukan AWS . Untuk informasi selengkapnya, lihat [Izin IAM untuk COPY, UNLOAD, dan CREATE LIBRARY](copy-usage_notes-access-permissions.md#copy-usage_notes-iam-permissions).
**catatan**
Untuk melindungi AWS kredensyal Anda dan melindungi data sensitif, kami sangat menyarankan untuk menggunakan kontrol akses berbasis peran.
Untuk menentukan kontrol akses berbasis peran, berikan string *credentials-args* dalam format berikut.
```
'aws_iam_role=arn:aws:iam::{{}}:role/{{}}'
```
Untuk menggunakan kredensil token sementara, Anda harus memberikan ID kunci akses sementara, kunci akses rahasia sementara, dan token sementara. String *credentials-args* dalam format berikut.
```
CREDENTIALS
'aws_access_key_id={{}};aws_secret_access_key={{}};token={{}}'
```
Perintah COPY menggunakan kontrol akses berbasis peran dengan kredensyal sementara akan menyerupai pernyataan contoh berikut:
```
COPY customer FROM 's3://amzn-s3-demo-bucket/mydata'
CREDENTIALS
'aws_access_key_id={{}};aws_secret_access_key={{}};token={{}}'
```
Untuk informasi selengkapnya, lihat [Kredensial keamanan sementara](copy-usage_notes-access-permissions.md#r_copy-temporary-security-credentials).
Jika [ENCRYPTED](copy-parameters-data-source-s3.md#copy-encrypted) parameter digunakan, string *credentials-args* dalam format berikut, di mana {{}} nilai kunci root yang digunakan untuk mengenkripsi file.
```
CREDENTIALS
'{{}};master_symmetric_key={{}}'
```
Perintah COPY menggunakan kontrol akses berbasis peran dengan kunci enkripsi akan menyerupai pernyataan contoh berikut:
```
COPY customer FROM 's3://amzn-s3-demo-bucket/mydata'
CREDENTIALS
'aws_iam_role=arn:aws:iam::{{}}:role/{{}};master_symmetric_key={{}}'
```