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.

# Connect ke cluster dengan Amazon Redshift RSQL
<a name="rsql-query-tool-starting-tool-connection"></a>

Dengan Amazon Redshift, Anda dapat terhubung ke cluster dan berinteraksi dengannya menggunakan RSQL. Ini adalah alat baris perintah yang menyediakan cara aman untuk menanyakan data, membuat objek database, dan mengelola cluster Amazon Redshift Anda. Bagian berikut memandu Anda melalui langkah-langkah untuk membuat koneksi ke cluster Anda menggunakan RSQL dengan dan tanpa nama sumber data (DSN).

## Menghubungkan tanpa DSN
<a name="rsql-query-tool-starting-tool-connection-dsn-less-example"></a>

1. Di konsol Amazon Redshift, pilih cluster yang ingin Anda sambungkan dan catat titik akhir, database, dan port.

1. Pada prompt perintah, tentukan informasi koneksi dengan menggunakan parameter baris perintah.

   ```
   rsql -h <endpoint> -U <username> -d <databasename> -p <port>
   ```

    Di sini, berikut ini berlaku: 
   +  *<endpoint>*adalah **Endpoint** yang Anda rekam pada langkah sebelumnya.
   +  *<username>*adalah nama pengguna dengan izin untuk terhubung ke cluster.
   +  *<databasename>*adalah **Nama Database** yang Anda rekam pada langkah sebelumnya.
   +  *<port>*adalah **Port** yang Anda rekam pada langkah sebelumnya. *<port>*adalah parameter opsional.

   Berikut contohnya.

   ```
   rsql -h testcluster.example.amazonaws.com -U user1 -d dev -p 5439
   ```

1.  Pada prompt kata sandi, masukkan kata sandi untuk *<username>* pengguna.

   Respons koneksi yang berhasil terlihat seperti berikut ini.

   ```
   % rsql -h testcluster.example.com -d dev -U user1 -p 5349
   Password for user user1:
   DSN-less Connected
   DBMS Name: Amazon Redshift
   Driver Name: Amazon Redshift ODBC Driver
   Driver Version: 1.4.27.1000
   Rsql Version: 1.0.1
   Redshift Version: 1.0.29306
   Type "help" for help.
   
   (testcluster) user1@dev=#
   ```

Perintah untuk menghubungkan memiliki parameter yang sama di Linux, Mac OS, dan Windows.

## Menghubungkan dengan DSN
<a name="rsql-query-tool-starting-tool-connection-dsn-example"></a>

Anda dapat menghubungkan RSQL ke Amazon Redshift dengan menggunakan DSN untuk menyederhanakan organisasi properti koneksi. Topik ini mencakup instruksi untuk instalasi ODBC-driver dan deskripsi untuk properti DSN.

### Menggunakan koneksi DSN dengan kata sandi
<a name="rsql-query-tool-starting-tool-connection-dsn-example-password"></a>

Berikut ini menunjukkan contoh konfigurasi koneksi DSN yang menggunakan kata sandi. Default `<path to driver>` untuk Mac OSX adalah `/opt/amazon/redshift/lib/libamazonredshiftodbc.dylib` dan untuk Linux adalah`/opt/amazon/redshiftodbc/lib/64/libamazonredshiftodbc64.so`.

```
[testuser]
Driver=/opt/amazon/redshiftodbc/lib/64/libamazonredshiftodbc64.so
SSLMode=verify-ca
Min_TLS=1.2
boolsaschar=0
Host=<server endpoint>
Port=<database port>
Database=<dbname>
UID=<username>
PWD=<password>
sslmode=prefer
```

Hasil output berikut dari koneksi yang berhasil.

```
% rsql -D testuser
DSN Connected
DBMS Name: Amazon Redshift
Driver Name: Amazon Redshift ODBC Driver
Driver Version: 1.4.27.1000
Rsql Version: 1.0.1
Redshift Version: 1.0.29306
Type "help" for help.

(testcluster) user1@dev=#
```

### Menggunakan DSN masuk tunggal
<a name="rsql-query-tool-starting-tool-connection-dsn"></a>

Anda dapat mengonfigurasi DSN untuk otentikasi masuk tunggal. Berikut ini menunjukkan contoh konfigurasi koneksi DSN yang menggunakan tanda tunggal Okta.

```
[testokta]
Driver=<path to driver>
SSLMode=verify-ca
Min_TLS=1.2
boolsaschar=0
Host=<server endpoint>
clusterid=<cluster id>
region=<region name>
Database=<dbname>
locale=en-US
iam=1
plugin_name=<plugin name>
uid=<okta username>
pwd=<okta password>
idp_host=<idp endpoint>
app_id=<app id>
app_name=<app name>
preferred_role=<role arn>
```

Contoh output dari koneksi yang berhasil.

```
% rsql -D testokta 
DSN Connected
DBMS Name: Amazon Redshift
Driver Name: Amazon Redshift ODBC Driver
Driver Version: 1.4.27.1000
Rsql Version: 1.0.1
Redshift Version: 1.0.29306
Type "help" for help.

(testcluster) user1@dev=#
```

Contoh berikut menunjukkan contoh konfigurasi koneksi DSN yang menggunakan tanda tunggal Azure.

```
[testazure]
Driver=<path to driver>
SSLMode=verify-ca
Min_TLS=1.2
boolsaschar=0
Host=<server endpoint>
Port=<cluster port>
clusterid=<cluster id>
region=<region name>
Database=<dbname>
locale=en-us
iam=1
plugin_name=<plugin name>
uid=<azure username>
pwd=<azure password>
idp_tenant=<Azure idp tenant uuid>
client_id=<Azure idp client uuid>
client_secret=<Azure idp client secret>
```

### Menggunakan koneksi DSN dengan profil IAM
<a name="rsql-query-tool-starting-tool-connection-dsn-iam"></a>

Anda dapat terhubung ke Amazon Redshift menggunakan profil IAM yang telah dikonfigurasi. Profil IAM harus memiliki hak istimewa untuk menelepon. `GetClusterCredentials` Contoh berikut menunjukkan properti DSN untuk digunakan. `Region`Parameter `ClusterID` dan diperlukan hanya jika `Host` bukan titik akhir yang disediakan Amazon seperti`examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com`.

```
[testiam]
Driver=Default
Host=testcluster.example.com
Database=dev
DbUser=testuser
ClusterID=rsqltestcluster
Region=us-east-1
IAM=1
Profile=default
```

Nilai untuk `Profile` kunci adalah profil bernama yang Anda pilih dari kredenal AWS CLI Anda. Contoh ini menunjukkan kredensil untuk profil bernama. `default`

```
$ cat .aws/credentials
[default]
aws_access_key_id = ASIAIOSFODNN7EXAMPLE 
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```

Berikut ini menunjukkan respon koneksi.

```
$ rsql -D testiam
DSN Connected
DBMS Name: Amazon Redshift
Driver Name: Amazon Redshift ODBC Driver
Driver Version: 1.4.27.1000
Rsql Version: 1.0.1
Redshift Version: 1.0.29306
Type "help" for help.

(testcluster) testuser@dev=>
```

### Menggunakan koneksi DSN dengan profil Instance
<a name="rsql-query-tool-starting-tool-connection-dsn-instance"></a>

Anda dapat terhubung ke Amazon Redshift menggunakan profil instans Amazon EC2. Profil instance harus memiliki hak istimewa untuk menelepon`GetClusterCredentials`. Lihat contoh di bawah ini untuk properti DSN yang akan digunakan. `Region`Parameter `ClusterID` dan diperlukan hanya jika `Host` bukan titik akhir yang disediakan Amazon seperti`examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com`.

```
[testinstanceprofile]
Driver=Default
Host=testcluster.example.com
Database=dev
DbUser=testuser
ClusterID=rsqltestcluster
Region=us-east-1
IAM=1
Instanceprofile=1
```

Berikut ini menunjukkan respon koneksi.

```
$ rsql -D testinstanceprofile
DSN Connected
DBMS Name: Amazon Redshift
Driver Name: Amazon Redshift ODBC Driver
Driver Version: 1.4.27.1000
Rsql Version: 1.0.1
Redshift Version: 1.0.29306
Type "help" for help.

(testcluster) testuser@dev=>
```

### Menggunakan koneksi DSN dengan rantai penyedia kredensi default
<a name="rsql-query-tool-starting-tool-connection-dsn-provider-chain"></a>

Untuk menyambung menggunakan rantai penyedia kredensi default, tentukan hanya properti IAM, dan Amazon Redshift RSQL akan mencoba memperoleh kredensil dalam urutan yang dijelaskan dalam Bekerja dengan Kredensial di SDK for [Java](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html). AWS AWS Setidaknya salah satu penyedia dalam rantai harus memiliki `GetClusterCredentials` izin. Ini berguna untuk menghubungkan dari wadah ECS, misalnya.

```
[iamcredentials]
Driver=Default
Host=testcluster.example.com
Database=dev
DbUser=testuser
ClusterID=rsqltestcluster
Region=us-east-1
IAM=1
```