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.
# Menyambung ke gudang data Amazon Redshift menggunakan alat klien SQL
Anda dapat terhubung ke gudang data Amazon Redshift dari alat klien SQL melalui koneksi Java Database Connectivity (JDBC), Python, dan Open Database Connectivity (ODBC). Amazon Redshift tidak menyediakan atau menginstal alat atau pustaka klien SQL apa pun. Untuk menggunakan alat atau pustaka ini untuk bekerja dengan data di gudang data Anda, instal di komputer klien Anda atau instans Amazon EC2. Anda dapat menggunakan sebagian besar alat klien SQL yang mendukung driver JDBC, Python, atau ODBC.
Gunakan daftar bagian di akhir topik ini untuk membantu Anda menelusuri proses mengonfigurasi komputer klien atau instans Amazon EC2 untuk menggunakan koneksi JDBC, Python, atau ODBC. Topik juga membahas opsi keamanan terkait untuk koneksi klien ke server. Selain itu, temukan informasi tentang pengaturan dan koneksi dari alat klien SQL, seperti [Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/rsql-query-tool.html) RSQL. Anda dapat mencoba alat-alat ini jika Anda belum memiliki alat intelijen bisnis untuk digunakan. Anda juga dapat menggunakan bagian ini untuk mempelajari tentang menghubungkan ke data Anda. Terakhir, jika Anda mengalami masalah saat mencoba terhubung ke gudang data Anda, Anda dapat meninjau informasi pemecahan masalah untuk mengidentifikasi solusi.
## Rekomendasi untuk menghubungkan dengan alat klien
Jika Anda terhubung ke klaster Redshift Anda menggunakan alamat IP, itu dapat mengakibatkan downtime tambahan ketika ada pemadaman atau kehilangan koneksi dan cluster dibawa online di Availability Zone (AZ) baru. Namun, jika Anda masih ingin aplikasi Anda terhubung ke Redshift menggunakan alamat IP, gunakan alamat IP pribadi yang dilampirkan ke titik akhir cluster ( virtual-private-cloudVPC). Anda dapat menemukan ini di detail cluster di **Jaringan dan keamanan**, di bawah tab **Properties**.
**catatan**
Jika aplikasi Anda menggunakan alamat IP node pemimpin untuk mengakses kluster Redshift, praktik terbaik yang disarankan adalah mengubahnya untuk menggunakan URL titik akhir cluster. Untuk informasi selengkapnya, lihat [Mengonfigurasi koneksi di Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/configuring-connections.html).
**Topics**
+ [Rekomendasi untuk menghubungkan dengan alat klien](#connecting-to-cluster-recommendations)
+ [Mengonfigurasi koneksi di Amazon Redshift](configuring-connections.md)
+ [Mengkonfigurasi opsi keamanan untuk koneksi](connecting-ssl-support.md)
+ [Menghubungkan dari alat dan kode klien](connecting-via-client-tools.md)
+ [Menggunakan profil otentikasi untuk terhubung ke Amazon Redshift](connecting-with-authentication-profiles.md)
+ [Memecahkan masalah koneksi di Amazon Redshift](troubleshooting-connections.md)
# Mengonfigurasi koneksi di Amazon Redshift
Di bagian berikut, pelajari cara mengkonfigurasi koneksi JDBC, Python, dan ODBC untuk terhubung ke cluster Anda dari alat klien SQL. Bagian ini menjelaskan cara mengatur koneksi JDBC, Python, dan ODBC. Ini juga menjelaskan cara menggunakan Secure Sockets Layer (SSL) dan sertifikat server untuk mengenkripsi komunikasi antara klien dan server.
## Driver JDBC, Python, dan ODBC untuk Amazon Redshift
Untuk bekerja dengan data di cluster Anda, Anda harus memiliki driver JDBC, Python, atau ODBC untuk konektivitas dari komputer klien atau instance Anda. Kode aplikasi Anda untuk menggunakan operasi API akses data JDBC, Python, atau ODBC, dan gunakan alat klien SQL yang mendukung JDBC, Python, atau ODBC.
Amazon Redshift menawarkan driver JDBC, Python, dan ODBC untuk diunduh. Driver ini didukung oleh Dukungan. Driver PostgreSQL tidak diuji dan tidak didukung oleh tim Amazon Redshift. Gunakan driver khusus Amazon Redshift saat menyambungkan ke klaster Amazon Redshift. Driver Amazon Redshift memiliki keuntungan sebagai berikut:
+ Support untuk IAM, SSO, dan otentikasi federasi.
+ Support untuk tipe data Amazon Redshift baru.
+ Support untuk profil otentikasi.
+ Peningkatan kinerja dalam hubungannya dengan peningkatan Amazon Redshift.
Untuk informasi selengkapnya tentang cara mengunduh driver JDBC dan ODBC dan mengonfigurasi koneksi ke cluster Anda, lihat[Mengonfigurasi koneksi untuk driver JDBC versi 2.x untuk Amazon Redshift](jdbc20-install.md), [Konektor Python Amazon Redshift](python-redshift-driver.md) dan. [Mengonfigurasi koneksi untuk driver ODBC versi 2.x untuk Amazon Redshift](odbc20-install.md)
Untuk informasi selengkapnya tentang mengelola identitas IAM, termasuk praktik terbaik untuk peran IAM, lihat. [Manajemen identitas dan akses di Amazon Redshift](redshift-iam-authentication-access-control.md)
# Menemukan string koneksi cluster Anda
Untuk terhubung ke cluster Anda dengan alat klien SQL Anda, Anda harus memiliki string koneksi cluster. Anda dapat menemukan string koneksi cluster di konsol Amazon Redshift, di halaman detail cluster.
**Untuk menemukan string koneksi untuk sebuah cluster**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon Redshift di. [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)
1. Pada menu navigasi, pilih **Cluster**, lalu pilih nama cluster dari daftar untuk membuka detailnya.
1. **String koneksi **URL JDBC** **dan URL ODBC** tersedia, bersama dengan detail tambahan, di bagian Informasi umum.** Setiap string didasarkan pada AWS Wilayah tempat cluster berjalan. Klik ikon di sebelah string koneksi yang sesuai untuk menyalinnya.
Untuk menyambung ke titik akhir cluster, Anda dapat menggunakan URL titik akhir cluster dari permintaan [DescribeClusters API](https://docs.aws.amazon.com/redshift/latest/APIReference/API_DescribeClusters.html). Berikut ini adalah contoh URL endpoint cluster.
```
mycluster.cmeaswqeuae.us-east-2.redshift.amazonaws.com
```
Jika Anda telah menyiapkan nama domain khusus untuk klaster Anda, Anda juga dapat menggunakannya untuk terhubung ke klaster Anda. Untuk informasi selengkapnya tentang membuat nama domain kustom, lihat [Menyiapkan nama domain kustom](https://docs.aws.amazon.com/redshift/latest/mgmt/connecting-connection-CNAME-connect.html).
**catatan**
Saat Anda terhubung, jangan gunakan alamat IP node cluster atau alamat IP titik akhir VPC. Selalu gunakan titik akhir Redshift untuk menghindari pemadaman yang tidak perlu. Satu-satunya pengecualian untuk menggunakan URL endpoint adalah ketika Anda menggunakan nama domain khusus. Untuk informasi selengkapnya, lihat [Menggunakan nama domain khusus untuk koneksi klien](https://docs.aws.amazon.com/redshift/latest/mgmt/connecting-connection-CNAME.html).
# Mengonfigurasi koneksi untuk driver JDBC versi 2.x untuk Amazon Redshift
Anda dapat menggunakan koneksi driver JDBC versi 2.x untuk terhubung ke cluster Amazon Redshift Anda dari banyak alat klien SQL pihak ketiga. Konektor Amazon Redshift JDBC menyediakan solusi open source. Anda dapat menelusuri kode sumber, meminta penyempurnaan, melaporkan masalah, dan memberikan kontribusi.
Untuk informasi terbaru tentang perubahan driver JDBC, lihat log [perubahan](https://github.com/aws/amazon-redshift-jdbc-driver/blob/master/CHANGELOG.md).
Secara default, driver Amazon Redshift JDBC dikonfigurasi untuk menggunakan keepalives TCP untuk mencegah koneksi dari kehabisan waktu. Anda dapat menentukan kapan driver mulai mengirim paket keepalive atau mematikan fitur dengan mengatur properti yang relevan di URL koneksi. Untuk informasi selengkapnya tentang sintaks URL koneksi, lihat[Membangun URL koneksi](jdbc20-build-connection-url.md).
| Properti | Deskripsi |
| --- | --- |
| `TCPKeepAlive` | Untuk mematikan keepalives TCP, setel properti ini ke. `FALSE` |
**Topics**
+ [Unduh driver Amazon Redshift JDBC, versi 2.1](jdbc20-download-driver.md)
+ [Menginstal driver Amazon Redshift JDBC, versi 2.2](jdbc20-install-driver.md)
+ [Mendapatkan URL JDBC](jdbc20-obtain-url.md)
+ [Membangun URL koneksi](jdbc20-build-connection-url.md)
+ [Mengkonfigurasi koneksi JDBC dengan Apache Maven](configure-jdbc20-connection-with-maven.md)
+ [Mengkonfigurasi otentikasi dan SSL](jdbc20-configure-authentication-ssl.md)
+ [Mengonfigurasi pencatatan log](jdbc20-configuring-logging.md)
+ [Konversi jenis data](jdbc20-data-type-mapping.md)
+ [Menggunakan dukungan pernyataan yang disiapkan](jdbc20-prepared-statement-support.md)
+ [Perbedaan antara versi 2.2 dan 1.x dari driver JDBC](jdbc20-jdbc10-driver-differences.md)
+ [Membuat file inisialisasi (.ini) untuk driver JDBC versi 2.x](jdbc20-ini-file.md)
+ [Opsi untuk konfigurasi driver JDBC versi 2.x](jdbc20-configuration-options.md)
+ [Versi sebelumnya dari JDBC driver version 2.x](jdbc20-previous-driver-version-20.md)
# Unduh driver Amazon Redshift JDBC, versi 2.1
**catatan**
Driver Amazon Redshift JDBC 2.x tidak dirancang agar aman untuk thread-safe. Dua atau lebih thread secara bersamaan mencoba menggunakan koneksi yang sama dapat menyebabkan kebuntuan, kesalahan, hasil yang salah, atau perilaku tak terduga lainnya.
Jika Anda memiliki aplikasi multi-threaded, kami sarankan Anda menyinkronkan akses ke driver untuk menghindari akses bersamaan.
Amazon Redshift menawarkan driver untuk alat yang kompatibel dengan JDBC 4.2 API. Nama kelas untuk pengemudi ini adalah`com.amazon.redshift.Driver`.
Untuk informasi rinci tentang cara menginstal driver JDBC, referensi perpustakaan driver JDBC, dan mendaftarkan kelas driver, lihat topik berikut.
Untuk setiap komputer tempat Anda menggunakan driver Amazon Redshift JDBC versi 2.x, pastikan Java Runtime Environment (JRE) 8.0 diinstal.
Jika Anda menggunakan driver Amazon Redshift JDBC untuk otentikasi database, pastikan Anda memiliki AWS SDK untuk Java 1.11.118 atau yang lebih baru di jalur kelas Java Anda. Jika Anda belum AWS SDK untuk Java menginstal, unduh file ZIP dengan pustaka yang bergantung pada driver dan driver yang kompatibel dengan JDBC 4.2 untuk SDK: AWS
+ [JDBC 4.2—driver yang kompatibel dengan versi 2.x dan pustaka yang bergantung pada driver AWS SDK Di Wilayah Tiongkok (Beijing), gunakan tautan berikut: JDBC 4.2 — driver yang kompatibel dengan versi 2.x dan pustaka](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.2.5/redshift-jdbc42-2.2.5.zip) [driver SDK AWS](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.2.5/redshift-jdbc42-2.2.5.zip)
File ZIP ini berisi driver yang kompatibel dengan JDBC 4.2 versi 2.x dan SDK for AWS Java 1.x file pustaka yang bergantung pada driver. Buka zip file jar dependen ke lokasi yang sama dengan driver JDBC. Hanya driver JDBC yang perlu berada di CLASSPATH.
File ZIP ini tidak menyertakan AWS SDK for Java 1.x lengkap. Namun, ini mencakup pustaka yang bergantung pada driver AWS SDK for Java 1.x yang diperlukan AWS Identity and Access Management untuk otentikasi database (IAM).
Gunakan driver Amazon Redshift JDBC ini dengan AWS SDK yang diperlukan untuk autentikasi database IAM.
*Untuk menginstal AWS SDK for Java 1.x lengkap, [AWS lihat SDK for Java](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/welcome.html)AWS SDK untuk Java 1.x di Panduan Pengembang.*
+ [Driver yang kompatibel dengan JDBC 4.2 versi 2.x (tanpa SDK AWS ) Di Wilayah Tiongkok (Beijing), gunakan tautan berikut: [JDBC](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.2.5/redshift-jdbc42-2.2.5.jar) 4.2—driver](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.2.5/redshift-jdbc42-2.2.5.jar) versi 2.x (tanpa SDK) AWS
Tinjau lisensi perangkat lunak driver JDBC versi 2.x dan ubah file log:
+ [Lisensi driver JDBC versi 2.x](https://github.com/aws/amazon-redshift-jdbc-driver/blob/master/LICENSE)
+ [Driver JDBC versi 2.x perubahan log](https://github.com/aws/amazon-redshift-jdbc-driver/blob/master/CHANGELOG.md)
Driver JDBC versi 1.2.27.1051 dan yang lebih baru mendukung prosedur tersimpan Amazon Redshift. Untuk informasi selengkapnya, lihat [Membuat prosedur tersimpan di Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/dg/stored-procedure-overview.html) di Panduan Pengembang *Database Amazon Redshift*.
# Menginstal driver Amazon Redshift JDBC, versi 2.2
Untuk menginstal Amazon Redshift JDBC 4.2—driver versi 2.x yang kompatibel dengan driver dan library yang bergantung pada driver untuk AWS SDK, ekstrak file dari arsip ZIP ke direktori pilihan Anda.
Untuk menginstal driver yang kompatibel dengan Amazon Redshift JDBC 4.2 versi 2.x (tanpa AWS SDK), salin file JAR ke direktori pilihan Anda.
Untuk mengakses penyimpanan data Amazon Redshift menggunakan driver Amazon Redshift JDBC, Anda perlu melakukan konfigurasi seperti yang dijelaskan berikut.
**Topics**
+ [Merujuk pustaka driver JDBC](jdbc20-driver-libraries.md)
+ [Mendaftarkan kelas pengemudi](jdbc20-register-driver-class.md)
# Merujuk pustaka driver JDBC
Aplikasi JDBC atau kode Java yang Anda gunakan untuk terhubung ke data Anda harus mengakses file JAR driver. Dalam aplikasi atau kode, tentukan semua file JAR yang Anda ekstrak dari arsip ZIP.
## Menggunakan driver dalam aplikasi JDBC
Aplikasi JDBC biasanya menyediakan serangkaian opsi konfigurasi untuk menambahkan daftar file pustaka driver. Gunakan opsi yang disediakan untuk menyertakan semua file JAR dari arsip ZIP sebagai bagian dari konfigurasi driver dalam aplikasi. Untuk informasi selengkapnya, lihat dokumentasi untuk aplikasi JDBC Anda.
## Menggunakan driver dalam kode Java
Anda harus menyertakan semua file pustaka driver di jalur kelas. Ini adalah jalur yang dicari Java Runtime Environment untuk kelas dan file sumber daya lainnya. Untuk informasi selengkapnya, lihat dokumentasi Java SE yang sesuai untuk mengatur jalur kelas untuk sistem operasi Anda.
+ Windows: [https://docs.oracle.com/javase/7/ .html docs/technotes/tools/windows/classpath](https://docs.oracle.com/javase/7/docs/technotes/tools/windows/classpath.html)
+ Linux dan Solaris: [https://docs.oracle.com/javase/docs/technotes/tools/solaris/classpath7/](https://docs.oracle.com/javase/7/docs/technotes/tools/solaris/classpath.html) .html
+ macOS: Jalur kelas macOS default adalah direktori tempat driver JDBC diinstal.
# Mendaftarkan kelas pengemudi
Pastikan Anda mendaftarkan kelas yang sesuai untuk aplikasi Anda. Anda menggunakan kelas berikut untuk menghubungkan driver Amazon Redshift JDBC ke penyimpanan data Amazon Redshift:
+ `Driver`kelas diperluas`java.sql.Driver`.
+ `DataSource`kelas diperluas `javax.sql.DataSource` dan`javax.sql.ConnectionPoolDataSource`.
Driver mendukung nama kelas berkualifikasi penuh berikut yang independen dari versi JDBC:
+ `com.amazon.redshift.jdbc.Driver`
+ `com.amazon.redshift.jdbc.DataSource`
Contoh berikut menunjukkan bagaimana menggunakan DriverManager kelas untuk membuat koneksi untuk JDBC 4.2.
```
private static Connection connectViaDM() throws Exception
{
Connection connection = null;
connection = DriverManager.getConnection(CONNECTION_URL);
return connection;
}
```
Contoh berikut menunjukkan bagaimana menggunakan `DataSource` kelas untuk membuat koneksi.
```
private static Connection connectViaDS() throws Exception
{
Connection connection = null;
11
Amazon Redshift JDBC Driver Installation and Configuration Guide
DataSource ds = new com.amazon.redshift.jdbc.DataSource
();
ds.setURL(CONNECTION_URL);
connection = ds.getConnection();
return connection;
}
```
# Mendapatkan URL JDBC
Sebelum Anda dapat terhubung ke cluster Amazon Redshift Anda dari alat klien SQL, Anda perlu mengetahui URL JDBC klaster Anda. URL JDBC memiliki format berikut: `jdbc:redshift://endpoint:port/database`
Bidang format sebelumnya memiliki nilai berikut.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/jdbc20-obtain-url.html)
Berikut ini adalah contoh URL JDBC: `jdbc:redshift://examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com:5439/dev`
Jika nilai URL Anda berisi salah satu karakter yang dicadangkan URI berikut, nilainya harus dikodekan URL:
+ ;
+ \$1
+ \$1
+ \$1
+ [
+ ]
+ &
+ =
+ ?
+ ruang kosong
Misalnya, jika `PWD` nilai Anda`password:password`, URL koneksi yang menggunakan nilai itu akan terlihat seperti berikut:
`jdbc:redshift://redshift.company.us-west-1.redshift.amazonaws.com:9000/dev;UID=amazon;PWD=password%3Apassword`
Untuk informasi tentang cara mendapatkan koneksi JDBC Anda, lihat. [Menemukan string koneksi cluster Anda](connecting-connection-string.md)
Jika komputer klien gagal terhubung ke database, Anda dapat memecahkan masalah yang mungkin terjadi. Untuk informasi selengkapnya, lihat [Memecahkan masalah koneksi di Amazon Redshift](troubleshooting-connections.md).
# Membangun URL koneksi
Gunakan URL koneksi untuk memasok informasi koneksi ke penyimpanan data yang Anda akses. Berikut ini adalah format URL koneksi untuk driver Amazon Redshift JDBC versi 2.x. Di sini, [Host] titik akhir server Amazon Redshift dan [Port] adalah jumlah port Transmission Control Protocol (TCP) yang digunakan server untuk mendengarkan permintaan klien.
```
jdbc:redshift://[Host]:[Port]
```
Berikut ini adalah format URL koneksi yang menentukan beberapa pengaturan opsional.
```
jdbc:redshift://[Host]:[Port]/[database];[Property1]=[Value];
[Property2]=[Value];
```
Jika nilai URL Anda berisi salah satu karakter yang dicadangkan URI berikut, nilainya harus dikodekan URL:
+ ;
+ \$1
+ \$1
+ \$1
+ [
+ ]
+ &
+ =
+ ?
+ ruang kosong
Misalnya, jika `PWD` nilai Anda`password:password`, URL koneksi yang menggunakan nilai itu akan terlihat seperti berikut:
`jdbc:redshift://redshift.company.us-west-1.redshift.amazonaws.com:9000/dev;UID=amazon;PWD=password%3Apassword`
Misalnya, misalkan Anda ingin terhubung ke port 9000 pada cluster Amazon Redshift di Wilayah AS Barat (California Utara) aktif. AWS Anda juga ingin mengakses database bernama `dev` dan mengotentikasi koneksi menggunakan nama pengguna dan kata sandi database. Dalam hal ini, Anda menggunakan URL koneksi berikut.
```
jdbc:redshift://redshift.company.us-west-1.redshift.amazonaws.com:9000/dev;UID=amazon;PWD=amazon
```
Anda dapat menggunakan karakter berikut untuk memisahkan opsi konfigurasi dari sisa string URL:
+ ;
+ ?
Misalnya, string URL berikut setara:
```
jdbc:redshift://my_host:5439/dev;ssl=true;defaultRowFetchSize=100
```
```
jdbc:redshift://my_host:5439/dev?ssl=true;defaultRowFetchSize=100
```
Anda dapat menggunakan karakter berikut untuk memisahkan opsi konfigurasi satu sama lain dalam string URL:
+ ;
+ &
Misalnya, string URL berikut setara:
```
jdbc:redshift://my_host:5439/dev;ssl=true;defaultRowFetchSize=100
```
```
jdbc:redshift://my_host:5439/dev;ssl=true&defaultRowFetchSize=100
```
Contoh URL berikut menentukan tingkat log 6 dan jalur untuk log.
```
jdbc:redshift://redshift.amazonaws.com:5439/dev;DSILogLevel=6;LogPath=/home/user/logs;
```
Jangan duplikat properti di URL koneksi.
Untuk daftar lengkap opsi konfigurasi yang dapat Anda tentukan, lihat[Opsi untuk konfigurasi driver JDBC versi 2.x](jdbc20-configuration-options.md).
**catatan**
Saat Anda terhubung, jangan gunakan alamat IP node cluster atau alamat IP titik akhir VPC. Selalu gunakan titik akhir Redshift untuk menghindari pemadaman yang tidak perlu. Satu-satunya pengecualian untuk menggunakan URL endpoint adalah ketika Anda menggunakan nama domain khusus. Untuk informasi selengkapnya, lihat [Menggunakan nama domain khusus untuk koneksi klien](https://docs.aws.amazon.com/redshift/latest/mgmt/connecting-connection-CNAME.html).
# Mengkonfigurasi koneksi JDBC dengan Apache Maven
Apache Maven adalah perangkat lunak manajemen proyek dan alat pemahaman. AWS SDK untuk Java Mendukung proyek Apache Maven. *Untuk informasi selengkapnya, lihat [Menggunakan SDK dengan Apache Maven](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-project-maven.html) di Panduan Pengembang.AWS SDK untuk Java *
Jika Anda menggunakan Apache Maven, Anda dapat mengonfigurasi dan membangun proyek Anda untuk menggunakan driver Amazon Redshift JDBC untuk terhubung ke cluster Amazon Redshift Anda. Untuk melakukan ini, tambahkan driver JDBC sebagai dependensi dalam file proyek Anda. `pom.xml` Jika Anda menggunakan Maven untuk membangun proyek Anda dan ingin menggunakan koneksi JDBC, ambil langkah-langkah di bagian berikut.
**Untuk mengkonfigurasi driver JDBC sebagai dependensi Maven**
1. Tambahkan repositori Amazon atau repositori Maven Central ke bagian repositori file Anda. `pom.xml`
**catatan**
URL dalam contoh kode berikut mengembalikan kesalahan jika digunakan dalam browser. Gunakan URL ini hanya dalam konteks proyek Maven.
Untuk terhubung menggunakan Secure Sockets Layer (SSL), tambahkan repositori berikut ke file Anda. `pom.xml`
```
redshift
https://s3.amazonaws.com/redshift-maven-repository/release
```
Untuk repositori Maven Central, tambahkan berikut ini ke file Anda. `pom.xml`
```
redshift
https://repo1.maven.org/maven2
```
1. Deklarasikan versi driver yang ingin Anda gunakan di bagian dependensi file Anda. `pom.xml`
Amazon Redshift menawarkan driver untuk alat yang kompatibel dengan JDBC 4.2 API. Untuk informasi tentang fungsionalitas yang didukung oleh driver ini, lihat[Unduh driver Amazon Redshift JDBC, versi 2.1](jdbc20-download-driver.md).
Ganti `driver-version` dalam contoh berikut dengan versi driver Anda, misalnya`2.1.0.1`. Untuk driver yang kompatibel dengan JDBC 4.2, gunakan yang berikut ini.
```
com.amazon.redshift
redshift-jdbc42
driver-version
```
Nama kelas untuk pengemudi ini adalah`com.amazon.redshift.Driver`.
Driver Amazon Redshift Maven memerlukan dependensi opsional berikut saat Anda menggunakan otentikasi database IAM.
```
com.amazonaws
aws-java-sdk-core
1.12.23
runtime
true
com.amazonaws
aws-java-sdk-redshift
1.12.23
runtime
true
com.amazonaws
aws-java-sdk-sts
1.12.23
runtime
true
```
Untuk memutakhirkan atau mengubah driver Amazon Redshift JDBC ke versi terbaru, pertama-tama ubah bagian versi dependensi ke versi driver terbaru. Kemudian bersihkan proyek Anda dengan Plugin Maven Clean, seperti yang ditunjukkan berikut.
```
mvn clean
```
# Mengkonfigurasi otentikasi dan SSL
Untuk melindungi data dari akses yang tidak sah, penyimpanan data Amazon Redshift memerlukan semua koneksi untuk diautentikasi menggunakan kredensyal pengguna. Beberapa penyimpanan data juga memerlukan koneksi yang harus dibuat melalui protokol Secure Sockets Layer (SSL), baik dengan atau tanpa otentikasi satu arah.
Driver Amazon Redshift JDBC versi 2.x memberikan dukungan penuh untuk protokol otentikasi ini.
Versi SSL yang didukung driver tergantung pada versi JVM yang Anda gunakan. Untuk informasi tentang versi SSL yang didukung oleh setiap versi Java, lihat [Mendiagnosis TLS, SSL, dan HTTPS](https://blogs.oracle.com/java-platform-group/diagnosing-tls,-ssl,-and-https) di Blog Manajemen Produk Grup Platform Java.
Versi SSL yang digunakan untuk koneksi adalah versi tertinggi yang didukung oleh driver dan server, yang ditentukan pada waktu koneksi.
Konfigurasikan driver Amazon Redshift JDBC versi 2.x untuk mengautentikasi koneksi Anda sesuai dengan persyaratan keamanan server Redshift yang Anda sambungkan.
Anda harus selalu memberikan nama pengguna dan kata sandi Redshift Anda untuk mengautentikasi koneksi. Bergantung pada apakah SSL diaktifkan dan diperlukan di server, Anda mungkin juga perlu mengonfigurasi driver untuk terhubung melalui SSL. Atau Anda mungkin menggunakan otentikasi SSL satu arah sehingga klien (driver itu sendiri) memverifikasi identitas server.
Anda memberikan informasi konfigurasi ke driver di URL koneksi. Untuk informasi selengkapnya tentang sintaks URL koneksi, lihat[Membangun URL koneksi](jdbc20-build-connection-url.md).
*SSL* menunjukkanTLS/SSL, both Transport Layer Security and Secure Sockets Layer. The driver supports industry-standard versions of TLS/SSL.
## Mengkonfigurasi otentikasi IAM
Jika Anda terhubung ke server Amazon Redshift menggunakan autentikasi IAM, setel properti berikut sebagai bagian dari string koneksi sumber data Anda.
Untuk informasi selengkapnya tentang autentikasi IAM, lihat. [Manajemen identitas dan akses di Amazon Redshift](redshift-iam-authentication-access-control.md)
Untuk menggunakan otentikasi IAM, gunakan salah satu format string koneksi berikut:
| String koneksi | Deskripsi |
| --- | --- |
| `jdbc:redshift:iam:// [host]:[port]/[db]` | String koneksi biasa. Pengemudi menyimpulkan clusterID dan Region dari host. |
| `jdbc:redshift:iam:// [cluster-id]: [region]/[db]` | Pengemudi mengambil informasi host, mengingat ClusterID dan Region. |
| `jdbc:redshift:iam:// [host]/[db]` | Driver default ke port 5439, dan menyimpulkan ClusterID dan Region dari host. Bergantung pada port yang Anda pilih saat membuat, memodifikasi, atau memigrasi klaster, izinkan akses ke port yang dipilih. |
## Menentukan profil
Jika Anda menggunakan otentikasi IAM, Anda dapat menentukan properti koneksi tambahan yang diperlukan atau opsional di bawah nama profil. Dengan melakukan ini, Anda dapat menghindari meletakkan informasi tertentu secara langsung di string koneksi. Anda menentukan nama profil dalam string koneksi Anda menggunakan properti Profil.
Profil dapat ditambahkan ke file AWS kredensyal. Lokasi default untuk file ini adalah: `~/.aws/credentials`
Anda dapat mengubah nilai default dengan mengatur jalur dalam variabel lingkungan berikut: `AWS_CREDENTIAL_PROFILES_FILE`
Untuk informasi selengkapnya tentang profil, lihat [Bekerja dengan AWS Kredensyal di. *AWS SDK untuk Java*](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html)
## Menggunakan kredensial profil instance
Jika Anda menjalankan aplikasi pada instans Amazon EC2 yang dikaitkan dengan peran IAM, Anda dapat terhubung menggunakan kredenal profil instans.
Untuk melakukan ini, gunakan salah satu format string koneksi IAM di tabel sebelumnya, dan atur properti koneksi dbuser ke nama pengguna Amazon Redshift yang Anda sambungkan sebagai.
Untuk informasi selengkapnya tentang profil instans, lihat [Manajemen Akses](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) di *Panduan Pengguna IAM*.
## Menggunakan penyedia kredensi
Driver juga mendukung plugin penyedia kredenal dari layanan berikut:
+ AWS Pusat Identitas IAM
+ Layanan Federasi Direktori Aktif (ADFS)
+ Layanan Token Web JSON (JWT)
+ Layanan Microsoft Azure Active Directory (AD) dan Layanan Browser Microsoft Azure Active Directory (AD)
+ Layanan Okta
+ PingFederate Layanan
+ Browser SAMP untuk layanan SAMP seperti Okta, Ping, atau ADFS
Jika Anda menggunakan salah satu layanan ini, URL koneksi perlu menentukan properti berikut:
+ **Plugin\$1Name** - Jalur kelas yang sepenuhnya memenuhi syarat untuk kelas plugin penyedia kredensil Anda.
+ **IDP\$1host:** — Host untuk layanan yang Anda gunakan untuk mengautentikasi ke Amazon Redshift.
+ **IDP\$1port** — Port tempat host untuk layanan otentikasi mendengarkan. Tidak diperlukan untuk Okta.
+ **User** — Nama pengguna untuk server idp\$1host.
+ **Kata sandi** — Kata sandi yang terkait dengan nama pengguna idp\$1host.
+ **DbUser**— Nama pengguna Amazon Redshift yang Anda sambungkan sebagai.
+ **SSL\$1insecure** - Menunjukkan apakah sertifikat server IDP harus diverifikasi.
+ **Client\$1ID — ID** klien yang terkait dengan nama pengguna di portal Azure AD. Hanya digunakan untuk Azure AD.
+ **Client\$1Secret** — Rahasia klien yang terkait dengan ID klien di portal Azure AD. Hanya digunakan untuk Azure AD.
+ **IDP\$1Tenant** - ID penyewa Azure AD untuk aplikasi Amazon Redshift Anda. Hanya digunakan untuk Azure AD.
+ **App\$1ID — ID** aplikasi Okta untuk aplikasi Amazon Redshift Anda. Hanya digunakan untuk Okta.
+ **App\$1Name — Nama** aplikasi Okta opsional untuk aplikasi Amazon Redshift Anda. Hanya digunakan untuk Okta.
+ **Partner\$1SPID** — Nilai SPID mitra opsional (ID penyedia layanan). Hanya digunakan untuk PingFederate.
+ **Idc\$1Region** — Wilayah AWS Tempat instans AWS IAM Identity Center berada. Hanya digunakan untuk AWS IAM Identity Center.
+ **Issuer\$1Url** — Titik akhir instance server AWS IAM Identity Center. Hanya digunakan untuk AWS IAM Identity Center.
Jika Anda menggunakan plugin browser untuk salah satu layanan ini, URL koneksi juga dapat mencakup:
+ **Login\$1URL —URL** untuk sumber daya di situs web penyedia identitas saat menggunakan layanan Security Assertion Markup Language (SAMP) atau Azure AD melalui plugin browser. Parameter ini diperlukan jika Anda menggunakan plugin browser.
+ **Listen\$1Port** — Port yang digunakan driver untuk mendapatkan respons SAMP dari penyedia identitas saat menggunakan layanan SAMP, Azure AD, atau AWS IAM Identity Center melalui plugin browser.
+ **IDP\$1Response\$1Timeout** — Jumlah waktu, dalam hitungan detik, driver menunggu respons SAMP dari penyedia identitas saat menggunakan layanan SAMP, Azure AD, atau IAM Identity Center melalui plugin browser. AWS
Untuk informasi tentang properti string koneksi tambahan, lihat[Opsi untuk konfigurasi driver JDBC versi 2.x](jdbc20-configuration-options.md).
# Hanya menggunakan nama pengguna dan kata sandi
Jika server yang Anda sambungkan tidak menggunakan SSL, maka Anda hanya perlu memberikan nama pengguna dan kata sandi Redshift Anda untuk mengautentikasi koneksi.
**Untuk mengonfigurasi otentikasi menggunakan nama pengguna dan kata sandi Redshift Anda saja**
1. Setel `UID` properti ke nama pengguna Redshift Anda untuk mengakses server Amazon Redshift.
1. Setel properti PWD ke kata sandi yang sesuai dengan nama pengguna Redshift Anda.
# Menggunakan SSL tanpa verifikasi identitas
Jika server yang Anda sambungkan menggunakan SSL tetapi tidak memerlukan verifikasi identitas, maka Anda dapat mengonfigurasi driver untuk menggunakan pabrik SSL yang tidak memvalidasi.
**Untuk mengonfigurasi koneksi SSL tanpa verifikasi identitas**
1. Setel `UID` properti ke nama pengguna Redshift Anda untuk mengakses server Amazon Redshift.
1. Atur `PWD` properti ke kata sandi yang sesuai dengan nama pengguna Redshift Anda.
1. Atur `SSLFactory` properti ke`com.amazon.redshift.ssl.NonValidatingFactory`.
# Menggunakan otentikasi SSL satu arah
Jika server yang Anda sambungkan menggunakan SSL dan memiliki sertifikat, maka Anda dapat mengonfigurasi driver untuk memverifikasi identitas server menggunakan otentikasi satu arah.
Otentikasi satu arah memerlukan sertifikat SSL yang ditandatangani dan tepercaya untuk memverifikasi identitas server. Anda dapat mengonfigurasi driver untuk menggunakan sertifikat tertentu atau mengakses TrustStore yang berisi sertifikat yang sesuai. Jika Anda tidak menentukan sertifikat atau TrustStore, maka driver menggunakan Java default TrustStore (biasanya salah satu `jssecacerts` atau`cacerts`).
**Untuk mengonfigurasi otentikasi SSL satu arah**
1. Setel properti UID ke nama pengguna Redshift Anda untuk mengakses server Amazon Redshift.
1. Setel properti PWD ke kata sandi yang sesuai dengan nama pengguna Redshift Anda.
1. Setel properti SSL ke true.
1. Setel properti SSLRoot Cert ke lokasi sertifikat CA root Anda.
1. Jika Anda tidak menggunakan salah satu Java default TrustStores, lakukan salah satu hal berikut:
+ Untuk menentukan sertifikat server, setel properti SSLRoot Cert ke jalur lengkap sertifikat.
+ Untuk menentukan a TrustStore, lakukan hal berikut:
1. Gunakan program keytool untuk menambahkan sertifikat server ke TrustStore yang ingin Anda gunakan.
1. Tentukan TrustStore dan kata sandi yang akan digunakan saat memulai aplikasi Java menggunakan driver. Contoh:
```
-Djavax.net.ssl.trustStore=[TrustStoreName]
-Djavax.net.ssl.trustStorePassword=[TrustStorePassword]
-Djavax.net.ssl.trustStoreType=[TrustStoreType]
```
1. Pilih salah satu:
+ Untuk memvalidasi sertifikat, setel SSLMode properti ke verify-ca.
+ Untuk memvalidasi sertifikat dan memverifikasi nama host dalam sertifikat, atur SSLMode properti ke verify-full.
# Mengonfigurasi pencatatan log
Anda dapat mengaktifkan masuk ke driver untuk membantu mendiagnosis masalah.
Anda dapat mencatat informasi driver dengan menggunakan metode berikut:
+ Untuk menyimpan informasi yang dicatat dalam file.log, lihat[Menggunakan file log](jdbc20-using-log-files.md).
+ Untuk mengirim informasi yang dicatat ke LogStream atau LogWriter ditentukan dalam DriverManager, lihat[Menggunakan LogStream atau LogWriter](jdbc20-logstream-option.md).
Anda memberikan informasi konfigurasi ke driver di URL koneksi. Untuk informasi selengkapnya tentang sintaks URL koneksi, lihat[Membangun URL koneksi](jdbc20-build-connection-url.md).
# Menggunakan file log
Aktifkan logging cukup lama untuk menangkap masalah. Logging mengurangi kinerja dan dapat mengkonsumsi sejumlah besar ruang disk.
Atur LogLevel kunci di URL koneksi Anda untuk mengaktifkan logging dan tentukan jumlah detail yang disertakan dalam file log. Tabel berikut mencantumkan level logging yang disediakan oleh driver Amazon Redshift JDBC versi 2.x, dalam urutan dari yang paling sedikit bertele-tele hingga yang paling bertele-tele.
| LogLevel nilai | Deskripsi |
| --- | --- |
| 1 | Log peristiwa kesalahan parah yang akan menyebabkan pengemudi membatalkan. |
| 2 | Peristiwa kesalahan log yang memungkinkan driver untuk terus berjalan. |
| 3 | Log peristiwa yang mungkin mengakibatkan kesalahan jika tindakan tidak diambil. Tingkat logging dan tingkat logging di atas level ini juga mencatat kueri pengguna. |
| 4 | Log informasi umum yang menjelaskan kemajuan pengemudi. |
| 5 | Log informasi terperinci yang berguna untuk men-debug driver. |
| 6 | Catat semua aktivitas pengemudi. |
**Untuk mengatur logging yang menggunakan file log**
1. Atur LogLevel properti ke tingkat informasi yang diinginkan untuk disertakan dalam file log.
1. Atur LogPath properti ke jalur lengkap ke folder tempat Anda ingin menyimpan file log.
Misalnya, URL koneksi berikut memungkinkan logging level 3 dan menyimpan file log di folder C:\$1temp: `jdbc:redshift://redshift.company.us-west- 1.redshift.amazonaws.com:9000/Default;DSILogLevel=3;LogPath=C:\temp`
1. Untuk memastikan bahwa pengaturan baru berlaku, restart aplikasi JDBC Anda dan sambungkan kembali ke server.
Driver Amazon Redshift JDBC menghasilkan file log berikut di lokasi yang ditentukan dalam properti: LogPath
+ File redshift\$1jdbc.log yang mencatat aktivitas driver yang tidak spesifik untuk koneksi.
+ redshift\$1jdbc\$1connection\$1 [Number] .log file untuk setiap koneksi yang dibuat ke database, di mana [Number] adalah nomor yang mengidentifikasi setiap file log. File ini mencatat aktivitas driver yang khusus untuk koneksi.
Jika LogPath nilainya tidak valid, maka driver mengirimkan informasi yang dicatat ke aliran keluaran standar () `System.out`
# Menggunakan LogStream atau LogWriter
Aktifkan logging cukup lama untuk menangkap masalah. Logging mengurangi kinerja dan dapat mengkonsumsi sejumlah besar ruang disk.
Atur LogLevel kunci di URL koneksi Anda untuk mengaktifkan logging dan tentukan jumlah detail yang dikirim ke LogStream atau LogWriter ditentukan dalam file DriverManager.
**Untuk mengaktifkan logging yang menggunakan LogStream atau LogWriter:**
1. Untuk mengonfigurasi driver untuk mencatat informasi umum yang menjelaskan kemajuan driver, atur LogLevel properti ke 1 atau INFO.
1. Untuk memastikan bahwa pengaturan baru berlaku, restart aplikasi JDBC Anda dan sambungkan kembali ke server.
# Konversi jenis data
Driver Amazon Redshift JDBC versi 2.x mendukung banyak format data umum, mengonversi antara jenis data Amazon Redshift, SQL, dan Java.
Tabel berikut mencantumkan pemetaan tipe data yang didukung.
| Jenis Amazon Redshift | Jenis SQL | Jenis Java |
| --- | --- | --- |
| BIGINT | SQL\$1BIGINT | Panjang |
| BOOLEAN | SQL\$1BIT | Boolean |
| CHAR | SQL\$1CHAR | String |
| DATE | SQL\$1TYPE\$1DATE | java.sql.date |
| DECIMAL | SQL\$1NUMERIK | BigDecimal |
| DOUBLE PRECISION | SQL\$1GANDA | Ganda |
| GEOMETRY | SQL\$1 LONGVARBINARY | byte [] |
| INTEGER | SQL\$1INTEGER | Bilangan Bulat |
| OID | SQL\$1BIGINT | Panjang |
| SUPER | SQL\$1LONGVARCHAR | String |
| REAL | SQL\$1REAL | Desimal |
| SMALLINT | SQL\$1SMALLINT | Pendek |
| TEXT | SQL\$1VARCHAR | String |
| TIME | SQL\$1TYPE\$1TIME | java.sql.waktu |
| JADWAL | SQL\$1TYPE\$1TIME | java.sql.waktu |
| TIMESTAMP | STEMPEL WAKTU SQL\$1TYPE\$1 | java.sql.TimeStamp |
| TIMESTAMPTZ | STEMPEL WAKTU SQL\$1TYPE\$1 | java.sql.TimeStamp |
| VARCHAR | SQL\$1VARCHAR | String |
# Menggunakan dukungan pernyataan yang disiapkan
Driver Amazon Redshift JDBC mendukung pernyataan yang disiapkan. Anda dapat menggunakan pernyataan yang disiapkan untuk meningkatkan kinerja kueri berparameter yang perlu dijalankan beberapa kali selama koneksi yang sama.
*Pernyataan yang disiapkan* adalah pernyataan SQL yang dikompilasi di sisi server tetapi tidak segera dijalankan. Pernyataan yang dikompilasi disimpan di server sebagai PreparedStatement objek sampai Anda menutup objek atau koneksi. Sementara objek itu ada, Anda dapat menjalankan pernyataan yang disiapkan sebanyak yang diperlukan menggunakan nilai parameter yang berbeda, tanpa harus mengkompilasi pernyataan lagi. Overhead yang dikurangi ini memungkinkan kumpulan kueri dijalankan lebih cepat.
Untuk informasi lebih lanjut tentang pernyataan yang disiapkan, lihat “Menggunakan Pernyataan yang Disiapkan” di [tutorial JDBC Basics dari Oracle](https://docs.oracle.com/javase/tutorial/jdbc/basics/prepared.html).
Anda dapat menyiapkan pernyataan yang berisi beberapa kueri. Misalnya, pernyataan disiapkan berikut berisi dua query INSERT:
```
PreparedStatement pstmt = conn.prepareStatement("INSERT INTO
MyTable VALUES (1, 'abc'); INSERT INTO CompanyTable VALUES
(1, 'abc');");
```
Berhati-hatilah agar kueri ini tidak bergantung pada hasil kueri lain yang ditentukan dalam pernyataan yang disiapkan yang sama. Karena kueri tidak berjalan selama langkah persiapan, hasilnya belum dikembalikan, dan tidak tersedia untuk kueri lain dalam pernyataan yang disiapkan yang sama.
Misalnya, pernyataan yang disiapkan berikut, yang membuat tabel dan kemudian menyisipkan nilai ke dalam tabel yang baru dibuat, tidak diperbolehkan:
```
PreparedStatement pstmt = conn.prepareStatement("CREATE
TABLE MyTable(col1 int, col2 varchar); INSERT INTO myTable
VALUES (1, 'abc');");
```
Jika Anda mencoba menyiapkan pernyataan ini, server mengembalikan kesalahan yang menyatakan bahwa tabel tujuan (MyTable) belum ada. Query CREATE harus dijalankan sebelum query INSERT dapat disiapkan.
# Perbedaan antara versi 2.2 dan 1.x dari driver JDBC
Bagian ini menjelaskan perbedaan informasi yang dikembalikan oleh versi 2.2 dan 1.x dari driver JDBC. Driver JDBC versi 1.x dihentikan.
Tabel berikut mencantumkan DatabaseMetadata informasi yang dikembalikan oleh fungsi getDatabaseProduct Name () dan getDatabaseProduct Version () untuk setiap versi driver JDBC. Driver JDBC versi 2.2 memperoleh nilai saat membuat koneksi. Driver JDBC versi 1.x memperoleh nilai sebagai hasil dari kueri.
| Versi driver JDBC | getDatabaseProductNama () hasil | getDatabaseProductVersi () hasil |
| --- | --- | --- |
| 2.2 | Redshift | 8.0.2 |
| 1.x | PostgreSQL | 08.00.0002 |
Tabel berikut mencantumkan DatabaseMetadata informasi yang dikembalikan oleh getTypeInfo fungsi untuk setiap versi driver JDBC.
| Versi driver JDBC | getTypeInfo hasil |
| --- | --- |
| 2.2 | Konsisten dengan tipe data Redshift |
| 1.x | Konsisten dengan tipe data PostgreSQL |
# Membuat file inisialisasi (.ini) untuk driver JDBC versi 2.x
Dengan menggunakan file inisialisasi (.ini) untuk driver Amazon Redshift JDBC versi 2.x, Anda dapat menentukan parameter konfigurasi tingkat sistem. Misalnya, parameter otentikasi IDP federasi dapat bervariasi untuk setiap aplikasi. File.ini menyediakan lokasi umum untuk klien SQL untuk mendapatkan parameter konfigurasi yang diperlukan.
Anda dapat membuat file inisialisasi versi 2.x driver JDBC (.ini) yang berisi opsi konfigurasi untuk klien SQL. Nama default file tersebut adalah`rsjdbc.ini`. Driver JDBC versi 2.x memeriksa file.ini di lokasi berikut, terdaftar dalam urutan prioritas:
+ `IniFile`parameter di URL koneksi atau di kotak dialog properti koneksi klien SQL. Pastikan `IniFile` parameter berisi path lengkap ke file.ini, termasuk nama file. Untuk informasi tentang `IniFile` parameter, lihat[IniFile](jdbc20-configuration-options.md#jdbc20-inifile-option). Jika `IniFile` parameter salah menentukan lokasi file.ini, kesalahan akan ditampilkan.
+ Variabel lingkungan seperti AMAZON\$1REDSHIFT\$1JDBC\$1INI\$1FILE dengan path lengkap, termasuk nama file. Anda dapat menggunakan `rsjdbc.ini` atau menentukan nama file. Jika variabel lingkungan AMAZON\$1REDSHIFT\$1JDBC\$1INI\$1FILE salah menentukan lokasi file.ini, kesalahan akan ditampilkan.
+ Direktori tempat file JAR driver berada.
+ Direktori home pengguna.
+ Direktori temp sistem.
Anda dapat mengatur file.ini menjadi beberapa bagian, misalnya [DRIVER]. Setiap bagian berisi pasangan kunci-nilai yang menentukan berbagai parameter koneksi. Anda dapat menggunakan `IniSection` parameter untuk menentukan bagian dalam file.ini. Untuk informasi tentang `IniSection` parameter, lihat[IniSection](jdbc20-configuration-options.md#jdbc20-inisection-option).
Berikut ini adalah contoh dari format file.ini, dengan bagian untuk [DRIVER], [DEV], [QA], dan [PROD]. Bagian [DRIVER] dapat diterapkan ke koneksi apa pun.
```
[DRIVER]
key1=val1
key2=val2
[DEV]
key1=val1
key2=val2
[QA]
key1=val1
key2=val2
[PROD]
key1=val1
key2=val2
```
Driver JDBC versi 2.x memuat parameter konfigurasi dari lokasi berikut, tercantum dalam urutan prioritas:
+ Parameter konfigurasi default dalam kode aplikasi.
+ Properti bagian [DRIVER] dari file.ini, jika disertakan.
+ Parameter konfigurasi bagian kustom, jika `IniSection` opsi disediakan di URL koneksi atau di kotak dialog properti koneksi klien SQL.
+ Properti dari objek properti koneksi yang ditentukan dalam `getConnection` panggilan.
+ Parameter konfigurasi dipercepat dalam URL koneksi.
# Opsi untuk konfigurasi driver JDBC versi 2.x
Berikut ini, Anda dapat menemukan deskripsi untuk opsi yang dapat Anda tentukan untuk driver Amazon Redshift JDBC versi 2.2. Opsi konfigurasi tidak peka huruf besar/kecil.
Anda dapat mengatur properti konfigurasi menggunakan URL koneksi. Untuk informasi selengkapnya, lihat [Membangun URL koneksi](jdbc20-build-connection-url.md).
**Topics**
+ [AccessKeyID](#jdbc20-accesskeyid-option)
+ [Izinkan DBUser Override](#jdbc20-allowdbuseroverride-option)
+ [App\$1ID](#jdbc20-app-id-option)
+ [App\$1Nama](#jdbc20-app-name-option)
+ [ApplicationName](#jdbc20-applicationname-option)
+ [AuthProfile](#jdbc20-authprofile-option)
+ [AutoCreate](#jdbc20-autocreate-option)
+ [Client\$1ID](#jdbc20-client_id-option)
+ [Klien\$1Rahasia](#jdbc20-client_secret-option)
+ [ClusterID](#jdbc20-clusterid-option)
+ [Kompresi](#jdbc20-compression-option)
+ [ConnectTimeout](#jdbc20-connecttimeout-option)
+ [ConnectionTimeZone](#jdbc20-connecttimezone-option)
+ [databaseMetadataCurrentDbOnly](#jdbc20-databasemetadatacurrentdbonly-option)
+ [DbUser](#jdbc20-dbuser-option)
+ [DbGroups](#jdbc20-dbgroups-option)
+ [DBNAME](#jdbc20-dbname-option)
+ [defaultRowFetchUkuran](#jdbc20-defaultrowfetchsize-option)
+ [DisableIsValidQuery](#jdbc20-disableisvalidquery-option)
+ [enableFetchRingPenyangga](#jdbc20-enablefetchringbuffer-option)
+ [enableMultiSqlSupport](#jdbc20-enablemultisqlsupport-option)
+ [fetchRingBufferUkuran](#jdbc20-fetchringbuffersize-option)
+ [ForceLowercase](#jdbc20-forcelowercase-option)
+ [GroupFederation](#jdbc20-groupFederation-option)
+ [HOST](#jdbc20-host-option)
+ [IAMDisableCache](#jdbc20-iamdisablecache-option)
+ [IAMDuration](#jdbc20-iamduration-option)
+ [Idc\$1Client\$1Display\$1Name](#jdbc20-idc_client_display_name)
+ [Wilayah Idc\$1](#jdbc20-idc_region)
+ [IDP\$1Host](#jdbc20-idp_host-option)
+ [IDP\$1partisi](#jdbc20-idp_partition-option)
+ [IDP\$1port](#jdbc20-idp_port-option)
+ [IDP\$1penyewa](#jdbc20-idp_tenant-option)
+ [IDP\$1Response\$1Timeout](#jdbc20-idp_response_timeout-option)
+ [IniFile](#jdbc20-inifile-option)
+ [IniSection](#jdbc20-inisection-option)
+ [ISServerless](#jdbc20-isserverless-option)
+ [Isuer\$1Url](#jdbc20-issuer-url)
+ [Dengarkan\$1Port](#jdbc20-listen-port)
+ [Login\$1URL](#jdbc20-login_url-option)
+ [loginTimeout](#jdbc20-logintimeout-option)
+ [loginToRp](#jdbc20-logintorp-option)
+ [LogLevel](#jdbc20-loglevel-option)
+ [LogPath](#jdbc20-logpath-option)
+ [OverrideSchemaPatternType](#jdbc20-override-schema-pattern-type)
+ [Partner\$1SPID](#jdbc20-partner_spid-option)
+ [Kata Sandi](#jdbc20-password-option)
+ [Plugin\$1Nama](#jdbc20-plugin_name-option)
+ [PELABUHAN](#jdbc20-port-option)
+ [Diutamakan\$1Peran](#jdbc20-preferred_role-option)
+ [Profil](#jdbc20-profile-option)
+ [PWD](#jdbc20-pwd-option)
+ [QueryGroup](#jdbc20-querygroup-option)
+ [ReadOnly](#jdbc20-readonly-option)
+ [Region](#jdbc20-region-option)
+ [reWriteBatchedSisipan](#jdbc20-rewritebatchedinserts-option)
+ [reWriteBatchedInsertsSize](#jdbc20-rewritebatchedinsertssize-option)
+ [roleArn](#jdbc20-rolearn-option)
+ [roleSessionName](#jdbc20-roleaessionname-option)
+ [cakupan](#jdbc20-scope-option)
+ [SecretAccessKey](#jdbc20-secretaccesskey-option)
+ [SessionToken](#jdbc20-sessiontoken-option)
+ [serverlessAcctId](#jdbc20-serverlessacctid-option)
+ [serverlessWorkGroup](#jdbc20-serverlessworkgroup-option)
+ [Pabrik Socket](#jdbc20-socketfactory-option)
+ [socketTimeout](#jdbc20-sockettimeout-option)
+ [SSL](#jdbc20-ssl-option)
+ [SSL\$1tidak aman](#jdbc20-ssl_insecure-option)
+ [SSLCert](#jdbc20-sslcert-option)
+ [SSLFactory](#jdbc20-sslfactory-option)
+ [SSLKey](#jdbc20-sslkey-option)
+ [SSLMode](#jdbc20-sslmode-option)
+ [SSLPassword](#jdbc20-sslpassword-option)
+ [SSLRootSertifikat](#jdbc20-sslrootcert-option)
+ [StsEndpointUrl](#jdbc20-stsendpointurl-option)
+ [tcpKeepAlive](#jdbc20-tcpkeepalive-option)
+ [token](#jdbc20-token-option)
+ [token\$1type](#jdbc20-token-type-option)
+ [UID](#jdbc20-uid-option)
+ [Pengguna](#jdbc20-user-option)
+ [webIdentityToken](#jdbc20-webidentitytoken-option)
## AccessKeyID
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Anda dapat menentukan parameter ini untuk memasukkan kunci akses IAM untuk pengguna atau peran. Anda biasanya dapat menemukan kunci dengan melihat dan string atau profil pengguna yang ada. Jika Anda menentukan parameter ini, Anda juga harus menentukan `SecretAccessKey` parameter. Jika diteruskan dalam URL JDBC, AccessKey ID harus dikodekan URL.
Parameter ini bersifat opsional.
## Izinkan DBUser Override
+ **Nilai Default** - 0
+ **Tipe Data** - String
Opsi ini menentukan apakah driver menggunakan `DbUser` nilai dari pernyataan SAMP atau nilai yang ditentukan dalam properti `DbUser` koneksi di URL koneksi.
Parameter ini bersifat opsional.
**1**
Pengemudi menggunakan `DbUser` nilai dari pernyataan SAMP.
Jika pernyataan SAMP tidak menentukan nilai untuk`DBUser`, driver menggunakan nilai yang ditentukan dalam properti koneksi. `DBUser` Jika properti koneksi juga tidak menentukan nilai, driver menggunakan nilai yang ditentukan dalam profil koneksi.
**0**
Driver menggunakan `DBUser` nilai yang ditentukan dalam properti `DBUser` koneksi.
Jika properti `DBUser` koneksi tidak menentukan nilai, driver menggunakan nilai yang ditentukan dalam profil koneksi. Jika profil koneksi juga tidak menentukan nilai, driver menggunakan nilai dari pernyataan SAMP.
## App\$1ID
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
ID unik yang disediakan OKTA yang terkait dengan aplikasi Amazon Redshift Anda.
Parameter ini diperlukan jika mengautentikasi melalui layanan Okta.
## App\$1Nama
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama aplikasi Okta yang Anda gunakan untuk mengautentikasi koneksi ke Amazon Redshift.
Parameter ini bersifat opsional.
## ApplicationName
+ **Nilai Default** - null
+ **Tipe Data** - String
Nama aplikasi untuk diteruskan ke Amazon Redshift untuk tujuan audit.
Parameter ini bersifat opsional.
## AuthProfile
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama profil otentikasi yang akan digunakan untuk menghubungkan ke Amazon Redshift.
Parameter ini bersifat opsional.
## AutoCreate
+ **Nilai Default** - false
+ **Tipe Data** - Boolean
Opsi ini menentukan apakah driver menyebabkan pengguna baru dibuat ketika pengguna tertentu tidak ada.
Parameter ini bersifat opsional.
**true**
Jika pengguna yang ditentukan oleh salah satu `DBUser` atau ID unik (UID) tidak ada, pengguna baru dengan nama itu akan dibuat.
**false**
Driver tidak menyebabkan pengguna baru dibuat. Jika pengguna yang ditentukan tidak ada, otentikasi gagal.
## Client\$1ID
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
ID klien yang akan digunakan saat mengautentikasi koneksi menggunakan layanan Azure AD.
Parameter ini diperlukan jika mengautentikasi melalui layanan Azure AD.
## Klien\$1Rahasia
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Rahasia Klien untuk digunakan saat mengautentikasi koneksi menggunakan layanan Azure AD.
Parameter ini diperlukan jika mengautentikasi melalui layanan Azure AD.
## ClusterID
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama cluster Amazon Redshift yang ingin Anda sambungkan. Pengemudi mencoba mendeteksi parameter ini dari host yang diberikan. Jika Anda menggunakan Network Load Balancer (NLB) dan terhubung melalui IAM, driver akan gagal mendeteksinya, sehingga Anda dapat mengaturnya menggunakan opsi koneksi ini.
Parameter ini bersifat opsional.
## Kompresi
+ **Nilai Default** - off
+ **Tipe Data** - String
Metode kompresi yang digunakan untuk komunikasi protokol kawat antara server Amazon Redshift dan klien atau driver.
Parameter ini bersifat opsional.
Anda dapat menentukan salah satu nilai berikut:
+ **lz4**
Menetapkan metode kompresi yang digunakan untuk komunikasi protokol kawat dengan Amazon Redshift ke lz4.
+ **off**
Tidak menggunakan kompresi untuk komunikasi protokol kawat dengan Amazon Redshift.
## ConnectTimeout
+ **Nilai Default** - 10
+ **Tipe Data** - Integer
Nilai batas waktu yang digunakan untuk operasi koneksi soket. Jika waktu yang diperlukan untuk membuat koneksi Amazon Redshift melebihi nilai ini, koneksi dianggap tidak tersedia. Batas waktu ditentukan dalam hitungan detik. Nilai 0 berarti tidak ada batas waktu yang ditentukan.
Parameter ini bersifat opsional.
## ConnectionTimeZone
+ **Nilai Default** - LOKAL
+ **Tipe Data** - String
Zona waktu tingkat sesi.
Parameter ini bersifat opsional.
Anda dapat menentukan salah satu nilai berikut:
**LOKAL**
Mengkonfigurasi zona waktu tingkat sesi ke zona waktu JVM LOKAL.
**PELADEN**
Mengonfigurasi zona waktu tingkat sesi ke zona waktu yang ditetapkan untuk pengguna di server Amazon Redshift. Anda dapat mengonfigurasi zona waktu tingkat sesi untuk pengguna dengan perintah berikut:
```
ALTER USER
[...]
SET TIMEZONE TO [...];
```
## databaseMetadataCurrentDbOnly
+ **Nilai Default** - benar
+ **Tipe Data** - Boolean
Opsi ini menentukan apakah API metadata mengambil data dari semua database yang dapat diakses atau hanya dari database yang terhubung.
Parameter ini bersifat opsional.
Anda dapat menentukan salah satu nilai berikut:
**true**
Aplikasi mengambil metadata dari database tunggal.
**false**
Aplikasi mengambil metadata dari semua database yang dapat diakses.
## DbUser
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
ID pengguna untuk digunakan dengan akun Amazon Redshift Anda. Anda dapat menggunakan ID yang saat ini tidak ada jika Anda telah mengaktifkan AutoCreate properti.
Parameter ini bersifat opsional.
## DbGroups
+ **Nilai Default** - PUBLIK
+ **Tipe Data** - String
Daftar dipisahkan koma dari nama grup database yang ada yang `DBUser` bergabung untuk sesi saat ini.
Parameter ini bersifat opsional.
## DBNAME
+ **Nilai Default** - null
+ **Tipe Data** - String
Nama database untuk terhubung. Anda dapat menggunakan opsi ini untuk menentukan nama database di URL koneksi JDBC.
Parameter ini diperlukan. Anda harus menentukan nama database, baik di URL koneksi atau di properti koneksi aplikasi klien.
## defaultRowFetchUkuran
+ **Nilai Default** - 0
+ **Tipe Data** - Integer
Opsi ini menentukan nilai default untuk getFetchSize.
Parameter ini bersifat opsional.
Anda dapat menentukan salah satu nilai berikut:
**0**
Ambil semua baris dalam satu operasi.
**Integer positif**
Jumlah baris yang akan diambil dari database untuk setiap iterasi pengambilan. ResultSet
## DisableIsValidQuery
+ **Nilai Default** - Salah
+ **Tipe Data** - Boolean
Opsi ini menentukan apakah driver mengirimkan query database baru saat menggunakan metode connection.isValid () untuk menentukan apakah koneksi database aktif.
Parameter ini bersifat opsional.
**true**
Driver tidak mengirimkan kueri saat menggunakan Connection.isValid () untuk menentukan apakah koneksi database aktif. Hal ini dapat menyebabkan driver salah mengidentifikasi koneksi database sebagai aktif jika server database telah dimatikan secara tak terduga.
**false**
Driver mengirimkan kueri saat menggunakan connection.isValid () untuk menentukan apakah koneksi database aktif.
## enableFetchRingPenyangga
+ **Nilai Default** - benar
+ **Tipe Data** - Boolean
Opsi ini menentukan bahwa driver mengambil baris menggunakan buffer cincin pada utas terpisah. Parameter fetchRingBuffer Ukuran menentukan ukuran buffer cincin.
Buffer ring mengimplementasikan manajemen memori otomatis di JDBC untuk mencegah kesalahan out-of-memory (OOM) selama operasi pengambilan data. Buffer ring memantau ukuran sebenarnya dari data buffer secara real-time, memastikan penggunaan memori total oleh driver tetap dalam batas yang ditentukan. Ketika kapasitas buffer tercapai, driver menghentikan operasi pengambilan data, mencegah memori meluap tanpa memerlukan intervensi manual. Pengamanan bawaan ini menghilangkan kesalahan OOM secara otomatis, tanpa konfigurasi yang diperlukan dari pengguna.
Jika transaksi mendeteksi Pernyataan yang berisi beberapa perintah SQL yang dipisahkan oleh titik koma, buffer ring fetch untuk transaksi tersebut disetel ke false. enableFetchRingNilai buffer tidak berubah.
Parameter ini bersifat opsional.
**catatan**
Ketika buffer cincin dinonaktifkan dan ukuran pengambilan tidak dikonfigurasi dengan benar, masalah out-of-memory (OOM) dapat terjadi. [Untuk informasi selengkapnya tentang mengonfigurasi ukuran pengambilan, lihat di sini.](https://docs.aws.amazon.com/redshift/latest/dg/set-the-JDBC-fetch-size-parameter.html)
## enableMultiSqlSupport
+ **Nilai Default** - benar
+ **Tipe Data** - Boolean
Opsi ini menentukan apakah akan memproses beberapa perintah SQL dipisahkan oleh titik koma dalam Pernyataan.
Parameter ini bersifat opsional.
Anda dapat menentukan salah satu nilai berikut:
**true**
Driver memproses beberapa perintah SQL, dipisahkan oleh titik koma, dalam objek Pernyataan.
**false**
Driver mengembalikan kesalahan untuk beberapa perintah SQL dalam satu Pernyataan.
## fetchRingBufferUkuran
+ **Nilai Default** - 1G
+ **Tipe Data** - String
Opsi ini menentukan ukuran buffer cincin yang digunakan saat mengambil set hasil. Anda dapat menentukan ukuran dalam byte, misalnya 1K untuk 1 KB, 5000 untuk 5.000 byte, 1M untuk 1 MB, 1G untuk 1 GB, dan seterusnya. Anda juga dapat menentukan persentase memori heap. Pengemudi berhenti mengambil baris setelah mencapai batas. Mengambil dilanjutkan saat aplikasi membaca baris dan membebaskan ruang di buffer ring.
Parameter ini bersifat opsional.
## ForceLowercase
+ **Nilai Default** - false
+ **Tipe Data** - Boolean
Opsi ini menentukan apakah driver huruf kecil semua grup database (DbGroups) yang dikirim dari penyedia identitas ke Amazon Redshift saat menggunakan autentikasi masuk tunggal.
Parameter ini bersifat opsional.
**true**
Driver huruf kecil semua grup database yang dikirim dari penyedia identitas.
**false**
Pengemudi tidak mengubah grup basis data.
## GroupFederation
+ **Nilai Default** - false
+ **Tipe Data** - Boolean
Opsi ini menentukan apakah akan menggunakan grup IDP Amazon Redshift. Ini didukung oleh API GetClusterCredentials V2.
Parameter ini bersifat opsional.
**true**
Gunakan grup Amazon Redshift Identity Provider (IDP).
**false**
Gunakan STS API dan GetClusterCredentials untuk federasi pengguna dan tentukan secara eksplisit DbGroups untuk koneksi.
## HOST
+ **Nilai Default** - null
+ **Tipe Data** - String
Nama host dari server Amazon Redshift untuk terhubung. Anda dapat menggunakan opsi ini untuk menentukan nama host di URL koneksi JDBC.
Parameter ini diperlukan. Anda harus menentukan nama host, baik di URL koneksi atau di properti koneksi aplikasi klien.
## IAMDisableCache
+ **Nilai Default** - false
+ **Tipe Data** - Boolean
Opsi ini menentukan apakah kredensyal IAM di-cache.
Parameter ini bersifat opsional.
**true**
Kredensi IAM tidak di-cache.
**false**
Kredensi IAM di-cache. Ini meningkatkan kinerja saat permintaan ke gateway API dibatasi, misalnya.
## IAMDuration
+ **Nilai Default** - 900
+ **Tipe Data** - Integer
Lamanya waktu, dalam hitungan detik, hingga kredensyal IAM sementara kedaluwarsa.
+ **Nilai minimum** - 900
+ **Nilai maksimum** - 3.600
Parameter ini bersifat opsional.
## Idc\$1Client\$1Display\$1Name
+ **Nilai Default** - Driver Amazon Redshift JDBC
+ **Tipe Data** - String
Nama tampilan yang akan digunakan untuk klien yang menggunakan BrowserIdcAuthPlugin.
Parameter ini bersifat opsional.
## Wilayah Idc\$1
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
AWS Wilayah di mana instans IAM Identity Center berada.
Parameter ini diperlukan hanya ketika mengautentikasi menggunakan `BrowserIdcAuthPlugin` dalam opsi konfigurasi plugin\$1name.
## IDP\$1Host
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Host iDP (penyedia identitas) yang Anda gunakan untuk mengautentikasi ke Amazon Redshift. Ini dapat ditentukan baik dalam string koneksi atau dalam profil.
Parameter ini bersifat opsional.
## IDP\$1partisi
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Menentukan partisi cloud tempat penyedia identitas Anda (iDP) dikonfigurasi. Ini menentukan titik akhir otentikasi IDP mana yang terhubung ke driver.
Jika parameter ini dibiarkan kosong, driver default ke partisi komersial. Kemungkinan nilainya adalah:
+ `us-gov`: Gunakan nilai ini jika IDP Anda dikonfigurasi di Azure Government. Misalnya, Azure AD Government menggunakan `login.microsoftonline.us` endpoint.
+ `cn`: Gunakan nilai ini jika IDP Anda dikonfigurasi di partisi cloud Tiongkok. Misalnya, Azure AD Tiongkok menggunakan titik akhir. `login.chinacloudapi.cn`
Parameter ini bersifat opsional.
## IDP\$1port
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Port yang digunakan oleh iDP (penyedia identitas). Anda dapat menentukan port baik dalam string koneksi atau dalam profil. Port default adalah 5439. Bergantung pada port yang Anda pilih saat membuat, memodifikasi, atau memigrasi klaster, izinkan akses ke port yang dipilih.
Parameter ini bersifat opsional.
## IDP\$1penyewa
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
ID penyewa Azure AD untuk aplikasi Amazon Redshift Anda.
Parameter ini diperlukan jika mengautentikasi melalui layanan Azure AD.
## IDP\$1Response\$1Timeout
+ **Nilai Default** - 120
+ **Tipe Data** - Integer
Jumlah waktu, dalam hitungan detik, driver menunggu respons SAMP dari penyedia identitas saat menggunakan layanan SAMP atau Azure AD melalui plugin browser.
Parameter ini bersifat opsional.
## IniFile
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Jalur lengkap dari file.ini, termasuk nama file. Contoh:
```
IniFile="C:\tools\rsjdbc.ini"
```
Untuk informasi tentang file.ini, lihat[Membuat file inisialisasi (.ini) untuk driver JDBC versi 2.x](jdbc20-ini-file.md).
Parameter ini bersifat opsional.
## IniSection
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama bagian dalam file.ini yang berisi opsi konfigurasi. Untuk informasi tentang file.ini, lihat[Membuat file inisialisasi (.ini) untuk driver JDBC versi 2.x](jdbc20-ini-file.md).
Contoh berikut menentukan bagian [Prod] dari file.ini:
```
IniSection="Prod"
```
Parameter ini bersifat opsional.
## ISServerless
+ **Nilai Default** - false
+ **Tipe Data** - Boolean
Opsi ini menentukan apakah host endpoint Amazon Redshift adalah instance tanpa server. Pengemudi mencoba mendeteksi parameter ini dari host yang diberikan. Jika Anda menggunakan Network Load Balancer (NLB), driver akan gagal mendeteksinya, sehingga Anda dapat mengaturnya di sini.
Parameter ini bersifat opsional.
**true**
Host endpoint Amazon Redshift adalah instance tanpa server.
**false**
Host endpoint Amazon Redshift adalah cluster yang disediakan.
## Isuer\$1Url
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Menunjuk ke titik akhir instance server AWS IAM Identity Center.
Parameter ini diperlukan hanya ketika mengautentikasi menggunakan `BrowserIdcAuthPlugin` dalam opsi konfigurasi plugin\$1name.
## Dengarkan\$1Port
+ **Nilai default** - 7890
+ **Tipe Data** - Integer
Port yang digunakan driver untuk menerima respons SAMP dari penyedia identitas atau kode otorisasi saat menggunakan layanan SAMP, Azure AD, atau AWS Identity Center melalui plugin browser.
Parameter ini bersifat opsional.
## Login\$1URL
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
URL untuk sumber daya di situs web penyedia identitas saat menggunakan layanan SAMP atau Azure AD melalui plugin browser.
Parameter ini diperlukan jika mengautentikasi dengan layanan SAMP atau Azure AD melalui plugin browser.
## loginTimeout
+ **Nilai Default** - 0
+ **Tipe Data** - Integer
Jumlah detik untuk menunggu sebelum waktu habis saat menghubungkan dan mengautentikasi ke server. Jika membuat koneksi membutuhkan waktu lebih lama dari ambang ini, maka koneksi dibatalkan.
Ketika properti ini disetel ke 0, koneksi tidak akan habis waktu.
Parameter ini bersifat opsional.
## loginToRp
+ **Nilai Default** - `urn:amazon:webservices`
+ **Tipe Data** - String
Pihak yang mengandalkan percaya bahwa Anda ingin menggunakan untuk jenis otentikasi AD FS.
Parameter ini bersifat opsional.
## LogLevel
+ **Nilai Default** - 0
+ **Tipe Data** - Integer
Gunakan properti ini untuk mengaktifkan atau mematikan logging di driver dan untuk menentukan jumlah detail yang disertakan dalam file log.
Aktifkan logging hanya cukup lama untuk menangkap masalah. Logging mengurangi kinerja dan dapat mengkonsumsi sejumlah besar ruang disk.
Parameter ini bersifat opsional.
Atur parameter ke salah satu nilai berikut:
**0**
Nonaktifkan semua logging.
**1**
Aktifkan logging pada level FATAL, yang mencatat peristiwa kesalahan yang sangat parah yang akan menyebabkan pengemudi membatalkan.
**2**
Aktifkan logging pada level ERROR, yang mencatat peristiwa kesalahan yang mungkin masih memungkinkan driver untuk terus berjalan.
**3**
Aktifkan pencatatan pada tingkat PERINGATAN, yang mencatat peristiwa yang mungkin mengakibatkan kesalahan jika tindakan tidak dilakukan.
**4**
Aktifkan logging pada tingkat INFO, yang mencatat informasi umum yang menjelaskan kemajuan driver.
**5**
Aktifkan logging pada level DEBUG, yang mencatat informasi terperinci yang berguna untuk men-debug driver.
**6**
Aktifkan logging pada level TRACE, yang mencatat semua aktivitas driver.
Saat logging diaktifkan, driver menghasilkan file log berikut di lokasi yang ditentukan dalam `LogPath` properti:
+ **`redshift_jdbc.log`**— File yang mencatat aktivitas driver yang tidak spesifik untuk koneksi.
+ **`redshift_jdbc_connection_[Number].log`**— File untuk setiap koneksi yang dibuat ke database, di mana `[Number]` adalah nomor yang membedakan setiap file log dari yang lain. File ini mencatat aktivitas driver yang khusus untuk koneksi.
Jika LogPath nilainya tidak valid, driver mengirimkan informasi yang dicatat ke aliran output standar,. `System.out`
## LogPath
+ **Nilai Default** - Direktori kerja saat ini.
+ **Tipe Data** - String
Jalur lengkap ke folder tempat driver menyimpan file log saat properti DSILog Level diaktifkan.
Untuk memastikan bahwa URL koneksi kompatibel dengan semua aplikasi JDBC, kami sarankan Anda melarikan diri dari garis miring terbalik (\$1) di jalur file Anda dengan mengetik garis miring terbalik lainnya.
Parameter ini bersifat opsional.
## OverrideSchemaPatternType
+ **Nilai Default** - null
+ **Tipe Data** - Integer
Opsi ini menentukan apakah akan mengganti jenis query yang digunakan dalam panggilan getTables.
**0**
Tidak ada Skema Universal Query
**1**
Kueri Skema Lokal
**2**
Kueri Skema Eksternal
Parameter ini bersifat opsional.
## Partner\$1SPID
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nilai SPID mitra (ID penyedia layanan) yang akan digunakan saat mengautentikasi koneksi menggunakan layanan. PingFederate
Parameter ini bersifat opsional.
## Kata Sandi
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Saat menghubungkan menggunakan otentikasi IAM melalui IDP, ini adalah kata sandi untuk server IDP\$1Host. Saat menggunakan otentikasi standar, ini dapat digunakan untuk kata sandi database Amazon Redshift alih-alih PWD.
Parameter ini bersifat opsional.
## Plugin\$1Nama
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama kelas yang sepenuhnya memenuhi syarat untuk mengimplementasikan plugin penyedia kredensional tertentu.
Parameter ini bersifat opsional.
Opsi penyedia berikut didukung:
+ **`AdfsCredentialsProvider`**— Layanan Federasi Direktori Aktif.
+ **`AzureCredentialsProvider`**— Layanan Microsoft Azure Active Directory (AD).
+ **`BasicJwtCredentialsProvider`**— Layanan Token Web JSON (JWT).
+ **`BasicSamlCredentialsProvider`**— Kredensyal Security Assertion Markup Language (SAMP) yang dapat Anda gunakan dengan banyak penyedia layanan SAMP.
+ **`BrowserAzureCredentialsProvider`**— Browser Layanan Microsoft Azure Active Directory (AD).
+ **`BrowserAzureOAuth2CredentialsProvider`**— Layanan Browser Microsoft Azure Active Directory (AD) untuk Otentikasi Asli.
+ **`BrowserIdcAuthPlugin`**- Plugin otorisasi menggunakan AWS IAM Identity Center.
+ **`BrowserSamlCredentialsProvider`**— Browser SAMP untuk layanan SAMP seperti Okta, Ping, atau ADFS.
+ **`IdpTokenAuthPlugin`**- Plugin otorisasi yang menerima token AWS IAM Identity Center atau OpenID Connect (OIDC) JSON berbasis token identitas (JWT) dari penyedia identitas web mana pun yang terhubung ke IAM Identity Center. AWS
+ **`OktaCredentialsProvider`**— Layanan Okta.
+ **`PingCredentialsProvider`**— PingFederate Layanan.
## PELABUHAN
+ **Nilai Default** - null
+ **Tipe Data** - Integer
Port server Amazon Redshift untuk terhubung. Anda dapat menggunakan opsi ini untuk menentukan port di URL koneksi JDBC.
Parameter ini bersifat opsional.
## Diutamakan\$1Peran
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Peran IAM yang ingin Anda asumsikan selama koneksi ke Amazon Redshift.
Parameter ini bersifat opsional.
## Profil
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama profil yang akan digunakan untuk otentikasi IAM. Profil ini berisi properti koneksi tambahan yang tidak ditentukan dalam string koneksi.
Parameter ini bersifat opsional.
## PWD
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Kata sandi yang sesuai dengan nama pengguna Amazon Redshift yang Anda berikan menggunakan UID properti.
Parameter ini bersifat opsional.
## QueryGroup
+ **Nilai Default** - null
+ **Tipe Data** - String
Opsi ini menetapkan kueri ke antrian saat runtime dengan menetapkan kueri Anda ke grup kueri yang sesuai. Grup kueri diatur untuk sesi. Semua kueri yang berjalan pada koneksi milik grup kueri ini.
Parameter ini bersifat opsional.
## ReadOnly
+ **Nilai Default** - false
+ **Tipe Data** - Boolean
Properti ini menentukan apakah driver dalam mode read-only.
Parameter ini bersifat opsional.
**true**
Koneksi dalam mode read-only dan tidak dapat menulis ke penyimpanan data.
**false**
Koneksi tidak dalam mode read-only dan dapat menulis ke penyimpanan data.
## Region
+ **Nilai Default** - null
+ **Tipe Data** - String
Opsi ini menentukan AWS Wilayah di mana cluster berada. Jika Anda menentukan StsEndPoint opsi, opsi Wilayah diabaikan. Operasi Redshift `GetClusterCredentials` API juga menggunakan opsi Region.
Parameter ini bersifat opsional.
## reWriteBatchedSisipan
+ **Nilai Default** - false
+ **Tipe Data** - Boolean
Opsi ini memungkinkan pengoptimalan untuk menulis ulang dan menggabungkan pernyataan INSERT yang kompatibel ke dalam batch.
Parameter ini bersifat opsional.
## reWriteBatchedInsertsSize
+ **Nilai Default** - 128
+ **Tipe Data** - Integer
Opsi ini memungkinkan pengoptimalan untuk menulis ulang dan menggabungkan pernyataan INSERT yang kompatibel ke dalam batch. Nilai ini harus meningkat secara eksponensial dengan kekuatan 2.
Parameter ini bersifat opsional.
## roleArn
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama Sumber Daya Amazon (ARN) peran. Pastikan untuk menentukan parameter ini saat Anda menentukan opsi BasicJwtCredentialsProvider Plugin\$1Name. Anda menentukan ARN dalam format berikut:
`arn:partition:service:region:account-id:resource-id`
Parameter ini diperlukan jika Anda menentukan BasicJwtCredentialsProvider untuk opsi Plugin\$1Name.
## roleSessionName
+ **Nilai Default** - jwt\$1redshift\$1session
+ **Tipe Data** - String
Sebuah pengenal untuk sesi peran yang diambil. Biasanya, Anda melewati nama atau pengenal yang terkait dengan pengguna aplikasi Anda. Kredensil keamanan sementara yang digunakan aplikasi Anda terkait dengan pengguna tersebut. Anda dapat menentukan parameter ini ketika Anda menentukan BasicJwtCredentialsProvider untuk opsi Plugin\$1Name.
Parameter ini bersifat opsional.
## cakupan
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Daftar cakupan yang dipisahkan ruang yang dapat disetujui pengguna. Anda menentukan parameter ini sehingga aplikasi Microsoft Azure Anda bisa mendapatkan persetujuan untuk APIs yang ingin Anda panggil. Anda dapat menentukan parameter ini ketika Anda menentukan BrowserAzure OAuth2 CredentialsProvider untuk opsi Plugin\$1Name.
Parameter ini diperlukan untuk BrowserAzure OAuth2 CredentialsProvider plug-in.
## SecretAccessKey
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Kunci akses IAM untuk pengguna atau peran. Jika ini ditentukan, maka AccessKey ID juga harus ditentukan. Jika diteruskan dalam URL JDBC, SecretAccessKey harus dikodekan URL.
Parameter ini bersifat opsional.
## SessionToken
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Token sesi IAM sementara yang terkait dengan peran IAM yang Anda gunakan untuk mengautentikasi. Jika diteruskan dalam URL JDBC, token sesi IAM sementara harus dikodekan URL.
Parameter ini bersifat opsional.
## serverlessAcctId
+ **Nilai Default** - null
+ **Tipe Data** - String
ID akun Tanpa Server Amazon Redshift. Pengemudi mencoba mendeteksi parameter ini dari host yang diberikan. Jika Anda menggunakan Network Load Balancer (NLB), driver akan gagal mendeteksinya, sehingga Anda dapat mengaturnya di sini.
Parameter ini bersifat opsional.
## serverlessWorkGroup
+ **Nilai Default** - null
+ **Tipe Data** - String
Nama workgroup Amazon Redshift Tanpa Server. Pengemudi mencoba mendeteksi parameter ini dari host yang diberikan. Jika Anda menggunakan Network Load Balancer (NLB), driver akan gagal mendeteksinya, sehingga Anda dapat mengaturnya di sini.
Parameter ini bersifat opsional.
## Pabrik Socket
+ **Nilai Default** - null
+ **Tipe Data** - String
Opsi ini menentukan pabrik soket untuk pembuatan soket.
Parameter ini bersifat opsional.
## socketTimeout
+ **Nilai Default** - 0
+ **Tipe Data** - Integer
Jumlah detik untuk menunggu selama operasi pembacaan soket sebelum waktu habis. Jika operasi memakan waktu lebih lama dari ambang ini, maka koneksi ditutup. Ketika properti ini disetel ke 0, koneksi tidak akan habis waktu.
Parameter ini bersifat opsional.
## SSL
+ **Nilai Default** - BENAR
+ **Tipe Data** - String
Gunakan properti ini untuk mengaktifkan atau mematikan SSL untuk koneksi.
Parameter ini bersifat opsional.
Anda dapat menentukan salah satu nilai berikut:
**BETUL**
Driver terhubung ke server melalui SSL.
**SALAH**
Driver terhubung ke server tanpa menggunakan SSL. Opsi ini tidak didukung dengan otentikasi IAM.
Atau, Anda dapat mengkonfigurasi AuthMech properti.
## SSL\$1tidak aman
+ **Nilai Default** - benar
+ **Tipe Data** - String
Properti ini menunjukkan apakah sertifikat server host IDP harus diverifikasi.
Parameter ini bersifat opsional.
Anda dapat menentukan salah satu nilai berikut:
**true**
Pengemudi tidak memeriksa keaslian sertifikat server IDP.
**false**
Pengemudi memeriksa keaslian sertifikat server IDP.
## SSLCert
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Jalur lengkap file.pem atau .crt yang berisi sertifikat CA tepercaya tambahan untuk memverifikasi instance server Amazon Redshift saat menggunakan SSL.
Parameter ini diperlukan jika SSLKey ditentukan.
## SSLFactory
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Pabrik SSL untuk digunakan saat menghubungkan ke server melalui TLS/SSL tanpa menggunakan sertifikat server.
## SSLKey
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Jalur lengkap dari file.der yang berisi file PKCS8 kunci untuk memverifikasi sertifikat yang ditentukan dalam SSLCert file.
Parameter ini diperlukan jika SSLCert ditentukan.
## SSLMode
+ **Nilai Default** - verify-ca
+ **Tipe Data** - String
Gunakan properti ini untuk menentukan bagaimana driver memvalidasi sertifikat saat TLS/SSL diaktifkan.
Parameter ini bersifat opsional.
Anda dapat menentukan salah satu nilai berikut:
**verify-ca**
Pengemudi memverifikasi bahwa sertifikat tersebut berasal dari otoritas sertifikat tepercaya (CA).
**verify-full**
Pengemudi memverifikasi bahwa sertifikat berasal dari CA tepercaya dan bahwa nama host dalam sertifikat cocok dengan nama host yang ditentukan dalam URL koneksi.
## SSLPassword
+ **Nilai Default** - 0
+ **Tipe Data** - String
Kata sandi untuk file kunci terenkripsi yang ditentukan dalam. SSLKey
Parameter ini diperlukan jika SSLKey ditentukan dan file kunci dienkripsi.
## SSLRootSertifikat
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Jalur lengkap file.pem atau .crt yang berisi sertifikat CA root untuk memverifikasi instance Amazon Redshift Server saat menggunakan SSL.
## StsEndpointUrl
+ **Nilai Default** - null
+ **Tipe Data** - String
Anda dapat menentukan titik akhir AWS Security Token Service (AWS STS). Jika Anda menentukan opsi ini, opsi Wilayah diabaikan. Anda hanya dapat menentukan protokol aman (HTTPS) untuk titik akhir ini.
## tcpKeepAlive
+ **Nilai Default** - BENAR
+ **Tipe Data** - String
Gunakan properti ini untuk mengaktifkan atau mematikan keepalives TCP.
Parameter ini bersifat opsional.
Anda dapat menentukan salah satu nilai berikut:
**BETUL**
Driver menggunakan TCP keepalives untuk mencegah koneksi dari timing out.
**SALAH**
Driver tidak menggunakan TCP keepalives.
## token
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Pusat AWS Identitas IAM menyediakan token akses atau OpenID Connect (OIDC) JSON Web Token (JWT) yang disediakan oleh penyedia identitas web yang terhubung dengan IAM Identity Center. AWS Aplikasi Anda harus menghasilkan token ini dengan mengautentikasi pengguna aplikasi Anda dengan AWS IAM Identity Center atau penyedia identitas yang ditautkan dengan AWS IAM Identity Center.
Parameter ini bekerja dengan`IdpTokenAuthPlugin`.
## token\$1type
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Jenis token yang digunakan di`IdpTokenAuthPlugin`.
Anda dapat menentukan salah satu nilai berikut:
**ACCESS\$1TOKEN**
Masukkan ini jika Anda menggunakan token akses yang disediakan Pusat Identitas AWS IAM.
**EXT\$1JWT**
Masukkan ini jika Anda menggunakan OpenID Connect (OIDC) JSON Web Token (JWT) yang disediakan oleh penyedia identitas berbasis web yang terintegrasi dengan IAM Identity Center. AWS
Parameter ini bekerja dengan`IdpTokenAuthPlugin`.
## UID
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama pengguna database yang Anda gunakan untuk mengakses database.
Parameter ini diperlukan.
## Pengguna
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Saat menghubungkan menggunakan otentikasi IAM melalui IDP, ini adalah nama pengguna untuk server idp\$1host. Saat menggunakan otentikasi standar, ini dapat digunakan untuk nama pengguna database Amazon Redshift.
Parameter ini bersifat opsional.
## webIdentityToken
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Token akses OAuth 2.1 atau token OpenID Connect ID yang disediakan oleh penyedia identitas. Aplikasi Anda harus mendapatkan token ini dengan mengautentikasi pengguna aplikasi Anda dengan penyedia identitas web. Pastikan untuk menentukan parameter ini saat Anda menentukan opsi BasicJwtCredentialsProvider Plugin\$1Name.
Parameter ini diperlukan jika Anda menentukan BasicJwtCredentialsProvider untuk opsi Plugin\$1Name.
# Versi sebelumnya dari JDBC driver version 2.x
Unduh versi sebelumnya dari driver Amazon Redshift JDBC versi 2.x hanya jika alat Anda memerlukan versi driver tertentu.
Ini adalah driver JDBC versi 2.x versi 2.x yang kompatibel dengan JDBC 4.2 sebelumnya:
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.2.4/redshift-jdbc42-2.2.4.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.2.4/redshift-jdbc42-2.2.4.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.2.4/redshift-jdbc42-2.2.4.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.2.4/redshift-jdbc42-2.2.4.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.2.3/redshift-jdbc42-2.2.3.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.2.3/redshift-jdbc42-2.2.3.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.2.3/redshift-jdbc42-2.2.3.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.2.3/redshift-jdbc42-2.2.3.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.2.2/redshift-jdbc42-2.2.2.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.2.2/redshift-jdbc42-2.2.2.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.2.2/redshift-jdbc42-2.2.2.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.2.2/redshift-jdbc42-2.2.2.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.2.1/redshift-jdbc42-2.2.1.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.2.1/redshift-jdbc42-2.2.1.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.2.1/redshift-jdbc42-2.2.1.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.2.1/redshift-jdbc42-2.2.1.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.2.0/redshift-jdbc42-2.2.0.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.2.0/redshift-jdbc42-2.2.0.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.2.0/redshift-jdbc42-2.2.0.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.2.0/redshift-jdbc42-2.2.0.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.34/redshift-jdbc42-2.1.0.34.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.34/redshift-jdbc42-2.1.0.34.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.34/redshift-jdbc42-2.1.0.34.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.34/redshift-jdbc42-2.1.0.34.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.33/redshift-jdbc42-2.1.0.33.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.33/redshift-jdbc42-2.1.0.33.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.33/redshift-jdbc42-2.1.0.33.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.33/redshift-jdbc42-2.1.0.33.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.32/redshift-jdbc42-2.1.0.32.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.32/redshift-jdbc42-2.1.0.32.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.32/redshift-jdbc42-2.1.0.32.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.32/redshift-jdbc42-2.1.0.32.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.30/redshift-jdbc42-2.1.0.30.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.30/redshift-jdbc42-2.1.0.30.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.30/redshift-jdbc42-2.1.0.30.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.30/redshift-jdbc42-2.1.0.30.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.29/redshift-jdbc42-2.1.0.29.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.29/redshift-jdbc42-2.1.0.29.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.29/redshift-jdbc42-2.1.0.29.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.29/redshift-jdbc42-2.1.0.29.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.28/redshift-jdbc42-2.1.0.28.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.28/redshift-jdbc42-2.1.0.28.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.28/redshift-jdbc42-2.1.0.28.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.28/redshift-jdbc42-2.1.0.28.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.26/redshift-jdbc42-2.1.0.26.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.26/redshift-jdbc42-2.1.0.26.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.26/redshift-jdbc42-2.1.0.26.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.26/redshift-jdbc42-2.1.0.26.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.25/redshift-jdbc42-2.1.0.25.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.25/redshift-jdbc42-2.1.0.25.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.25/redshift-jdbc42-2.1.0.25.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.25/redshift-jdbc42-2.1.0.25.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.24/redshift-jdbc42-2.1.0.24.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.24/redshift-jdbc42-2.1.0.24.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.24/redshift-jdbc42-2.1.0.24.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.24/redshift-jdbc42-2.1.0.24.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.23/redshift-jdbc42-2.1.0.23.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.23/redshift-jdbc42-2.1.0.23.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.23/redshift-jdbc42-2.1.0.23.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.23/redshift-jdbc42-2.1.0.23.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.22/redshift-jdbc42-2.1.0.22.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.22/redshift-jdbc42-2.1.0.22.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.22/redshift-jdbc42-2.1.0.22.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.22/redshift-jdbc42-2.1.0.22.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.21/redshift-jdbc42-2.1.0.21.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.21/redshift-jdbc42-2.1.0.21.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.21/redshift-jdbc42-2.1.0.21.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.21/redshift-jdbc42-2.1.0.21.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.20/redshift-jdbc42-2.1.0.20.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.20/redshift-jdbc42-2.1.0.20.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.20/redshift-jdbc42-2.1.0.20.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.20/redshift-jdbc42-2.1.0.20.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.19/redshift-jdbc42-2.1.0.19.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.19/redshift-jdbc42-2.1.0.19.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.19/redshift-jdbc42-2.1.0.19.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.19/redshift-jdbc42-2.1.0.19.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.18/redshift-jdbc42-2.1.0.18.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.18/redshift-jdbc42-2.1.0.18.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.18/redshift-jdbc42-2.1.0.18.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.18/redshift-jdbc42-2.1.0.18.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.17/redshift-jdbc42-2.1.0.17.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.17/redshift-jdbc42-2.1.0.17.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.17/redshift-jdbc42-2.1.0.17.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.17/redshift-jdbc42-2.1.0.17.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.16/redshift-jdbc42-2.1.0.16.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.16/redshift-jdbc42-2.1.0.16.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.16/redshift-jdbc42-2.1.0.16.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.16/redshift-jdbc42-2.1.0.16.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.15/redshift-jdbc42-2.1.0.15.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.15/redshift-jdbc42-2.1.0.15.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.15/redshift-jdbc42-2.1.0.15.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.15/redshift-jdbc42-2.1.0.15.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.14/redshift-jdbc42-2.1.0.14.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.14/redshift-jdbc42-2.1.0.14.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.14/redshift-jdbc42-2.1.0.14.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.14/redshift-jdbc42-2.1.0.14.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.13/redshift-jdbc42-2.1.0.13.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.13/redshift-jdbc42-2.1.0.13.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.13/redshift-jdbc42-2.1.0.13.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.13/redshift-jdbc42-2.1.0.13.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.12/redshift-jdbc42-2.1.0.12.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.12/redshift-jdbc42-2.1.0.12.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.12/redshift-jdbc42-2.1.0.12.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.12/redshift-jdbc42-2.1.0.12.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.11/redshift-jdbc42-2.1.0.11.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.11/redshift-jdbc42-2.1.0.11.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.11/redshift-jdbc42-2.1.0.11.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.11/redshift-jdbc42-2.1.0.11.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.10/redshift-jdbc42-2.1.0.10.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.10/redshift-jdbc42-2.1.0.10.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.10/redshift-jdbc42-2.1.0.10.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.10/redshift-jdbc42-2.1.0.10.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.9/redshift-jdbc42-2.1.0.9.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.9/redshift-jdbc42-2.1.0.9.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.9/redshift-jdbc42-2.1.0.9.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.9/redshift-jdbc42-2.1.0.9.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.8/redshift-jdbc42-2.1.0.8.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.8/redshift-jdbc42-2.1.0.8.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.8/redshift-jdbc42-2.1.0.8.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.8/redshift-jdbc42-2.1.0.8.zip)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.7/redshift-jdbc42-2.1.0.7.zip](https://s3.amazonaws.com/redshift-downloads/drivers/jdbc/2.1.0.7/redshift-jdbc42-2.1.0.7.zip) [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.7/redshift-jdbc42-2.1.0.7.zip](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/jdbc/2.1.0.7/redshift-jdbc42-2.1.0.7.zip)
# Konektor Python Amazon Redshift
Dengan menggunakan konektor Amazon Redshift untuk Python, Anda dapat mengintegrasikan pekerjaan dengan [AWS SDK for Python (Boto3), dan juga panda dan Numerical Python ()](https://github.com/boto/boto3). NumPy Untuk informasi lebih lanjut tentang panda, lihat repositori [panda GitHub ](https://github.com/pandas-dev/pandas). Untuk informasi lebih lanjut tentang NumPy, lihat [NumPy GitHubrepositori](https://github.com/numpy/numpy).
Konektor Amazon Redshift Python menyediakan solusi open source. Anda dapat menelusuri kode sumber, meminta penyempurnaan, melaporkan masalah, dan memberikan kontribusi.
Untuk menggunakan konektor Amazon Redshift Python, pastikan Anda memiliki Python versi 3.6 atau yang lebih baru. Untuk informasi selengkapnya, lihat [perjanjian SIM Amazon Redshift Python](https://github.com/aws/amazon-redshift-python-driver/blob/master/LICENSE).
Konektor Amazon Redshift Python menyediakan yang berikut:
+ AWS Identity and Access Management (IAM) otentikasi. Untuk informasi selengkapnya, lihat [Manajemen identitas dan akses di Amazon Redshift](redshift-iam-authentication-access-control.md).
+ Otentikasi penyedia identitas menggunakan akses API federasi. Akses API federasi didukung untuk penyedia identitas perusahaan seperti berikut ini:
+ Azure AD. Untuk informasi selengkapnya, lihat postingan blog AWS Big Data Akses [Federate Amazon Redshift dengan sistem masuk tunggal Microsoft Azure AD](https://aws.amazon.com/blogs/big-data/federate-amazon-redshift-access-with-microsoft-azure-ad-single-sign-on/).
+ Layanan Federasi Direktori Aktif. Untuk informasi selengkapnya, lihat posting blog AWS Big Data [akses Federasi ke klaster Amazon Redshift Anda dengan Active Directory Federation Services (AD FS):](https://aws.amazon.com/blogs/big-data/federate-access-to-your-amazon-redshift-cluster-with-active-directory-federation-services-ad-fs-part-1/) Bagian 1.
+ Okta. Untuk informasi lebih lanjut, lihat posting blog AWS Big Data [akses Federate Amazon Redshift dengan Okta sebagai](https://aws.amazon.com/blogs/big-data/federate-amazon-redshift-access-with-okta-as-an-identity-provider/) penyedia identitas.
+ PingFederate. Untuk informasi lebih lanjut, lihat [PingFederate situs](https://www.pingidentity.com/en/software/pingfederate.html).
+ JumpCloud. Untuk informasi lebih lanjut, lihat [JumpCloud situs](https://jumpcloud.com/).
+ Jenis data Amazon Redshift.
Konektor Amazon Redshift Python mengimplementasikan Python Database API Specification 2.0. Untuk informasi selengkapnya, lihat [PEP 249—Spesifikasi API Database Python v2.0](https://www.python.org/dev/peps/pep-0249/) di situs web Python.
**Topics**
+ [Memasang konektor Amazon Redshift Python](python-driver-install.md)
+ [Opsi konfigurasi untuk konektor Amazon Redshift Python](python-configuration-options.md)
+ [Mengimpor konektor Python](python-start-import.md)
+ [Mengintegrasikan konektor Python dengan NumPy](python-connect-integrate-numpy.md)
+ [Mengintegrasikan konektor Python dengan panda](python-connect-integrate-pandas.md)
+ [Menggunakan plugin penyedia identitas](python-connect-identity-provider-plugins.md)
+ [Contoh penggunaan konektor Amazon Redshift Python](python-connect-examples.md)
+ [Referensi API untuk konektor Amazon Redshift Python](python-api-reference.md)
# Memasang konektor Amazon Redshift Python
Anda dapat menggunakan salah satu metode berikut untuk menginstal konektor Amazon Redshift Python:
+ Indeks Package Python (PyPI)
+ Conda
+ Mengkloning repositori GitHub
## Menginstal konektor Python dari PyPI
Untuk menginstal konektor Python dari Python Package Index (PyPI), Anda dapat menggunakan pip. Untuk melakukan ini, jalankan perintah berikut.
```
>>> pip install redshift_connector
```
Anda dapat menginstal konektor dalam lingkungan virtual. Untuk melakukan ini, jalankan perintah berikut.
```
>>> pip install redshift_connector
```
Secara opsional, Anda dapat menginstal panda dan NumPy dengan konektor.
```
>>> pip install 'redshift_connector[full]'
```
Untuk informasi lebih lanjut tentang pip, lihat situs [pip](https://pip.pypa.io/en/stable/).
## Menginstal konektor Python dari Conda
Anda dapat menginstal konektor Python dari Anaconda.org.
```
>>>conda install -c conda-forge redshift_connector
```
## Menginstal konektor Python dengan mengkloning repositori dari GitHub AWS
Untuk menginstal konektor Python dari sumber, kloning repositori dari. GitHub AWS Setelah Anda menginstal Python dan virtualenv, atur lingkungan Anda dan instal dependensi yang diperlukan dengan menjalankan perintah berikut.
```
$ git clone https://github.com/aws/amazon-redshift-python-driver.git
$ cd amazon-redshift-python-driver
$ virtualenv venv
$ . venv/bin/activate
$ python -m pip install -r requirements.txt
$ python -m pip install -e .
$ python -m pip install redshift_connector
```
# Opsi konfigurasi untuk konektor Amazon Redshift Python
Berikut ini, Anda dapat menemukan deskripsi untuk opsi yang dapat Anda tentukan untuk konektor Amazon Redshift Python. Opsi di bawah ini berlaku untuk versi konektor terbaru yang tersedia kecuali ditentukan lain.
## access\$1key\$1id
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Kunci akses untuk peran IAM atau pengguna yang dikonfigurasi untuk otentikasi database IAM.
Parameter ini bersifat opsional.
## allow\$1db\$1user\$1override
+ **Nilai default** - Salah
+ **Tipe data** — Boolean
True
Menentukan bahwa konektor menggunakan `DbUser` nilai dari pernyataan Security Assertion Markup Language (SAMP).
False
Menentukan bahwa nilai dalam parameter `DbUser` koneksi digunakan.
Parameter ini bersifat opsional.
## app\$1name
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Nama aplikasi penyedia identitas (IDP) yang digunakan untuk otentikasi.
Parameter ini bersifat opsional.
## application\$1name
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Nama aplikasi klien untuk diteruskan ke Amazon Redshift untuk tujuan audit. [Nama aplikasi yang Anda berikan muncul di kolom 'application\$1name' dari tabel SYS\$1CONNECTION\$1LOG.](https://docs.aws.amazon.com/redshift/latest/dg/SYS_CONNECTION_LOG.html) Ini membantu melacak dan memecahkan masalah sumber koneksi saat men-debug masalah.
Parameter ini bersifat opsional.
## auth\$1profil
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Nama profil otentikasi Amazon Redshift yang memiliki properti koneksi sebagai JSON. Untuk informasi selengkapnya tentang penamaan parameter koneksi, lihat `RedshiftProperty` kelas. `RedshiftProperty`Kelas menyimpan parameter koneksi yang disediakan oleh pengguna akhir dan, jika berlaku, dihasilkan selama proses otentikasi IAM (misalnya, kredensil IAM sementara). Untuk informasi lebih lanjut, lihat [RedshiftProperty kelas](https://github.com/aws/amazon-redshift-python-driver/blob/master/redshift_connector/redshift_property.py#L9).
Parameter ini bersifat opsional.
## auto\$1create
+ **Nilai default** - Salah
+ **Tipe data** — Boolean
Nilai yang menunjukkan apakah akan membuat pengguna jika pengguna tidak ada.
Parameter ini bersifat opsional.
## client\$1id
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
ID klien dari Azure iDP.
Parameter ini bersifat opsional.
## client\$1secret
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Rahasia klien dari Azure iDP.
Parameter ini bersifat opsional.
## cluster\$1identifier
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Pengidentifikasi cluster dari cluster Amazon Redshift.
Parameter ini bersifat opsional.
## credentials\$1provider
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
IDP yang digunakan untuk otentikasi dengan Amazon Redshift. Berikut ini adalah nilai yang valid:
+ `AdfsCredentialsProvider`
+ `AzureCredentialsProvider`
+ `BrowserAzureCredentialsProvider`
+ `BrowserAzureOAuth2CredentialsProvider`
+ `BrowserIdcAuthPlugin`- Plugin otorisasi menggunakan AWS IAM Identity Center.
+ `BrowserSamlCredentialsProvider`
+ `IdpTokenAuthPlugin`- Plugin otorisasi yang menerima token AWS IAM Identity Center atau OpenID Connect (OIDC) JSON berbasis token identitas (JWT) dari penyedia identitas web mana pun yang terhubung ke Pusat Identitas IAM. AWS
+ `PingCredentialsProvider`
+ `OktaCredentialsProvider`
Parameter ini bersifat opsional.
## basis data
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Nama database yang ingin Anda sambungkan.
Parameter ini diperlukan.
## database\$1metadata\$1current\$1db\$1only
+ **Nilai default** - Benar
+ **Tipe data** — Boolean
Nilai yang menunjukkan apakah aplikasi mendukung katalog datashare multidatabase. Nilai default True menunjukkan bahwa aplikasi tidak mendukung katalog datashare multidatabase untuk kompatibilitas mundur.
Parameter ini bersifat opsional.
## db\$1group
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Daftar dipisahkan koma dari nama grup database yang ada yang ditunjukkan oleh pengguna dengan DbUser bergabung untuk sesi saat ini.
Parameter ini bersifat opsional.
## db\$1pengguna
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
ID pengguna untuk digunakan dengan Amazon Redshift.
Parameter ini bersifat opsional.
## endpoint\$1url
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
URL titik akhir Amazon Redshift. Opsi ini hanya untuk penggunaan AWS internal.
Parameter ini bersifat opsional.
## group\$1federasi
+ **Nilai default** - Salah
+ **Tipe data** — Boolean
Opsi ini menentukan apakah akan menggunakan grup IDP Amazon Redshift.
Parameter ini bersifat opsional.
**true**
Gunakan grup Amazon Redshift Identity Provider (IDP).
**false**
Gunakan STS API dan GetClusterCredentials untuk federasi pengguna dan tentukan **db\$1groups untuk koneksi**.
## host
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Nama host dari cluster Amazon Redshift.
Parameter ini bersifat opsional.
## iam
+ **Nilai default** - Salah
+ **Tipe data** — Boolean
Autentikasi IAM diaktifkan.
Parameter ini diperlukan.
## iam\$1disable\$1cache
+ **Nilai default** - Salah
+ **Tipe data** — Boolean
Opsi ini menentukan apakah kredensyal IAM di-cache. Secara default, kredensyal IAM di-cache. Ini meningkatkan kinerja saat permintaan ke gateway API dibatasi.
Parameter ini bersifat opsional.
## idc\$1client\$1display\$1name
+ **Nilai Default** - Konektor Amazon Redshift Python
+ **Tipe Data** - String
Nama tampilan yang akan digunakan untuk klien yang menggunakan BrowserIdcAuthPlugin.
Parameter ini bersifat opsional.
## idc\$1region
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
AWS Wilayah di mana instans AWS IAM Identity Center berada.
Parameter ini diperlukan hanya ketika mengautentikasi menggunakan `BrowserIdcAuthPlugin` dalam opsi konfigurasi credentials\$1provider.
## idp\$1partisi
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Menentukan partisi cloud tempat penyedia identitas Anda (iDP) dikonfigurasi. Ini menentukan titik akhir otentikasi IDP mana yang terhubung ke driver.
Jika parameter ini dibiarkan kosong, driver default ke partisi komersial. Kemungkinan nilainya adalah:
+ `us-gov`: Gunakan nilai ini jika IDP Anda dikonfigurasi di Azure Government. Misalnya, Azure AD Government menggunakan `login.microsoftonline.us` endpoint.
+ `cn`: Gunakan nilai ini jika IDP Anda dikonfigurasi di partisi cloud Tiongkok. Misalnya, Azure AD Tiongkok menggunakan titik akhir. `login.chinacloudapi.cn`
Parameter ini bersifat opsional.
## IDPport
+ **Nilai default** - 7890
+ **Tipe data** - Integer
Port mendengarkan tempat iDP mengirimkan pernyataan SAMP.
Parameter ini diperlukan.
## idp\$1response\$1timeout
+ **Nilai default** - 120
+ **Tipe data** - Integer
Batas waktu untuk mengambil pernyataan SAMP dari iDP.
Parameter ini diperlukan.
## idp\$1penyewa
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Penyewa iDP.
Parameter ini bersifat opsional.
## issuer\$1url
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Menunjuk ke titik akhir instance server AWS IAM Identity Center.
Parameter ini diperlukan hanya ketika mengautentikasi menggunakan `BrowserIdcAuthPlugin` dalam opsi konfigurasi credentials\$1provider.
## listen\$1port
+ **Nilai default** - 7890
+ **Tipe data** - Integer
Port yang digunakan driver untuk menerima respons SAFL dari penyedia identitas atau kode otorisasi saat menggunakan layanan SAFL, Azure AD, atau AWS IAM Identity Center melalui plugin browser.
Parameter ini bersifat opsional.
## login\$1url
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Url masuk tunggal untuk iDP.
Parameter ini bersifat opsional.
## max\$1prepared\$1statement
+ **Nilai default** - 1000
+ **Tipe data** - Integer
Jumlah maksimum pernyataan disiapkan yang akan di-cache per koneksi. Menyetel parameter ini ke 0 menonaktifkan mekanisme caching. Memasukkan angka negatif untuk parameter ini menetapkannya ke nilai default.
Parameter ini bersifat opsional.
## numeric\$1to\$1float
+ **Nilai default** - Salah
+ **Tipe data** — Boolean
Opsi ini menentukan apakah konektor mengkonversi nilai tipe data numerik dari Decimal.Decimal untuk float. Secara default, konektor menerima nilai tipe data numerik sebagai desimal. Desimal dan tidak mengonversinya.
Kami tidak menyarankan mengaktifkan numeric\$1to\$1float untuk kasus penggunaan yang memerlukan presisi, karena hasilnya dapat dibulatkan.
Untuk informasi lebih lanjut tentang desimal. Desimal dan pengorbanan antara itu dan float, lihat desimal [— Titik tetap desimal](https://docs.python.org/3/library/decimal.html) dan aritmatika floating point di situs web Python.
Parameter ini bersifat opsional.
## partner\$1sp\$1id
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
ID SP Mitra yang digunakan untuk otentikasi dengan Ping.
Parameter ini bersifat opsional.
## password
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Kata sandi yang digunakan untuk otentikasi.
Parameter ini bersifat opsional.
## port
+ **Nilai default** - 5439
+ **Tipe data** - Integer
Nomor port cluster Amazon Redshift.
Parameter ini diperlukan.
## preferred\$1role
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Peran IAM lebih disukai untuk koneksi saat ini.
Parameter ini bersifat opsional.
## principal\$1arn
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Nama Sumber Daya Amazon (ARN) dari pengguna atau peran IAM tempat Anda membuat kebijakan. Anda disarankan untuk melampirkan kebijakan ke peran dan kemudian menetapkan peran tersebut ke pengguna Anda, untuk akses.
Parameter ini bersifat opsional.
## profile
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Nama profil dalam file kredensyal yang berisi AWS AWS kredensyal.
Parameter ini bersifat opsional.
## provider\$1name
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Nama Penyedia Otentikasi Asli Redshift.
Parameter ini bersifat opsional.
## region
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Di Wilayah AWS mana cluster berada.
Parameter ini bersifat opsional.
## role\$1arn
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Nama Sumber Daya Amazon (ARN) dari peran yang diasumsikan oleh penelepon. Parameter ini digunakan oleh penyedia yang ditunjukkan oleh`JwtCredentialsProvider`.
Untuk `JwtCredentialsProvider` penyedia, parameter ini wajib. Jika tidak, parameter ini opsional.
## role\$1session\$1name
+ **Nilai default** - jwt\$1redshift\$1session
+ **Tipe data** - String
Sebuah pengenal untuk sesi peran yang diambil. Biasanya, Anda meneruskan nama atau pengenal yang terkait dengan pengguna yang menggunakan aplikasi Anda. Kredensyal keamanan sementara yang digunakan aplikasi Anda terkait dengan pengguna tersebut. Parameter ini digunakan oleh penyedia yang ditunjukkan oleh`JwtCredentialsProvider`.
Parameter ini bersifat opsional.
## cakupan
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Daftar cakupan yang dipisahkan ruang yang dapat disetujui pengguna. Anda menentukan parameter ini sehingga aplikasi Anda bisa mendapatkan persetujuan untuk APIs yang ingin Anda panggil. Anda dapat menentukan parameter ini ketika Anda menentukan BrowserAzure OAuth2 CredentialsProvider untuk opsi credentials\$1provider.
Parameter ini diperlukan untuk BrowserAzure OAuth2 CredentialsProvider plug-in.
## secret\$1access\$1key\$1id
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Kunci akses rahasia untuk peran IAM atau pengguna yang dikonfigurasi untuk otentikasi database IAM.
Parameter ini bersifat opsional.
## session\$1token
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Kunci akses untuk peran IAM atau pengguna yang dikonfigurasi untuk otentikasi database IAM. Parameter ini diperlukan jika AWS kredensyal sementara sedang digunakan.
Parameter ini bersifat opsional.
## serverless\$1acct\$1id
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
ID akun Tanpa Server Amazon Redshift.
Parameter ini bersifat opsional.
## serverless\$1work\$1group
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Nama workgroup Amazon Redshift Tanpa Server.
Parameter ini bersifat opsional.
## ssl
+ **Nilai default** - Benar
+ **Tipe data** — Boolean
Secure Sockets Layer (SSL) diaktifkan.
Parameter ini diperlukan.
## ssl\$1insecure
+ **Nilai default** - Salah
+ **Tipe data** — Boolean
Nilai yang menentukan apakah akan menonaktifkan verifikasi sertifikat SSL server idP host. Menyetel parameter ini ke True akan menonaktifkan verifikasi sertifikat SSL server host iDP. Kami menyarankan Anda menyimpan nilai default False di lingkungan produksi.
Parameter ini bersifat opsional.
## sslmode
+ **Nilai default** - verify-ca
+ **Tipe data** - String
Keamanan koneksi ke Amazon Redshift. Anda dapat menentukan salah satu dari berikut ini:
+ verify-ca
+ verify-full
Parameter ini diperlukan.
## tcp\$1keepalive
+ **Nilai default** - Benar
+ **Tipe data** — Boolean
Apakah akan menggunakan TCP keepalives untuk menjaga koneksi dari waktu habis. Anda dapat menentukan salah satu nilai berikut:
+ Benar: Driver akan menggunakan TCP keepalives untuk menjaga koneksi dari waktu habis.
+ Salah: Driver tidak akan menggunakan TCP keepalives.
Parameter ini bersifat opsional.
## tcp\$1keepalive\$1count
+ **Nilai default** - Tidak ada
+ **Tipe data** - Integer
Jumlah probe yang tidak diakui untuk dikirim sebelum mempertimbangkan koneksi tidak aktif. Misalnya, menetapkan nilai ke 3 berarti bahwa driver akan mengirim 3 paket keepalive yang belum dijawab sebelum menentukan bahwa koneksi tidak lagi aktif.
Jika parameter ini tidak ditentukan, Amazon Redshift menggunakan nilai default sistem.
Parameter ini bersifat opsional.
## tcp\$1keepalive\$1interval
+ **Nilai default** - Tidak ada
+ **Tipe data** - Integer
Interval, dalam hitungan detik, antara probe keepalive berikutnya jika pengemudi tidak menerima pengakuan untuk probe sebelumnya. Jika Anda menentukan parameter ini, itu harus bilangan bulat positif.
Jika parameter ini tidak ditentukan, Amazon Redshift menggunakan nilai default sistem.
Parameter ini bersifat opsional.
## tcp\$1keepalive\$1idle
+ **Nilai default** - Tidak ada
+ **Tipe data** - Integer
Durasi tidak aktif, dalam hitungan detik, setelah itu pengemudi mengirimkan probe keepalive pertama. Misalnya, menetapkan nilai ke 120 berarti bahwa driver akan menunggu selama 2 menit tidak aktif sebelum mengirim paket keepalive pertama. Jika Anda menentukan parameter ini, itu harus bilangan bulat positif.
Jika parameter ini tidak ditentukan, Amazon Redshift menggunakan nilai default sistem.
Parameter ini bersifat opsional.
## batas waktu
+ **Nilai default** - Tidak ada
+ **Tipe data** - Integer
Jumlah detik sebelum koneksi ke server habis.
Parameter ini bersifat opsional.
## token
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Pusat AWS Identitas IAM menyediakan token akses atau OpenID Connect (OIDC) JSON Web Token (JWT) yang disediakan oleh penyedia identitas web yang terhubung dengan IAM Identity Center. AWS Aplikasi Anda harus menghasilkan token ini dengan mengautentikasi pengguna aplikasi Anda dengan AWS IAM Identity Center atau penyedia identitas yang ditautkan dengan AWS IAM Identity Center.
Parameter ini bekerja dengan`IdpTokenAuthPlugin`.
## token\$1type
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Jenis token yang digunakan di`IdpTokenAuthPlugin`.
Anda dapat menentukan salah satu nilai berikut:
**ACCESS\$1TOKEN**
Masukkan ini jika Anda menggunakan token akses yang disediakan Pusat Identitas AWS IAM.
**EXT\$1JWT**
Masukkan ini jika Anda menggunakan OpenID Connect (OIDC) JSON Web Token (JWT) yang disediakan oleh penyedia identitas berbasis web yang terintegrasi dengan IAM Identity Center. AWS
Parameter ini bekerja dengan`IdpTokenAuthPlugin`.
## user
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Nama pengguna yang akan digunakan untuk otentikasi.
Parameter ini bersifat opsional.
## web\$1identity\$1token
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Token akses OAuth 2.0 atau token OpenID Connect ID yang disediakan oleh penyedia identitas. Pastikan aplikasi Anda mendapatkan token ini dengan mengautentikasi pengguna yang menggunakan aplikasi Anda dengan penyedia identitas web. Penyedia yang ditunjukkan dengan `JwtCredentialsProvider` menggunakan parameter ini.
Untuk `JwtCredentialsProvider` penyedia, parameter ini wajib. Jika tidak, parameter ini opsional.
# Mengimpor konektor Python
Untuk mengimpor konektor Python, jalankan perintah berikut.
```
>>> import redshift_connector
```
Untuk menyambung ke klaster Amazon Redshift menggunakan AWS kredensyal, jalankan perintah berikut.
```
conn = redshift_connector.connect(
host='examplecluster.abc123xyz789.us-west-1.redshift.amazonaws.com',
port=5439,
database='dev',
user='awsuser',
password='my_password'
)
```
# Mengintegrasikan konektor Python dengan NumPy
Berikut ini adalah contoh mengintegrasikan konektor Python dengan. NumPy
```
>>> import numpy
#Connect to the cluster
>>> import redshift_connector
>>> conn = redshift_connector.connect(
host='examplecluster.abc123xyz789.us-west-1.redshift.amazonaws.com',
port=5439,
database='dev',
user='awsuser',
password='my_password'
)
# Create a Cursor object
>>> cursor = conn.cursor()
# Query and receive result set
cursor.execute("select * from book")
result: numpy.ndarray = cursor.fetch_numpy_array()
print(result)
```
Berikut ini adalah hasilnya.
```
[['One Hundred Years of Solitude' 'Gabriel García Márquez']
['A Brief History of Time' 'Stephen Hawking']]
```
# Mengintegrasikan konektor Python dengan panda
Berikut ini adalah contoh mengintegrasikan konektor Python dengan panda.
```
>>> import pandas
#Connect to the cluster
>>> import redshift_connector
>>> conn = redshift_connector.connect(
host='examplecluster.abc123xyz789.us-west-1.redshift.amazonaws.com',
port=5439,
database='dev',
user='awsuser',
password='my_password'
)
# Create a Cursor object
>>> cursor = conn.cursor()
# Query and receive result set
cursor.execute("select * from book")
result: pandas.DataFrame = cursor.fetch_dataframe()
print(result)
```
# Menggunakan plugin penyedia identitas
Untuk informasi umum tentang cara menggunakan plugin penyedia identitas, lihat[Opsi untuk memberikan kredensi IAM](options-for-providing-iam-credentials.md). Untuk informasi selengkapnya tentang mengelola identitas IAM, termasuk praktik terbaik untuk peran IAM, lihat. [Manajemen identitas dan akses di Amazon Redshift](redshift-iam-authentication-access-control.md)
## Otentikasi menggunakan plugin penyedia identitas ADFS
Berikut ini adalah contoh penggunaan plugin penyedia identitas Active Directory Federation Service (ADFS) untuk mengautentikasi pengguna yang terhubung ke database Amazon Redshift.
```
>>> con = redshift_connector.connect(
iam=True,
database='dev',
host='my-testing-cluster.abc.us-east-2.redshift.amazonaws.com',
cluster_identifier='my-testing-cluster',
credentials_provider='AdfsCredentialsProvider',
user='brooke@myadfshostname.com',
password='Hunter2',
idp_host='myadfshostname.com'
)
```
## Otentikasi menggunakan plugin penyedia identitas Azure
Berikut ini adalah contoh otentikasi menggunakan plugin penyedia identitas Azure. Anda dapat membuat nilai untuk `client_id` dan `client_secret` untuk aplikasi Azure Enterprise seperti yang ditunjukkan berikut.
```
>>> con = redshift_connector.connect(
iam=True,
database='dev',
host='my-testing-cluster.abc.us-east-2.redshift.amazonaws.com',
cluster_identifier='my-testing-cluster',
credentials_provider='AzureCredentialsProvider',
user='brooke@myazure.org',
password='Hunter2',
idp_tenant='my_idp_tenant',
client_id='my_client_id',
client_secret='my_client_secret',
preferred_role='arn:aws:iam:123:role/DataScientist'
)
```
## Otentikasi menggunakan plugin penyedia identitas Pusat AWS Identitas IAM
Berikut ini adalah contoh otentikasi menggunakan plugin penyedia identitas AWS IAM Identity Center.
```
with redshift_connector.connect(
credentials_provider='BrowserIdcAuthPlugin',
host='my-testing-cluster.abc.us-east-2.redshift.amazonaws.com',
database='dev',
idc_region='us-east-1',
issuer_url='https://identitycenter.amazonaws.com/ssoins-790723ebe09c86f9',
idp_response_timeout=60,
listen_port=8100,
idc_client_display_name='Test Display Name',
# port value of 5439 is specified by default
)
```
## Otentikasi menggunakan plugin penyedia identitas Azure Browser
Berikut ini adalah contoh penggunaan plugin penyedia identitas Azure Browser untuk mengautentikasi pengguna yang terhubung ke database Amazon Redshift.
Otentikasi multi-faktor terjadi di browser, di mana kredensi masuk disediakan oleh pengguna.
```
>>>con = redshift_connector.connect(
iam=True,
database='dev',
host='my-testing-cluster.abc.us-east-2.redshift.amazonaws.com',
cluster_identifier='my-testing-cluster',
credentials_provider='BrowserAzureCredentialsProvider',
idp_tenant='my_idp_tenant',
client_id='my_client_id',
)
```
## Otentikasi menggunakan plugin penyedia identitas Okta
Berikut ini adalah contoh otentikasi menggunakan plugin penyedia identitas Okta. Anda dapat memperoleh nilai untuk`idp_host`, `app_id` dan `app_name` melalui aplikasi Okta.
```
>>> con = redshift_connector.connect(
iam=True,
database='dev',
host='my-testing-cluster.abc.us-east-2.redshift.amazonaws.com',
cluster_identifier='my-testing-cluster',
credentials_provider='OktaCredentialsProvider',
user='brooke@myazure.org',
password='hunter2',
idp_host='my_idp_host',
app_id='my_first_appetizer',
app_name='dinner_party'
)
```
## Otentikasi menggunakan JumpCloud dengan plugin penyedia identitas browser SAMP generik
Berikut ini adalah contoh penggunaan JumpCloud dengan plugin penyedia identitas browser SAMP generik untuk otentikasi.
Parameter kata sandi diperlukan. Namun, Anda tidak perlu memasukkan parameter ini karena otentikasi multi-faktor terjadi di browser.
```
>>> con = redshift_connector.connect(
iam=True,
database='dev',
host='my-testing-cluster.abc.us-east-2.redshift.amazonaws.com',
cluster_identifier='my-testing-cluster',
credentials_provider='BrowserSamlCredentialsProvider',
user='brooke@myjumpcloud.org',
password='',
login_url='https://sso.jumpcloud.com/saml2/plustwo_melody'
)
```
# Contoh penggunaan konektor Amazon Redshift Python
Berikut ini adalah contoh cara menggunakan konektor Amazon Redshift Python. Untuk menjalankannya, Anda harus menginstal konektor Python terlebih dahulu. Untuk informasi selengkapnya tentang menginstal konektor Amazon Redshift Python, lihat. [Memasang konektor Amazon Redshift Python](python-driver-install.md) Untuk informasi lebih lanjut tentang opsi konfigurasi yang dapat Anda gunakan dengan konektor Python, lihat. [Opsi konfigurasi untuk konektor Amazon Redshift Python](python-configuration-options.md)
**Topics**
+ [Menyambung ke dan menanyakan klaster Amazon Redshift menggunakan kredensyal AWS](#python-connect-cluster)
+ [Mengaktifkan komit otomatis](#python-connect-enable-autocommit)
+ [Mengkonfigurasi paramstyle kursor](#python-connect-config-paramstyle)
+ [Menggunakan COPY untuk menyalin data dari bucket Amazon S3 dan UNLOAD untuk menulis data ke dalamnya](#python-connect-copy-unload-s3)
## Menyambung ke dan menanyakan klaster Amazon Redshift menggunakan kredensyal AWS
Contoh berikut memandu Anda untuk menghubungkan ke klaster Amazon Redshift menggunakan AWS kredensil Anda, lalu menanyakan tabel dan mengambil hasil kueri.
```
#Connect to the cluster
>>> import redshift_connector
>>> conn = redshift_connector.connect(
host='examplecluster.abc123xyz789.us-west-1.redshift.amazonaws.com',
database='dev',
port=5439,
user='awsuser',
password='my_password'
)
# Create a Cursor object
>>> cursor = conn.cursor()
# Query a table using the Cursor
>>> cursor.execute("select * from book")
#Retrieve the query result set
>>> result: tuple = cursor.fetchall()
>>> print(result)
>> (['One Hundred Years of Solitude', 'Gabriel García Márquez'], ['A Brief History of Time', 'Stephen Hawking'])
```
## Mengaktifkan komit otomatis
Properti autocommit dinonaktifkan secara default, mengikuti Spesifikasi API Database Python. Anda dapat menggunakan perintah berikut untuk mengaktifkan properti autocommit koneksi setelah melakukan perintah rollback untuk memastikan bahwa transaksi tidak sedang berlangsung.
```
#Connect to the cluster
>>> import redshift_connector
>>> conn = redshift_connector.connect(...)
# Run a rollback command
>>> conn.rollback()
# Turn on autocommit
>>> conn.autocommit = True
>>> conn.run("VACUUM")
# Turn off autocommit
>>> conn.autocommit = False
```
## Mengkonfigurasi paramstyle kursor
Paramstyle untuk kursor dapat dimodifikasi melalui cursor.paramstyle. Paramstyle default yang digunakan adalah`format`. Nilai yang valid untuk paramstyle adalah`qmark`,`numeric`,, `named``format`, dan`pyformat`.
Berikut ini adalah contoh menggunakan berbagai paramstyles untuk meneruskan parameter ke pernyataan SQL sampel.
```
# qmark
redshift_connector.paramstyle = 'qmark'
sql = 'insert into foo(bar, jar) VALUES(?, ?)'
cursor.execute(sql, (1, "hello world"))
# numeric
redshift_connector.paramstyle = 'numeric'
sql = 'insert into foo(bar, jar) VALUES(:1, :2)'
cursor.execute(sql, (1, "hello world"))
# named
redshift_connector.paramstyle = 'named'
sql = 'insert into foo(bar, jar) VALUES(:p1, :p2)'
cursor.execute(sql, {"p1":1, "p2":"hello world"})
# format
redshift_connector.paramstyle = 'format'
sql = 'insert into foo(bar, jar) VALUES(%s, %s)'
cursor.execute(sql, (1, "hello world"))
# pyformat
redshift_connector.paramstyle = 'pyformat'
sql = 'insert into foo(bar, jar) VALUES(%(bar)s, %(jar)s)'
cursor.execute(sql, {"bar": 1, "jar": "hello world"})
```
## Menggunakan COPY untuk menyalin data dari bucket Amazon S3 dan UNLOAD untuk menulis data ke dalamnya
Contoh berikut menunjukkan cara menyalin data dari bucket Amazon S3 ke dalam tabel dan kemudian membongkar dari tabel itu kembali ke bucket.
File teks bernama `category_csv.txt` berisi data berikut diunggah ke bucket Amazon S3:.
```
12,Shows,Musicals,Musical theatre
13,Shows,Plays,"All ""non-musical"" theatre"
14,Shows,Opera,"All opera, light, and ""rock"" opera"
15,Concerts,Classical,"All symphony, concerto, and choir concerts"
```
Berikut ini adalah contoh kode Python, yang pertama kali terhubung ke database Amazon Redshift. Kemudian membuat tabel yang disebut `category` dan menyalin data CSV dari bucket S3 ke dalam tabel.
```
#Connect to the cluster and create a Cursor
>>> import redshift_connector
>>> with redshift_connector.connect(...) as conn:
>>> with conn.cursor() as cursor:
#Create an empty table
>>> cursor.execute("create table category (catid int, cargroup varchar, catname varchar, catdesc varchar)")
#Use COPY to copy the contents of the S3 bucket into the empty table
>>> cursor.execute("copy category from 's3://testing/category_csv.txt' iam_role 'arn:aws:iam::123:role/RedshiftCopyUnload' csv;")
#Retrieve the contents of the table
>>> cursor.execute("select * from category")
>>> print(cursor.fetchall())
#Use UNLOAD to copy the contents of the table into the S3 bucket
>>> cursor.execute("unload ('select * from category') to 's3://testing/unloaded_category_csv.txt' iam_role 'arn:aws:iam::123:role/RedshiftCopyUnload' csv;")
#Retrieve the contents of the bucket
>>> print(cursor.fetchall())
>> ([12, 'Shows', 'Musicals', 'Musical theatre'], [13, 'Shows', 'Plays', 'All "non-musical" theatre'], [14, 'Shows', 'Opera', 'All opera, light, and "rock" opera'], [15, 'Concerts', 'Classical', 'All symphony, concerto, and choir concerts'])
```
Jika Anda belum `autocommit` menyetel ke true, komit dengan `conn.commit()` setelah menjalankan `execute()` pernyataan.
Data diturunkan ke file `unloaded_category_csv.text0000_part00` di bucket S3, dengan konten berikut:
```
12,Shows,Musicals,Musical theatre
13,Shows,Plays,"All ""non-musical"" theatre"
14,Shows,Opera,"All opera, light, and ""rock"" opera"
15,Concerts,Classical,"All symphony, concerto, and choir concerts"
```
# Referensi API untuk konektor Amazon Redshift Python
Berikut ini, Anda dapat menemukan deskripsi operasi API konektor Amazon Redshift Python.
## redshift\$1connector
Berikut ini, Anda dapat menemukan deskripsi operasi `redshift_connector` API.
`connect(user, database, password[, port, …])`
Membuat koneksi ke cluster Amazon Redshift. Fungsi ini memvalidasi input pengguna, secara opsional mengautentikasi menggunakan plugin penyedia identitas, dan kemudian membangun objek koneksi.
`apilevel`
Level DBAPI didukung, saat ini “2.0".
`paramstyle``str(object=’’) -> str str(bytes_or_buffer[, encoding[, errors]]) -> str`
Gaya parameter API database untuk digunakan secara global.
## Koneksi
Berikut ini, Anda dapat menemukan deskripsi operasi API koneksi untuk konektor Amazon Redshift Python.
`__init__(user, password, database[, host, …])`
Menginisialisasi objek koneksi mentah.
`cursor`
Membuat objek kursor terikat pada koneksi ini.
`commit`
Melakukan transaksi database saat ini.
`rollback`
Menggulung kembali transaksi database saat ini.
`close`
Menutup koneksi database.
`execute(cursor, operation, vals)`
Menjalankan perintah SQL yang ditentukan. Anda dapat memberikan parameter sebagai urutan atau sebagai pemetaan, tergantung pada nilai. `redshift_connector.paramstyle`
`run(sql[, stream])`
Menjalankan perintah SQL yang ditentukan. Secara opsional, Anda dapat menyediakan aliran untuk digunakan dengan perintah COPY.
`xid(format_id, global_transaction_id, …)`
Buat ID transaksi. Hanya `global_transaction_id` parameter yang digunakan di postgres. format\$1id dan branch\$1qualifier tidak digunakan di postgres. `global_transaction_id`Dapat berupa pengidentifikasi string apa pun yang didukung oleh postgres yang mengembalikan tuple (`format_id`,,`global_transaction_id`). `branch_qualifier`
`tpc_begin(xid)`
Memulai transaksi TPC dengan ID transaksi `xid` yang terdiri dari ID format, ID transaksi global, dan kualifikasi cabang.
`tpc_prepare`
Melakukan fase pertama transaksi yang dimulai dengan.tpc\$1begin.
`tpc_commit([xid])`
Ketika dipanggil tanpa argumen, .tpc\$1commit melakukan transaksi TPC yang sebelumnya disiapkan dengan.tpc\$1prepare ().
`tpc_rollback([xid])`
Ketika dipanggil tanpa argumen, .tpc\$1rollback mengembalikan transaksi TPC.
`tpc_recover`
Mengembalikan daftar transaksi tertunda yang IDs cocok untuk digunakan dengan.tpc\$1commit (xid) atau.tpc\$1rollback (xid).
## Kursor
Berikut ini, Anda dapat menemukan deskripsi operasi API kursor.
`__init__(connection[, paramstyle])`
Menginisialisasi objek kursor mentah.
`insert_data_bulk(filename, table_name, parameter_indices, column_names, delimiter, batch_size)`
Menjalankan pernyataan INSERT massal.
`execute(operation[, args, stream, …])`
Menjalankan operasi database.
`executemany(operation, param_sets)`
Mempersiapkan operasi database, dan kemudian menjalankannya untuk semua urutan parameter atau pemetaan yang disediakan.
`fetchone`
Mengambil baris berikutnya dari hasil query set.
`fetchmany([num])`
Mengambil set baris berikutnya dari hasil query.
`fetchall`
Mengambil semua baris yang tersisa dari hasil query.
`close`
Tutup kursor sekarang.
`__iter__`
Sebuah objek kursor dapat diiterasi untuk mengambil baris dari query.
`fetch_dataframe([num])`
Mengembalikan kerangka data dari hasil query terakhir.
`write_dataframe(df, table)`
Menulis kerangka data struktur yang sama ke dalam database Amazon Redshift.
`fetch_numpy_array([num])`
Mengembalikan NumPy array hasil query terakhir.
`get_catalogs`
Amazon Redshift tidak mendukung beberapa katalog dari satu koneksi. Amazon Redshift hanya mengembalikan katalog saat ini.
`get_tables([catalog, schema_pattern, …])`
Mengembalikan tabel publik unik yang ditentukan pengguna dalam sistem.
`get_columns([catalog, schema_pattern, …])`
Mengembalikan daftar semua kolom dalam tabel tertentu dalam database Amazon Redshift.
## AdfsCredentialsProvider plugin
Berikut ini adalah sintaks untuk operasi API AdfsCredentialsProvider plugin untuk konektor Amazon Redshift Python.
```
redshift_connector.plugin.AdfsCredentialsProvider()
```
## AzureCredentialsProvider plugin
Berikut ini adalah sintaks untuk operasi API AzureCredentialsProvider plugin untuk konektor Amazon Redshift Python.
```
redshift_connector.plugin.AzureCredentialsProvider()
```
## BrowserAzureCredentialsProvider plugin
Berikut ini adalah sintaks untuk operasi API BrowserAzureCredentialsProvider plugin untuk konektor Amazon Redshift Python.
```
redshift_connector.plugin.BrowserAzureCredentialsProvider()
```
## BrowserSamlCredentialsProvider plugin
Berikut ini adalah sintaks untuk operasi API BrowserSamlCredentialsProvider plugin untuk konektor Amazon Redshift Python.
```
redshift_connector.plugin.BrowserSamlCredentialsProvider()
```
## OktaCredentialsProvider plugin
Berikut ini adalah sintaks untuk operasi API OktaCredentialsProvider plugin untuk konektor Amazon Redshift Python.
```
redshift_connector.plugin.OktaCredentialsProvider()
```
## PingCredentialsProvider plugin
Berikut ini adalah sintaks untuk operasi API PingCredentialsProvider plugin untuk konektor Amazon Redshift Python.
```
redshift_connector.plugin.PingCredentialsProvider()
```
## SamlCredentialsProvider plugin
Berikut ini adalah sintaks untuk operasi API SamlCredentialsProvider plugin untuk konektor Amazon Redshift Python.
```
redshift_connector.plugin.SamlCredentialsProvider()
```
# Integrasi Amazon Redshift untuk Apache Spark
[Apache Spark](https://aws.amazon.com/emr/features/spark/) adalah kerangka pemrosesan terdistribusi dan model pemrograman yang membantu Anda melakukan pembelajaran mesin, pemrosesan aliran, atau analisis grafik. Mirip dengan Apache Hadoop, Spark merupakan sistem pemrosesan terdistribusi sumber terbuka, yang biasa digunakan untuk beban kerja big data. Spark memiliki mesin eksekusi grafik asiklik terarah (DAG) yang dioptimalkan dan secara aktif menyimpan data dalam memori. Ini dapat meningkatkan kinerja, terutama untuk algoritma tertentu dan kueri interaktif.
Integrasi ini memberi Anda konektor Spark yang dapat Anda gunakan untuk membangun aplikasi Apache Spark yang membaca dan menulis ke data di Amazon Redshift dan Amazon Redshift Serverless. Aplikasi ini tidak berkompromi pada kinerja aplikasi atau konsistensi transaksional data. Integrasi ini secara otomatis disertakan dalam [Amazon EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/) dan [AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/), sehingga Anda dapat segera menjalankan pekerjaan Apache Spark yang mengakses dan memuat data ke Amazon Redshift sebagai bagian dari pipa penyerapan dan transformasi data Anda.
Saat ini, Anda dapat menggunakan versi 3.3.x, 3.4.x, 3.5.x, dan 4.0.0 dari Spark dengan integrasi ini.
Integrasi ini menyediakan yang berikut:
+ AWS Identity and Access Management (IAM) otentikasi. Untuk informasi selengkapnya, lihat [Manajemen identitas dan akses di Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-authentication-access-control.html).
+ Predikat dan kueri pushdown untuk meningkatkan kinerja.
+ Jenis data Amazon Redshift.
+ Konektivitas ke Amazon Redshift dan Amazon Redshift Tanpa Server.
## Pertimbangan dan batasan saat menggunakan konektor Spark
+ URI tempdir menunjuk ke lokasi Amazon S3. Direktori temp ini tidak dibersihkan secara otomatis dan dapat menambah biaya tambahan. Sebaiknya gunakan [kebijakan siklus hidup Amazon S3 di](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) *Panduan Pengguna Layanan Penyimpanan Sederhana Amazon* untuk menentukan aturan penyimpanan bucket Amazon S3.
+ Secara default, salinan antara Amazon S3 dan Redshift tidak berfungsi jika bucket S3 dan cluster Redshift berada di Wilayah yang berbeda. AWS Untuk menggunakan AWS Regions terpisah, atur `tempdir_region` parameter ke Region bucket S3 yang digunakan untuk. `tempdir`
+ Cross-Region menulis antara S3 dan Redshift jika menulis data Parket menggunakan parameter. `tempformat`
+ Sebaiknya gunakan [enkripsi sisi server Amazon S3 untuk mengenkripsi bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html) Amazon S3 yang digunakan.
+ Kami merekomendasikan untuk [memblokir akses publik ke bucket Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html).
+ Kami menyarankan agar cluster Amazon Redshift tidak dapat diakses publik.
+ Sebaiknya aktifkan pencatatan [audit Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/db-auditing.html).
+ Sebaiknya aktifkan enkripsi saat [istirahat Amazon Redshift.](https://docs.aws.amazon.com/redshift/latest/mgmt/security-server-side-encryption.html)
+ Sebaiknya aktifkan SSL untuk koneksi JDBC dari Spark di Amazon EMR ke Amazon Redshift.
+ Kami merekomendasikan untuk meneruskan peran IAM menggunakan parameter `aws_iam_role` untuk parameter autentikasi Amazon Redshift.
# Otentikasi dengan konektor Spark
Diagram berikut menjelaskan otentikasi antara Amazon S3, Amazon Redshift, driver Spark, dan pelaksana Spark.
![\[Ini adalah diagram otentikasi konektor percikan.\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/images/spark-connector-authentication.png)
## Otentikasi antara Redshift dan Spark
Anda dapat menggunakan driver versi 2.x driver JDBC yang disediakan Amazon Redshift untuk terhubung ke Amazon Redshift dengan konektor Spark dengan menentukan kredenal masuk. Untuk menggunakan IAM, [konfigurasikan url JDBC Anda untuk menggunakan](https://docs.aws.amazon.com/redshift/latest/mgmt/generating-iam-credentials-configure-jdbc-odbc.html) otentikasi IAM. Untuk menyambung ke kluster Redshift dari Amazon EMR atau AWS Glue, pastikan bahwa peran IAM Anda memiliki izin yang diperlukan untuk mengambil kredenal IAM sementara. Daftar berikut menjelaskan semua izin yang diperlukan peran IAM Anda untuk mengambil kredensil dan menjalankan operasi Amazon S3.
+ [Redshift: GetClusterCredentials](https://docs.aws.amazon.com/redshift/latest/APIReference/API_GetClusterCredentials.html) (untuk cluster Redshift yang disediakan)
+ [Redshift: DescribeClusters](https://docs.aws.amazon.com/redshift/latest/APIReference/API_DescribeClusters.html) (untuk cluster Redshift yang disediakan)
+ [Redshift: GetWorkgroup](https://docs.aws.amazon.com/redshift-serverless/latest/APIReference/API_GetWorkgroup.html) (untuk grup kerja Amazon Redshift Tanpa Server)
+ [Redshift: GetCredentials](https://docs.aws.amazon.com/redshift-serverless/latest/APIReference/API_GetCredentials.html) (untuk grup kerja Amazon Redshift Tanpa Server)
+ [s3: ListBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html)
+ [s3: GetBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetBucket.html)
+ [s3: GetObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
+ [s3: PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)
+ [s3: GetBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html)
Untuk informasi selengkapnya GetClusterCredentials, lihat [kebijakan IAM untuk GetClusterCredentials](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-access-control-identity-based.html#redshift-policy-resources.getclustercredentials-resources).
Anda juga harus memastikan bahwa Amazon Redshift dapat mengambil peran IAM selama `COPY` dan operasi. `UNLOAD`
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "redshift.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
Jika Anda menggunakan driver JDBC terbaru, driver akan secara otomatis mengelola transisi dari sertifikat yang ditandatangani sendiri Amazon Redshift ke sertifikat ACM. Namun, Anda harus [menentukan opsi SSL ke url JDBC](https://docs.aws.amazon.com/redshift/latest/mgmt/jdbc20-configuration-options.html#jdbc20-ssl-option).
Berikut ini adalah contoh cara menentukan URL driver JDBC dan terhubung `aws_iam_role` ke Amazon Redshift.
```
df.write \
.format("io.github.spark_redshift_community.spark.redshift ") \
.option("url", "jdbc:redshift:iam://") \
.option("dbtable", "") \
.option("tempdir", "s3a:///") \
.option("aws_iam_role", "") \
.mode("error") \
.save()
```
## Otentikasi antara Amazon S3 dan Spark
Jika Anda menggunakan peran IAM untuk mengautentikasi antara Spark dan Amazon S3, gunakan salah satu metode berikut:
+ AWS SDK for Java akan secara otomatis mencoba AWS menemukan kredensil dengan menggunakan rantai penyedia kredensi default yang diimplementasikan oleh kelas Default. AWSCredentials ProviderChain Untuk informasi selengkapnya, lihat [Menggunakan Rantai Penyedia Kredenal Default](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html#credentials-default).
+ Anda dapat menentukan AWS kunci melalui properti [konfigurasi Hadoop](https://github.com/apache/hadoop/blob/trunk/hadoop-tools/hadoop-aws/src/site/markdown/tools/hadoop-aws/index.md). Misalnya, jika `tempdir` konfigurasi Anda menunjuk ke `s3n://` sistem file, setel `fs.s3n.awsAccessKeyId` dan `fs.s3n.awsSecretAccessKey` properti dalam file konfigurasi XMLHadoop atau panggil `sc.hadoopConfiguration.set()` untuk mengubah konfigurasi Hadoop global Spark.
Misalnya, jika Anda menggunakan sistem file s3n, tambahkan:
```
sc.hadoopConfiguration.set("fs.s3n.awsAccessKeyId", "YOUR_KEY_ID")
sc.hadoopConfiguration.set("fs.s3n.awsSecretAccessKey", "YOUR_SECRET_ACCESS_KEY")
```
Untuk sistem file s3a, tambahkan:
```
sc.hadoopConfiguration.set("fs.s3a.access.key", "YOUR_KEY_ID")
sc.hadoopConfiguration.set("fs.s3a.secret.key", "YOUR_SECRET_ACCESS_KEY")
```
Jika Anda menggunakan Python, gunakan operasi berikut:
```
sc._jsc.hadoopConfiguration().set("fs.s3n.awsAccessKeyId", "YOUR_KEY_ID")
sc._jsc.hadoopConfiguration().set("fs.s3n.awsSecretAccessKey", "YOUR_SECRET_ACCESS_KEY")
```
+ Encode kunci otentikasi di URL. `tempdir` Misalnya, URI `s3n://ACCESSKEY:SECRETKEY@bucket/path/to/temp/dir` mengkodekan key pair (`ACCESSKEY`,`SECRETKEY`).
## Otentikasi antara Redshift dan Amazon S3
Jika Anda menggunakan perintah COPY dan UNLOAD dalam kueri, Anda juga harus memberikan Amazon S3 akses ke Amazon Redshift untuk menjalankan kueri atas nama Anda. Untuk melakukannya, pertama-tama [otorisasi Amazon Redshift untuk mengakses layanan AWS lain](https://docs.aws.amazon.com/redshift/latest/mgmt/authorizing-redshift-service.html), lalu otorisasi operasi [COPY dan UNLOAD](https://docs.aws.amazon.com/redshift/latest/mgmt/copy-unload-iam-role.html) menggunakan peran IAM.
Sebagai praktik terbaik, kami menyarankan untuk melampirkan kebijakan izin ke peran IAM dan kemudian menetapkannya ke pengguna dan grup sesuai kebutuhan. Untuk informasi selengkapnya, lihat [Manajemen identitas dan akses di Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-authentication-access-control.html).
## Integrasi dengan AWS Secrets Manager
Anda dapat mengambil nama pengguna Redshift dan kredenal kata sandi Anda dari rahasia yang disimpan di. AWS Secrets Manager Untuk secara otomatis menyediakan kredenal Redshift, gunakan parameter. `secret.id` Untuk informasi selengkapnya tentang cara membuat rahasia kredensil Redshift, lihat [Membuat](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html) rahasia database. AWS Secrets Manager
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/redshift-spark-connector-authentication.html)
**catatan**
Pengakuan: Dokumentasi ini berisi kode contoh dan bahasa yang dikembangkan oleh [Apache Software Foundation](http://www.apache.org/) yang dilisensikan di bawah lisensi [Apache](https://www.apache.org/licenses/LICENSE-2.0) 2.0.
# Peningkatan kinerja dengan pushdown
Konektor Spark secara otomatis menerapkan predikat dan pushdown kueri untuk mengoptimalkan kinerja. Dukungan ini berarti bahwa jika Anda menggunakan fungsi yang didukung dalam kueri Anda, konektor Spark akan mengubah fungsi menjadi kueri SQL dan menjalankan kueri di Amazon Redshift. Optimalisasi ini menghasilkan lebih sedikit data yang diambil, sehingga Apache Spark dapat memproses lebih sedikit data dan memiliki kinerja yang lebih baik. Secara default, pushdown diaktifkan secara otomatis. Untuk menonaktifkannya, atur `autopushdown` ke false.
```
import sqlContext.implicits._val
sample= sqlContext.read
.format("io.github.spark_redshift_community.spark.redshift")
.option("url",jdbcURL )
.option("tempdir", tempS3Dir)
.option("dbtable", "event")
.option("autopushdown", "false")
.load()
```
Fungsi-fungsi berikut didukung dengan pushdown. Jika Anda menggunakan fungsi yang tidak ada dalam daftar ini, konektor Spark akan menjalankan fungsi di Spark alih-alih Amazon Redshift, menghasilkan kinerja yang tidak dioptimalkan. Untuk daftar lengkap fungsi di Spark, lihat [Fungsi bawaan](https://spark.apache.org/docs/latest/api/sql/index.html).
+ Fungsi agregasi
+ rata-rata
+ count
+ max
+ min
+ sum
+ stddev\$1samp
+ stddev\$1pop
+ var\$1samp
+ var\$1pop
+ Operator Boolean
+ in
+ isnull
+ isnotnull
+ mengandung
+ berakhir dengan
+ mulaidengan
+ Operator logis
+ and
+ atau
+ tidak (atau\$1)
+ Fungsi matematika
+ \$1
+ -
+ \$1
+ /
+ - (unary)
+ perut
+ acos
+ asin
+ atan
+ ceil
+ cos
+ exp
+ lantai
+ terbesar
+ paling sedikit
+ log10
+ pi
+ pow
+ bulat
+ dosa
+ sqrt
+ tan
+ Fungsi lain-lain
+ melemparkan
+ coalesce
+ desimal
+ jika
+ in
+ Operator relasional
+ \$1=
+ =
+ >
+ >=
+ <
+ <=
+ Fungsi string
+ ascii
+ lpad
+ rpad
+ menerjemahkan
+ atas
+ menurunkan
+ length
+ memangkas
+ ltrim
+ rtrim
+ suka
+ substring
+ concat
+ Fungsi waktu dan tanggal
+ add\$1months
+ date
+ date\$1add
+ date\$1sub
+ date\$1trunc
+ timestamp
+ batang
+ Operasi matematika
+ CheckOverflow
+ PromotePrecision
+ Operasi relasional
+ Alias (misalnya, AS)
+ CaseWhen
+ Berbeda
+ InSet
+ Bergabung dan bergabung silang
+ Batas
+ Serikat pekerja, serikat semua
+ ScalarSubquery
+ Sortir (naik dan turun)
+ UnscaledValue
# Opsi konfigurasi lainnya
Di halaman ini, Anda dapat menemukan deskripsi untuk opsi yang dapat Anda tentukan untuk konektor Amazon Redshift Spark.
## Ukuran maksimum kolom string
Redshift membuat kolom string sebagai kolom teks saat membuat tabel, yang disimpan sebagai VARCHAR (256). Jika Anda menginginkan kolom yang mendukung ukuran yang lebih besar, Anda dapat menggunakan maxlength untuk menentukan panjang maksimum kolom string. Berikut ini adalah contoh cara menentukan`maxlength`.
```
columnLengthMap.foreach { case (colName, length) =>
val metadata = new MetadataBuilder().putLong("maxlength", length).build()
df = df.withColumn(colName, df(colName).as(colName, metadata))
}
```
## Jenis kolom
Untuk mengatur jenis kolom, gunakan `redshift_type` bidang.
```
columnTypeMap.foreach { case (colName, colType) =>
val metadata = new MetadataBuilder().putString("redshift_type", colType).build()
df = df.withColumn(colName, df(colName).as(colName, metadata))
}
```
## Pengkodean kompresi pada kolom
Untuk menggunakan pengkodean kompresi tertentu pada kolom, gunakan bidang pengkodean. Untuk daftar lengkap penyandian kompresi dukungan, lihat Pengkodean [kompresi](https://docs.aws.amazon.com/redshift/latest/dg/c_Compression_encodings.html).
## Deskripsi untuk kolom
Untuk mengatur deskripsi, gunakan `description` bidang.
## Otentikasi antara Redshift dan Amazon S3
Secara default, hasilnya diturunkan ke Amazon S3 dalam format parket. Untuk membongkar hasilnya sebagai file teks yang dibatasi pipa, tentukan opsi berikut.
```
.option("unload_s3_format", "TEXT")
```
## Pernyataan pushdown
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/spark-redshift-connector-other-config.html)
## Parameter konektor
Peta parameter atau `OPTIONS` di Spark SQL mendukung pengaturan berikut.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/spark-redshift-connector-other-config.html)
**catatan**
Pengakuan: Dokumentasi ini berisi kode contoh dan bahasa yang dikembangkan oleh [Apache Software Foundation](http://www.apache.org/) yang dilisensikan di bawah lisensi [Apache](https://www.apache.org/licenses/LICENSE-2.0) 2.0.
# Jenis data yang didukung
Tipe data berikut di Amazon Redshift didukung dengan konektor Spark. Untuk daftar lengkap tipe data yang didukung di Amazon Redshift, lihat Jenis [data](https://docs.aws.amazon.com//redshift/latest/dg/c_Supported_data_types.html). Jika tipe data tidak ada dalam tabel di bawah ini, itu tidak didukung di konektor Spark.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/spark-redshift-connector-data-types.html)
## Tipe data yang kompleks
Anda dapat menggunakan konektor percikan untuk membaca dan menulis tipe data kompleks Spark seperti`ArrayType`,`MapType`, dan `StructType` ke dan dari kolom tipe data Redshift SUPER. Jika Anda memberikan skema selama operasi baca, data di kolom akan dikonversi ke tipe kompleks yang sesuai di Spark, termasuk semua jenis bersarang. Selain itu, jika `autopushdown` diaktifkan, proyeksi atribut bersarang, nilai peta, dan indeks array didorong ke Redshift sehingga seluruh struktur data bersarang tidak perlu lagi dibongkar saat mengakses hanya sebagian data.
Saat Anda menulis DataFrames dari konektor, kolom jenis apa pun `MapType` (menggunakan`StringType`),`StructType`, atau `ArrayType` ditulis ke kolom tipe data Redshift SUPER. Saat menulis struktur data bersarang ini, `tempformat` parameter harus bertipe`CSV`,`CSV GZIP`, atau`PARQUET`. Menggunakan `AVRO` akan menyebabkan pengecualian. Menulis struktur `MapType` data yang memiliki tipe kunci selain juga `StringType` akan menyebabkan pengecualian.
### StructType
Contoh berikut menunjukkan cara membuat tabel dengan tipe data SUPER yang berisi struct
```
create table contains_super (a super);
```
Anda kemudian dapat menggunakan konektor untuk menanyakan `StringType` bidang `hello` dari kolom SUPER `a` dalam tabel menggunakan skema seperti pada contoh berikut.
```
import org.apache.spark.sql.types._
val sc = // existing SparkContext
val sqlContext = new SQLContext(sc)
val schema = StructType(StructField("a", StructType(StructField("hello", StringType) ::Nil)) :: Nil)
val helloDF = sqlContext.read
.format("io.github.spark_redshift_community.spark.redshift")
.option("url", jdbcURL )
.option("tempdir", tempS3Dir)
.option("dbtable", "contains_super")
.schema(schema)
.load().selectExpr("a.hello")
```
Contoh berikut menunjukkan bagaimana menulis struct ke kolom. `a`
```
import org.apache.spark.sql.types._
import org.apache.spark.sql._
val sc = // existing SparkContext
val sqlContext = new SQLContext(sc)
val schema = StructType(StructField("a", StructType(StructField("hello", StringType) ::Nil)) :: Nil)
val data = sc.parallelize(Seq(Row(Row("world"))))
val mydf = sqlContext.createDataFrame(data, schema)
mydf.write.format("io.github.spark_redshift_community.spark.redshift").
option("url", jdbcUrl).
option("dbtable", tableName).
option("tempdir", tempS3Dir).
option("tempformat", "CSV").
mode(SaveMode.Append).save
```
### MapType
Jika Anda lebih suka menggunakan a `MapType` untuk mewakili data Anda, maka Anda dapat menggunakan struktur `MapType` data dalam skema Anda dan mengambil nilai yang sesuai dengan kunci di peta. Perhatikan bahwa semua kunci dalam struktur `MapType` data Anda harus bertipe String, dan semua nilai harus dari jenis yang sama, seperti int.
Contoh berikut menunjukkan bagaimana untuk mendapatkan nilai kunci `hello` di kolom`a`.
```
import org.apache.spark.sql.types._
val sc = // existing SparkContext
val sqlContext = new SQLContext(sc)
val schema = StructType(StructField("a", MapType(StringType, IntegerType))::Nil)
val helloDF = sqlContext.read
.format("io.github.spark_redshift_community.spark.redshift")
.option("url", jdbcURL )
.option("tempdir", tempS3Dir)
.option("dbtable", "contains_super")
.schema(schema)
.load().selectExpr("a['hello']")
```
### ArrayType
Jika kolom berisi array bukan struct, Anda dapat menggunakan konektor untuk query elemen pertama dalam array.
```
import org.apache.spark.sql.types._
val sc = // existing SparkContext
val sqlContext = new SQLContext(sc)
val schema = StructType(StructField("a", ArrayType(IntegerType)):: Nil)
val helloDF = sqlContext.read
.format("io.github.spark_redshift_community.spark.redshift")
.option("url", jdbcURL )
.option("tempdir", tempS3Dir)
.option("dbtable", "contains_super")
.schema(schema)
.load().selectExpr("a[0]")
```
### Batasan
Menggunakan tipe data yang kompleks dengan konektor percikan memiliki batasan berikut:
+ Semua nama bidang struct bersarang dan kunci peta harus huruf kecil. Jika menanyakan nama bidang kompleks dengan huruf besar, Anda dapat mencoba menghilangkan skema dan menggunakan fungsi `from_json` percikan untuk mengonversi string yang dikembalikan secara lokal sebagai solusi.
+ Setiap bidang peta yang digunakan dalam operasi baca atau tulis harus hanya memiliki `StringType` kunci.
+ Hanya`CSV`,`CSV GZIP`, dan `PARQUET ` didukung nilai tempformat untuk menulis tipe kompleks ke Redshift. Mencoba menggunakan `AVRO ` akan menimbulkan pengecualian.
# Mengonfigurasi koneksi untuk driver ODBC versi 2.x untuk Amazon Redshift
Anda dapat menggunakan koneksi ODBC untuk terhubung ke klaster Amazon Redshift Anda dari banyak alat dan aplikasi klien SQL pihak ketiga. Jika alat klien Anda mendukung JDBC, Anda dapat memilih untuk menggunakan jenis koneksi itu daripada ODBC karena kemudahan konfigurasi yang disediakan JDBC. Namun, jika alat klien Anda tidak mendukung JDBC, Anda dapat mengikuti langkah-langkah di bagian ini untuk mengatur koneksi ODBC di komputer klien atau instans Amazon EC2.
Amazon Redshift menyediakan driver ODBC 64-bit untuk sistem operasi Linux, Windows dan Mac; driver ODBC 32-bit dihentikan. Pembaruan lebih lanjut untuk driver ODBC 32-bit tidak akan dirilis, kecuali untuk patch keamanan yang mendesak.
Untuk informasi terbaru tentang perubahan driver ODBC, lihat [log perubahan](https://github.com/aws/amazon-redshift-odbc-driver/blob/master/CHANGELOG.md).
**Topics**
+ [Mendapatkan URL ODBC](odbc20-getting-url.md)
+ [Menggunakan driver Amazon Redshift ODBC di Microsoft Windows](odbc20-install-config-win.md)
+ [Menggunakan driver Amazon Redshift ODBC di Linux](odbc20-install-config-linux.md)
+ [Menggunakan driver Amazon Redshift ODBC di Apple macOS](odbc20-install-config-mac.md)
+ [Metode autentikasi](odbc20-authentication-ssl.md)
+ [Konversi tipe data](odbc20-converting-data-types.md)
+ [Opsi driver ODBC](odbc20-configuration-options.md)
+ [Versi driver ODBC sebelumnya](odbc20-previous-versions.md)
# Mendapatkan URL ODBC
Amazon Redshift menampilkan URL ODBC untuk klaster Anda di konsol Amazon Redshift. URL ini berisi informasi yang diperlukan untuk mengatur koneksi antara komputer klien Anda dan database.
URL ODBC memiliki format berikut:
```
Driver={driver}; Server=endpoint_host; Database=database_name; UID=user_name; PWD=password; Port=port_number
```
Bidang format sebelumnya memiliki nilai-nilai berikut:
| Bidang | Nilai |
| --- | --- |
| Driver | Nama driver ODBC 64-bit yang akan digunakan: Amazon Redshift ODBC Driver (x64) |
| Server | Host endpoint dari cluster Amazon Redshift. |
| Database | Database yang Anda buat untuk cluster Anda. |
| UID | Nama pengguna dari akun pengguna database yang memiliki izin untuk terhubung ke database. Meskipun nilai ini adalah izin tingkat basis data dan bukan izin tingkat cluster, Anda dapat menggunakan akun pengguna admin Redshift yang Anda atur saat meluncurkan cluster. |
| PWD | Kata sandi untuk akun pengguna database untuk terhubung ke database. |
| Port | Nomor port yang Anda tentukan saat meluncurkan cluster. Jika Anda memiliki firewall, pastikan port ini terbuka untuk Anda gunakan. |
Berikut ini adalah contoh URL ODBC:
```
Driver={Amazon Redshift ODBC Driver (x64)}; Server=examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com; Database=dev; UID=adminuser; PWD=insert_your_admin_user_password_here; Port=5439
```
Untuk informasi tentang tempat menemukan URL ODBC, lihat [Menemukan string koneksi cluster Anda](https://docs.aws.amazon.com/redshift/latest/mgmt/configuring-connections.html#connecting-connection-string).
# Menggunakan driver Amazon Redshift ODBC di Microsoft Windows
Anda harus menginstal driver Amazon Redshift ODBC di komputer klien yang mengakses gudang data Amazon Redshift. Untuk setiap komputer tempat Anda menginstal driver, ada persyaratan minimum berikut:
+ Hak administrator pada mesin.
+ Mesin memenuhi persyaratan sistem berikut:
+ Salah satu sistem operasi berikut:
+ Windows 10 atau 8.1.
+ Windows Server 2019, 2016, atau 2012.
+ 100 MB ruang disk yang tersedia.
+ Visual C \$1\$1 Redistributable untuk Visual Studio 2015 untuk Windows 64-bit diinstal. Anda dapat mengunduh paket instalasi di [Download Visual C\$1\$1 Redistributable for Visual Studio 2022](https://visualstudio.microsoft.com/downloads/#microsoft-visual-c-redistributable-for-visual-studio-2022) di situs web Microsoft.
# Mengunduh dan menginstal driver Amazon Redshift ODBC
Gunakan prosedur berikut untuk mengunduh dan menginstal driver Amazon Redshift ODBC untuk sistem operasi Windows. Hanya gunakan driver yang berbeda jika Anda menjalankan aplikasi pihak ketiga yang disertifikasi untuk digunakan dengan Amazon Redshift, dan aplikasi itu memerlukan driver khusus itu.
Untuk mengunduh dan menginstal driver ODBC:
1. [Unduh driver berikut: [64-bit ODBC driver versi 2.1.15.0 Di](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.15.0/AmazonRedshiftODBC64-2.1.15.0.msi) 64-bit ODBC driver versi 2.1.15.0](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/odbc/2.1.15.0/AmazonRedshiftODBC64-2.1.15.0.msi)
Nama driver ini adalah **Amazon Redshift ODBC Driver (**x64).
1. Tinjau lisensi [driver Amazon Redshift ODBC versi](https://github.com/aws/amazon-redshift-odbc-driver/blob/master/LICENSE) 2.x.
1. Klik dua kali file.msi, lalu ikuti langkah-langkah di wizard untuk menginstal driver.
# Membuat entri DSN sistem untuk koneksi ODBC
Setelah Anda mengunduh dan menginstal driver ODBC, tambahkan entri nama sumber data (DSN) ke komputer klien atau instans Amazon EC2. Alat klien SQL dapat menggunakan sumber data ini untuk terhubung ke database Amazon Redshift.
Kami menyarankan Anda membuat sistem DSN bukan DSN pengguna. Beberapa aplikasi memuat data menggunakan akun pengguna database yang berbeda, dan mungkin tidak dapat mendeteksi pengguna DSNs yang dibuat di bawah akun pengguna database lain.
**catatan**
Untuk autentikasi menggunakan kredensial AWS Identity and Access Management (IAM) atau kredensial penyedia identitas (iDP), diperlukan langkah-langkah tambahan. Untuk informasi selengkapnya, lihat [Mengkonfigurasi koneksi JDBC atau ODBC untuk menggunakan](https://docs.aws.amazon.com/redshift/latest/mgmt/generating-iam-credentials-configure-jdbc-odbc.html) kredensyal IAM.
Untuk membuat entri DSN sistem untuk koneksi ODBC:
1. Di menu **Mulai**, ketik “Sumber Data ODBC.” Pilih **Sumber Data ODBC**.
Pastikan Anda memilih Administrator Sumber Data ODBC yang memiliki bitness yang sama dengan aplikasi klien yang Anda gunakan untuk terhubung ke Amazon Redshift.
1. Di **Administrator Sumber Data ODBC**, pilih tab **Driver** dan cari folder driver berikut: **Amazon Redshift ODBC Driver** (x64).
1. Pilih tab **Sistem DSN** untuk mengonfigurasi driver untuk semua pengguna di komputer, atau tab **DSN Pengguna** untuk mengonfigurasi driver hanya untuk akun pengguna database Anda.
1. Pilih **Tambahkan**. Jendela **Create New Data Source** terbuka.
1. **Pilih **driver Amazon Redshift ODBC (x64)**, lalu pilih Selesai.** Jendela **Pengaturan DSN Driver Amazon Redshift ODBC** terbuka.
1. Di bawah bagian **Pengaturan Koneksi**, masukkan informasi berikut:
+
**Nama sumber data**
Masukkan sebuah nama untuk sumber data. Misalnya, jika Anda mengikuti *Panduan Memulai Amazon Redshift*, Anda dapat mengetik `exampleclusterdsn` agar mudah mengingat cluster yang Anda kaitkan dengan DSN ini.
+
**Server**
Tentukan host endpoint untuk cluster Amazon Redshift Anda. Anda dapat menemukan informasi ini di konsol Amazon Redshift di halaman detail cluster. Untuk informasi selengkapnya, lihat [Mengonfigurasi koneksi di Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/configuring-connections.html).
+
**Port**
Masukkan nomor port yang digunakan database. Bergantung pada port yang Anda pilih saat membuat, memodifikasi, atau memigrasi klaster, izinkan akses ke port yang dipilih.
+
**Basis Data**
Masukkan nama database Amazon Redshift. Jika Anda meluncurkan cluster Anda tanpa menentukan nama database, masukkan`dev`. Jika tidak, gunakan nama yang Anda pilih selama proses peluncuran. Jika Anda mengikuti *Panduan Memulai Amazon Redshift, masukkan*. `dev`
1. Di bawah bagian **Otentikasi**, tentukan opsi konfigurasi untuk mengonfigurasi otentikasi standar atau IAM.
1. Pilih **Opsi SSL** dan tentukan nilai untuk yang berikut ini:
+
**Mode autentikasi**
Pilih mode untuk menangani Secure Sockets Layer (SSL). Dalam lingkungan pengujian, Anda mungkin menggunakan`prefer`. Namun, untuk lingkungan produksi dan ketika pertukaran data yang aman diperlukan, gunakan `verify-ca` atau`verify-full`.
+
**Min TLS**
Secara opsional, pilih versi minimum TLS/SSL yang memungkinkan penyimpanan data digunakan oleh driver untuk mengenkripsi koneksi. Misalnya, jika Anda menentukan TLS 1.2, TLS 1.1 tidak dapat digunakan untuk mengenkripsi koneksi. Versi defaultnya adalah TLS 1.2.
1. Di tab **Proxy**, tentukan pengaturan koneksi proxy apa pun.
1. Di tab **Kursor**, tentukan opsi tentang cara mengembalikan hasil kueri ke alat atau aplikasi klien SQL Anda.
1. Di **Opsi Lanjutan**, tentukan nilai untuk`logLevel`,`logPath`,`compression`, dan opsi lainnya.
1. Pilih **Uji**. Jika komputer klien dapat terhubung ke database Amazon Redshift, pesan berikut akan muncul: **Koneksi** berhasil. Jika komputer klien gagal terhubung ke database, Anda dapat memecahkan masalah yang mungkin terjadi dengan membuat file log dan menghubungi AWS dukungan. Untuk informasi tentang membuat log, lihat (LINK).
1. Pilih **OK**.
# Menggunakan driver Amazon Redshift ODBC di Linux
Anda harus menginstal driver Amazon Redshift ODBC di komputer klien yang mengakses gudang data Amazon Redshift. Untuk setiap komputer tempat Anda menginstal driver, ada persyaratan minimum berikut:
+ Akses root pada mesin.
+ Salah satu distribusi berikut:
+ Red Hat® Enterprise Linux® (RHEL) 8 atau lebih baru
+ CentOS 8 atau yang lebih baru.
+ 150 MB ruang disk yang tersedia.
+ UnixODBC 2.2.14 atau yang lebih baru.
+ glibc 2.26 atau yang lebih baru.
# Mengunduh dan menginstal driver Amazon Redshift ODBC
Untuk mengunduh dan menginstal driver Amazon Redshift ODBC versi 2.x untuk Linux:
1. Unduh driver berikut:
+ [x86 64-bit RPM driver versi 2.1.15.0 Di](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.15.0/AmazonRedshiftODBC-64-bit-2.1.15.0.x86_64.rpm) [ versi driver RPM 64-bit 2.1.15.0](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/odbc/2.1.15.0/AmazonRedshiftODBC-64-bit-2.1.15.0.x86_64.rpm)
+ [Versi driver ARM 64-bit RPM 2.1.15.0](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.15.0/AmazonRedshiftODBC-64-bit-2.1.15.0.aarch64.rpm) versi 2.1.15.0
**catatan**
Driver ODBC 32-bit dihentikan. Pembaruan lebih lanjut tidak akan dirilis, kecuali untuk patch keamanan yang mendesak.
1. Pergi ke lokasi di mana Anda mengunduh paket, dan kemudian jalankan salah satu perintah berikut. Gunakan perintah yang sesuai dengan distribusi Linux Anda.
Pada sistem operasi RHEL dan CentOS, jalankan perintah berikut:
```
yum --nogpgcheck localinstall RPMFileName
```
Ganti `RPMFileName` dengan nama file paket RPM. Misalnya, perintah berikut menunjukkan menginstal driver 64-bit:
```
yum --nogpgcheck localinstall AmazonRedshiftODBC-64-bit-2.x.xx.xxxx.x86_64.rpm
```
# Menggunakan manajer driver ODBC untuk mengonfigurasi driver ODBC
Di Linux, Anda menggunakan manajer driver ODBC untuk mengonfigurasi pengaturan koneksi ODBC. Manajer driver ODBC menggunakan file konfigurasi untuk menentukan dan mengkonfigurasi sumber data dan driver ODBC. Manajer driver ODBC yang Anda gunakan bergantung pada sistem operasi yang Anda gunakan.
## Mengkonfigurasi driver ODBC menggunakan pengelola driver UnixODBC
File-file berikut diperlukan untuk mengonfigurasi driver Amazon Redshift ODBC:
+ ` amazon.redshiftodbc.ini `
+ ` odbc.ini `
+ ` odbcinst.ini `
Jika Anda menginstal ke lokasi default, file `amazon.redshiftodbc.ini` konfigurasi terletak di`/opt/amazon/redshiftodbcx64`.
Selain itu, di bawah`/opt/amazon/redshiftodbcx64`, Anda dapat menemukan sampel `odbc.ini` dan `odbcinst.ini` file. Anda dapat menggunakan file-file ini sebagai contoh untuk mengonfigurasi driver Amazon Redshift ODBC dan nama sumber data (DSN).
Kami tidak menyarankan menggunakan direktori instalasi driver Amazon Redshift ODBC untuk file konfigurasi. File sampel dalam direktori yang diinstal hanya untuk tujuan contoh. Jika Anda menginstal ulang driver Amazon Redshift ODBC di lain waktu, atau meningkatkan ke versi yang lebih baru, direktori instalasi akan ditimpa. Anda akan kehilangan perubahan apa pun yang mungkin telah Anda buat pada file di direktori instalasi.
Untuk menghindari hal ini, salin `amazon.redshiftodbc.ini` file ke direktori selain direktori instalasi. Jika Anda menyalin file ini ke direktori home pengguna, tambahkan titik (.) ke awal nama file untuk menjadikannya file tersembunyi.
Untuk `odbcinst.ini` file `odbc.ini` dan, gunakan file konfigurasi di direktori home pengguna atau buat versi baru di direktori lain. Secara default, sistem operasi Linux Anda harus memiliki `odbc.ini` file dan `odbcinst.ini` file di direktori home pengguna (`/home/$USER`atau`~/.`). File default ini adalah file tersembunyi, yang ditunjukkan oleh titik (.) di depan setiap nama file. File-file ini hanya ditampilkan ketika Anda menggunakan `-a` bendera untuk daftar isi direktori.
Opsi apa pun yang Anda pilih untuk `odbcinst.ini` file `odbc.ini` dan, ubah file untuk menambahkan informasi konfigurasi driver dan DSN. Jika Anda membuat file baru, Anda juga perlu mengatur variabel lingkungan untuk menentukan di mana file konfigurasi ini berada.
Secara default, manajer driver ODBC dikonfigurasi untuk menggunakan versi tersembunyi dari file `odbc.ini` dan `odbcinst.ini` konfigurasi (bernama `.odbc.ini` dan`.odbcinst.ini`) yang terletak di direktori home. Mereka juga dikonfigurasi untuk menggunakan `amazon.redshiftodbc.ini` file di direktori instalasi driver. Jika Anda menyimpan file konfigurasi ini di tempat lain, atur variabel lingkungan yang dijelaskan berikut ini sehingga manajer driver dapat menemukan file.
Jika Anda menggunakan UnixODBC, lakukan hal berikut:
+ Atur `ODBCINI` ke path lengkap dan nama file `odbc.ini` file.
+ Setel `ODBCSYSINI` ke path lengkap direktori yang berisi `odbcinst.ini` file.
+ Atur `AMAZONREDSHIFTODBCINI` ke path lengkap dan nama file `amazon.redshiftodbc.ini` file.
Berikut ini adalah contoh pengaturan nilai-nilai di atas:
```
export ODBCINI=/usr/local/odbc/odbc.ini
export ODBCSYSINI=/usr/local/odbc
export AMAZONREDSHIFTODBCINI=/etc/amazon.redshiftodbc.ini
```
## Mengkonfigurasi koneksi menggunakan nama sumber data (DSN) di Linux
Saat menghubungkan ke penyimpanan data Anda menggunakan nama sumber data (DSN), konfigurasikan `odbc.ini` file untuk menentukan nama sumber data (DSNs). Tetapkan properti dalam `odbc.ini` file untuk membuat DSN yang menentukan informasi koneksi untuk penyimpanan data Anda.
Pada sistem operasi Linux, gunakan format berikut:
```
[ODBC Data Sources]
driver_name=dsn_name
[dsn_name]
Driver=path/driver_file
Host=cluster_endpoint
Port=port_number
Database=database_name
locale=locale
```
Contoh berikut menunjukkan konfigurasi untuk `odbc.ini` dengan driver ODBC 64-bit pada sistem operasi Linux.
```
[ODBC Data Sources]
Amazon_Redshift_x64=Amazon Redshift ODBC Driver (x64)
[Amazon_Redshift_x64]
Driver=/opt/amazon/redshiftodbcx64/librsodbc64.so
Host=examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com
Port=5932Database=dev
locale=en-US
```
## Mengkonfigurasi koneksi tanpa DSN di Linux
Untuk terhubung ke penyimpanan data Anda melalui koneksi yang tidak memiliki DSN, tentukan driver dalam `odbcinst.ini` file. Kemudian berikan string koneksi tanpa DSN di aplikasi Anda.
Pada sistem operasi Linux, gunakan format berikut:
```
[ODBC Drivers]
driver_name=Installed
...
[driver_name]
Description=driver_description
Driver=path/driver_file
...
```
Contoh berikut menunjukkan konfigurasi untuk `odbcinst.ini` dengan driver ODBC 64-bit pada sistem operasi Linux.
```
[ODBC Drivers]
Amazon Redshift ODBC Driver (x64)=Installed
[Amazon Redshift ODBC Driver (x64)]
Description=Amazon Redshift ODBC Driver (64-bit)
Driver=/opt/amazon/redshiftodbcx64/librsodbc64.so
```
# Menggunakan driver Amazon Redshift ODBC di Apple macOS
Anda harus menginstal driver Amazon Redshift ODBC di komputer klien yang mengakses gudang data Amazon Redshift. Untuk setiap komputer tempat Anda menginstal driver, ini adalah persyaratan minimum berikut:
+ Akses root pada mesin.
+ Persyaratan Sistem Apple macOS:
+ Versi 64-bit Apple macOS versi 11.7 atau lebih tinggi (seperti Apple macOS Big Sur, Monterey, Ventura atau yang lebih baru) diperlukan. Driver Redshift ODBC hanya mendukung aplikasi klien 64-bit.
+ 150 MB ruang disk yang tersedia.
+ Driver mendukung aplikasi yang dibangun dengan iodBC 3.52.9\$1atau UnixODBC 2.3.7\$1.
# Mengunduh dan menginstal driver Amazon Redshift ODBC
Gunakan prosedur berikut untuk mengunduh dan menginstal driver Amazon Redshift ODBC di Apple macOS. Hanya gunakan driver yang berbeda jika Anda menjalankan aplikasi pihak ketiga yang disertifikasi untuk digunakan dengan Amazon Redshift, dan aplikasi itu memerlukan driver khusus itu.
Untuk mengunduh dan menginstal driver ODBC:
1. [Unduh driver berikut: [64-bit ODBC driver versi 2.1.15.0 Di](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.15.0/AmazonRedshiftODBC-64-bit.2.1.15.0.universal.pkg) 64-bit ODBC driver versi 2.1.15.0](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/odbc/2.1.15.0/AmazonRedshiftODBC-64-bit.2.1.15.0.universal.pkg)
Driver ini didukung pada arsitektur x86\$164 dan arm64. Nama driver ini adalah **Amazon Redshift ODBC Driver (**x64).
1. Tinjau lisensi [driver Amazon Redshift ODBC versi](https://github.com/aws/amazon-redshift-odbc-driver/blob/master/LICENSE) 2.x.
1. Klik dua kali file.pkg, lalu ikuti langkah-langkah di wizard untuk menginstal driver. Atau, jalankan perintah berikut:
```
sudo installer -pkg PKGFileName -target /
```
Ganti `PKGFileName` dengan nama file paket pkg. Misalnya, perintah berikut menunjukkan menginstal driver 64-bit:
```
sudo installer -pkg ./AmazonRedshiftODBC-64-bit.X.X.XX.X.universal.pkg -target /
```
# Menggunakan manajer driver ODBC untuk mengonfigurasi driver ODBC
Di Mac, Anda menggunakan pengelola driver ODBC untuk mengonfigurasi pengaturan koneksi ODBC. Manajer driver ODBC menggunakan file konfigurasi untuk menentukan dan mengkonfigurasi sumber data dan driver ODBC. Manajer driver ODBC yang Anda gunakan bergantung pada sistem operasi yang Anda gunakan.
## Mengkonfigurasi driver ODBC menggunakan manajer driver iodBC atau UnixODBC
File-file berikut diperlukan untuk mengonfigurasi driver Amazon Redshift ODBC:
+ ` amazon.redshiftodbc.ini `
+ ` odbc.ini `
+ ` odbcinst.ini `
Jika Anda menginstal ke lokasi default, file `amazon.redshiftodbc.ini` konfigurasi terletak di`/opt/amazon/redshiftodbcx64`.
Selain itu, di bawah`/opt/amazon/redshiftodbcx64`, Anda dapat menemukan sampel `odbc.ini` dan `odbcinst.ini` file. Anda dapat menggunakan file-file ini sebagai contoh untuk mengonfigurasi driver Amazon Redshift ODBC dan nama sumber data (DSN). File sampel dalam direktori yang diinstal hanya untuk tujuan contoh.
Kami tidak menyarankan menggunakan direktori instalasi driver Amazon Redshift ODBC untuk file konfigurasi. Jika Anda menginstal ulang driver Amazon Redshift ODBC di lain waktu, atau meningkatkan ke versi yang lebih baru, direktori instalasi akan ditimpa. Anda akan kehilangan perubahan apa pun yang mungkin telah Anda buat pada file di direktori instalasi.
Untuk menghindari hal ini`odbc.ini`, salin, `odbcinst.ini` dan `amazon.redshiftodbc.ini` file ke direktori selain direktori instalasi. Jika Anda menyalin file-file ini ke direktori home pengguna, tambahkan titik (.) ke awal nama file ini untuk menjadikannya file tersembunyi.
Ubah file untuk menambahkan informasi konfigurasi DSN. Saat Anda membuat file baru, Anda juga perlu mengatur variabel lingkungan untuk menentukan di mana file konfigurasi ini berada.
Berikut ini adalah contoh pengaturan variabel lingkungan:
```
export ODBCINI=/Library/ODBC/odbc.ini
export ODBCSYSINI=/Library/ODBC
export ODBCINSTINI=${ODBCSYSINI}/odbcinst.ini
```
Untuk aplikasi baris perintah: Tambahkan perintah ekspor ke file startup shell Anda (misalnya, `~/.bash_profile` atau`~/.zshrc`).
Untuk versi manajer driver yang didukung, lihat [di sini](https://docs.aws.amazon.com/redshift/latest/mgmt/odbc20-install-config-mac.html)
### Mengonfigurasi koneksi menggunakan nama sumber data (DSN) di Apple macOS
Saat menghubungkan ke penyimpanan data Anda menggunakan nama sumber data (DSN), konfigurasikan `odbc.ini` file untuk menentukan nama sumber data (DSNs). Tetapkan properti dalam `odbc.ini` file untuk membuat DSN yang menentukan informasi koneksi untuk gudang data Redshift Anda.
Di Apple macOS, gunakan format berikut:
```
[ODBC Data Sources]
driver_name=dsn_name
[dsn_name]
Driver=path/driver_file
Host=cluster_endpoint
Port=port_number
Database=database_name
locale=locale
```
Contoh berikut menunjukkan konfigurasi untuk `odbc.ini` dengan driver ODBC 64-bit di Apple macOS.
```
[ODBC Data Sources]
Amazon_Redshift_x64=Amazon Redshift ODBC Driver (x64)
[Amazon_Redshift_x64]
Driver=/opt/amazon/redshiftodbcx64/librsodbc64.dylib
Host=examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com
Port=5932
Database=dev
locale=en-US
```
### Mengkonfigurasi koneksi tanpa DSN di Apple macOS
Untuk terhubung ke gudang data Redshift Anda melalui koneksi yang tidak memiliki DSN, tentukan driver dalam file. `odbcinst.ini` Kemudian berikan string koneksi tanpa DSN di aplikasi Anda.
Di Apple macOS, gunakan format berikut:
```
[ODBC Drivers]
driver_name=Installed
...
[driver_name]
Description=driver_description
Driver=path/driver_file
...
```
Contoh berikut menunjukkan konfigurasi untuk `odbcinst.ini` dengan driver ODBC 64-bit di Apple macOS.
```
[ODBC Drivers]
Amazon Redshift ODBC Driver (x64)=Installed
[Amazon Redshift ODBC Driver (x64)]
Description=Amazon Redshift ODBC Driver (64-bit)
Driver=/opt/amazon/redshiftodbcx64/librsodbc64.dylib
```
# Metode autentikasi
Untuk melindungi data dari akses yang tidak sah, penyimpanan data Amazon Redshift memerlukan semua koneksi untuk diautentikasi menggunakan kredensil pengguna.
Tabel berikut mengilustrasikan opsi koneksi yang diperlukan dan opsional untuk setiap metode otentikasi yang dapat digunakan untuk menyambung ke driver Amazon Redshift ODBC versi 2.x:
| Metode Otentikasi | Diperlukan | Opsional |
| --- | --- | --- |
| Standar | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) | |
| Profil IAM | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) **ClusterID** **dan** Region harus disetel **di** Host jika tidak disetel secara terpisah. |
| Kredensi IAM | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) **ClusterID** **dan** Region harus disetel **di** Host jika tidak disetel secara terpisah. |
| IKLAN FS | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) **ClusterID** **dan** Region harus disetel **di** Host jika tidak disetel secara terpisah. |
| Azure AD | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) **ClusterID** **dan** Region harus disetel **di** Host jika tidak disetel secara terpisah. |
| JWT | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) |
| Okta | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) **ClusterID** **dan** Region harus disetel **di** Host jika tidak disetel secara terpisah. |
| Federasi Ping | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) **ClusterID** **dan** Region harus disetel **di** Host jika tidak disetel secara terpisah. |
| Browser Azure AD | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) **ClusterID** **dan** Region harus disetel **di** Host jika tidak disetel secara terpisah. |
| Browser SAMP | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) **ClusterID** **dan** Region harus disetel **di** Host jika tidak disetel secara terpisah. |
| Profil Auth | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) | |
| Browser Azure AD OAUTH2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) **ClusterID** **dan** Region harus disetel **di** Host jika tidak disetel secara terpisah. |
| AWS Pusat Identitas IAM | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/odbc20-authentication-ssl.html) |
## Menggunakan layanan kredensyal eksternal
Selain dukungan bawaan untuk AD FS, Azure AD, dan Okta, versi Windows dari driver Amazon Redshift ODBC juga menyediakan dukungan untuk layanan kredensil lainnya. Driver dapat mengautentikasi koneksi menggunakan plugin penyedia kredensyal berbasis SAML pilihan Anda.
Untuk mengkonfigurasi layanan kredensional eksternal pada Windows:
1. Buat profil IAM yang menentukan plugin penyedia kredensyal dan parameter otentikasi lainnya sesuai kebutuhan. Profil harus dikodekan ASCII, dan harus berisi pasangan kunci-nilai berikut, di mana jalur lengkap ke aplikasi `PluginPath` plugin:
```
plugin_name = PluginPath
```
Contoh:
```
plugin_name = C:\Users\kjson\myapp\CredServiceApp.exe
```
Untuk informasi tentang cara membuat profil, lihat [Menggunakan Profil Konfigurasi di Panduan](https://docs.aws.amazon.com/redshift/latest/mgmt/options-for-providing-iam-credentials.html#using-configuration-profile) Manajemen Cluster Amazon Redshift.
1. Konfigurasikan driver untuk menggunakan profil ini. Driver mendeteksi dan menggunakan pengaturan otentikasi yang ditentukan dalam profil.
# Konversi tipe data
Driver Amazon Redshift ODBC versi 2.x mendukung banyak format data umum, mengonversi antara Amazon Redshift dan tipe data SQL.
Tabel berikut mencantumkan pemetaan tipe data yang didukung.
| Jenis Amazon Redshift | Jenis SQL |
| --- | --- |
| BIGINT | SQL\$1BIGINT |
| BOOLEAN | SQL\$1BIT |
| CHAR | SQL\$1CHAR |
| DATE | SQL\$1TYPE\$1DATE |
| DECIMAL | SQL\$1NUMERIK |
| DOUBLE PRECISION | SQL\$1GANDA |
| GEOGRAPHY | SQL\$1 LONGVARBINARY |
| GEOMETRY | SQL\$1 LONGVARBINARY |
| INTEGER | SQL\$1INTEGER |
| REAL | SQL\$1REAL |
| SMALLINT | SQL\$1SMALLINT |
| SUPER | SQL\$1LONGVARCHAR |
| TEXT | SQL\$1LONGVARCHAR |
| TIME | SQL\$1TYPE\$1TIME |
| JADWAL | SQL\$1TYPE\$1TIME |
| TIMESTAMP | STEMPEL WAKTU SQL\$1TYPE\$1 |
| TIMESTAMPTZ | STEMPEL WAKTU SQL\$1TYPE\$1 |
| VARBYTE | SQL\$1LONGVARBINARY |
| VARCHAR | SQL\$1VARCHAR |
# Opsi driver ODBC
Anda dapat menggunakan opsi konfigurasi driver untuk mengontrol perilaku driver Amazon Redshift ODBC. Opsi driver tidak peka huruf besar/kecil.
Di Microsoft Windows, Anda biasanya mengatur opsi driver saat mengonfigurasi nama sumber data (DSN). Anda juga dapat mengatur opsi driver dalam string koneksi saat Anda terhubung secara terprogram, atau dengan menambahkan atau mengubah kunci registri. `HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\your_DSN`
Di Linux, Anda mengatur opsi konfigurasi driver di `amazon.redshiftodbc.ini` file `odbc.ini` dan Anda. Opsi konfigurasi yang diatur dalam `amazon.redshiftodbc.ini` file berlaku untuk semua koneksi. Sebaliknya, opsi konfigurasi yang diatur dalam `odbc.ini` file khusus untuk koneksi. Opsi konfigurasi yang disetel lebih `odbc.ini` diutamakan daripada opsi konfigurasi yang ditetapkan. `amazon.redshiftodbc.ini`
Berikut ini adalah deskripsi untuk opsi yang dapat Anda tentukan untuk driver Amazon Redshift ODBC versi 2.x:
## AccessKeyID
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Kunci akses IAM untuk pengguna atau peran. Jika Anda mengatur parameter ini, Anda juga harus menentukan **SecretAccessKey**.
Parameter ini bersifat opsional.
## app\$1id
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
ID unik yang disediakan OKTA yang terkait dengan aplikasi Amazon Redshift Anda.
Parameter ini bersifat opsional.
## ApplicationName
+ **Nilai default** - Tidak ada
+ **Tipe data** - String
Nama aplikasi klien untuk diteruskan ke Amazon Redshift untuk tujuan audit. [Nama aplikasi yang Anda berikan muncul di kolom 'application\$1name' dari tabel SYS\$1CONNECTION\$1LOG.](https://docs.aws.amazon.com/redshift/latest/dg/SYS_CONNECTION_LOG.html) Ini membantu melacak dan memecahkan masalah sumber koneksi saat men-debug masalah.
Parameter ini bersifat opsional.
## app\$1name
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama aplikasi Okta yang Anda gunakan untuk mengautentikasi koneksi ke Amazon Redshift.
Parameter ini bersifat opsional.
## AuthProfile
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Profil otentikasi yang digunakan untuk mengelola pengaturan koneksi. Jika Anda mengatur parameter ini, Anda juga harus mengatur **AccessKeyID** dan **SecretAccessKey**.
Parameter ini bersifat opsional.
## AuthType
+ **Nilai Default** - Standar
+ **Tipe Data** - String
Opsi ini menentukan mode otentikasi yang digunakan driver saat Anda mengonfigurasi DSN menggunakan kotak dialog Amazon Redshift ODBC Driver DSN Setup:
+ Standar: Otentikasi standar menggunakan nama pengguna dan kata sandi Amazon Redshift Anda.
+ AWS Profil: Autentikasi IAM menggunakan profil.
+ AWS IAM Credentials: Autentikasi IAM menggunakan kredensi IAM.
+ Penyedia Identitas: AD FS: Autentikasi IAM menggunakan Layanan Federasi Direktori Aktif (AD FS).
+ Penyedia Identitas: Plugin Auth: Plugin otorisasi yang menerima token AWS IAM Identity Center atau token identitas berbasis JSON (OIDC) OpenID Connect (OIDC) dari penyedia identitas web mana pun yang ditautkan ke IAM Identity Center. AWS
+ Penyedia Identitas: Azure AD: Autentikasi IAM menggunakan portal Azure AD.
+ Penyedia Identitas: JWT: Autentikasi IAM menggunakan JSON Web Token (JWT).
+ Penyedia Identitas: Okta: Otentikasi IAM menggunakan Okta.
+ Penyedia Identitas: PingFederate: Autentikasi IAM menggunakan. PingFederate
Opsi ini hanya tersedia ketika Anda mengonfigurasi DSN menggunakan kotak dialog Amazon Redshift ODBC Driver DSN Setup di driver Windows. Saat Anda mengonfigurasi koneksi menggunakan string koneksi atau mesin non-Windows, driver secara otomatis menentukan apakah akan menggunakan otentikasi Kredensial Standar, AWS Profil, atau AWS IAM berdasarkan kredensi yang Anda tentukan. Untuk menggunakan penyedia identitas, Anda harus mengatur properti **plugin\$1name**.
Parameter ini diperlukan.
## AutoCreate
+ **Nilai Default** - 0
+ **Tipe Data** - Boolean
Boolean yang menentukan apakah driver membuat pengguna baru ketika pengguna yang ditentukan tidak ada.
+ 1 \$1 BENAR: Jika pengguna yang ditentukan oleh **UID** tidak ada, driver membuat pengguna baru.
+ 0 \$1 SALAH: Driver tidak membuat pengguna baru. Jika pengguna yang ditentukan tidak ada, otentikasi gagal.
Parameter ini bersifat opsional.
## CaFile
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Jalur file ke file sertifikat CA yang digunakan untuk beberapa bentuk otentikasi IAM.
Parameter ini hanya tersedia di Linux.
Parameter ini bersifat opsional.
## client\$1id
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
ID klien yang terkait dengan aplikasi Amazon Redshift Anda di Azure AD.
Parameter ini diperlukan jika mengautentikasi melalui layanan Azure AD.
## rahasia klien\$1
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Kunci rahasia yang terkait dengan aplikasi Amazon Redshift Anda di Azure AD.
Parameter ini diperlukan jika mengautentikasi melalui layanan Azure AD.
## ClusterId
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama cluster Amazon Redshift yang ingin Anda sambungkan. Ini digunakan dalam otentikasi IAM. ID Cluster tidak ditentukan dalam parameter **Server**.
Parameter ini bersifat opsional.
## Kompresi
+ **Nilai Default** - off
+ **Tipe Data** - String
Metode kompresi yang digunakan untuk komunikasi protokol kawat antara server Amazon Redshift dan klien atau driver.
Anda dapat menentukan salah satu nilai berikut:
+ lz4: Mengatur metode kompresi yang digunakan untuk komunikasi protokol kawat dengan Amazon Redshift ke. `lz4`
+ zstd: Menyetel metode kompresi yang digunakan untuk komunikasi protokol kawat dengan Amazon Redshift ke. `zstd`
+ off: Tidak menggunakan kompresi untuk komunikasi protokol kawat dengan Amazon Redshift.
Parameter ini bersifat opsional.
## Basis Data
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama database Amazon Redshift yang ingin Anda akses.
Parameter ini diperlukan.
## DatabaseMetadataCurrentDbOnly
+ **Nilai Default** - 1
+ **Tipe Data** - Boolean
Boolean yang menentukan apakah driver mengembalikan metadata dari beberapa database dan cluster.
+ 1 \$1 BENAR: Driver hanya mengembalikan metadata dari database saat ini.
+ 0 \$1 SALAH. Driver mengembalikan metadata di beberapa database dan cluster Amazon Redshift.
Parameter ini bersifat opsional.
## dbgroups\$1filter
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Ekspresi reguler yang dapat Anda tentukan untuk memfilter DbGroups yang diterima dari respons SAFL ke Amazon Redshift saat menggunakan jenis autentikasi Azure, Browser Azure, dan Browser SALL.
Parameter ini bersifat opsional.
## Driver
+ **Nilai Default** - Driver Amazon Redshift ODBC (x64)
+ **Tipe Data** - String
Nama sopirnya. Satu-satunya nilai yang didukung adalah **Amazon Redshift ODBC Driver (**x64).
Parameter ini diperlukan jika Anda tidak mengatur **DSN**.
## DSN
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama nama sumber data driver. Aplikasi menentukan DSN di SQLDriver Connect API.
Parameter ini diperlukan jika Anda tidak mengatur **Driver.** .
## EndpointUrl
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Titik akhir utama yang digunakan untuk berkomunikasi dengan Amazon Redshift Coral Service untuk otentikasi IAM.
Parameter ini bersifat opsional.
## ForceLowercase
+ **Nilai Default** - 0
+ **Tipe Data** - Boolean
Boolean yang menentukan apakah driver huruf kecil semua DbGroups dikirim dari penyedia identitas ke Amazon Redshift saat menggunakan autentikasi masuk tunggal.
+ 1 \$1 BENAR: Driver huruf kecil semua DbGroups yang dikirim dari penyedia identitas.
+ 0 \$1 SALAH: Pengemudi tidak berubah DbGroups.
Parameter ini bersifat opsional.
## group\$1federasi
+ **Nilai Default** - 0
+ **Tipe Data** - Boolean
Boolean yang menentukan apakah `getClusterCredentialsWithIAM` API digunakan untuk mendapatkan kredensil klaster sementara di klaster yang disediakan. Opsi ini memungkinkan pengguna IAM berintegrasi dengan peran database Redshift dalam cluster yang disediakan. Perhatikan bahwa opsi ini tidak berlaku untuk ruang nama Redshift Tanpa Server.
+ 1 \$1 BENAR: Driver menggunakan `getClusterCredentialsWithIAM` API untuk mendapatkan kredensyal cluster sementara di cluster yang disediakan.
+ 0 \$1 FALSE: Driver menggunakan `getClusterCredentials` API default untuk mendapatkan kredenal cluster sementara di cluster yang disediakan.
Parameter ini bersifat opsional.
## http\$1proxy\$1host
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama host atau alamat IP server proxy tempat Anda ingin melewati proses otentikasi IAM.
Parameter ini bersifat opsional.
## http\$1proxy\$1password
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Kata sandi yang Anda gunakan untuk mengakses server proxy. Ini digunakan untuk otentikasi IAM.
Parameter ini bersifat opsional.
## http\$1proxy\$1port
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - Integer
Jumlah port yang digunakan server proxy untuk mendengarkan koneksi klien. Ini digunakan untuk otentikasi IAM.
Parameter ini bersifat opsional.
## http\$1proxy\$1nama pengguna
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama pengguna yang Anda gunakan untuk mengakses server proxy. Ini digunakan untuk otentikasi IAM.
Parameter ini bersifat opsional.
## IAM
+ **Nilai Default** - 0
+ **Tipe Data** - Boolean
Boolean yang menentukan apakah driver menggunakan metode otentikasi IAM untuk mengautentikasi koneksi.
+ 1 \$1 BENAR: Driver menggunakan salah satu metode autentikasi IAM (menggunakan kunci akses dan secret key pair, atau profil, atau layanan kredensional).
+ 0 \$1 SALAH. Driver menggunakan otentikasi standar (menggunakan nama pengguna dan kata sandi database Anda).
Parameter ini bersifat opsional.
## idc\$1client\$1display\$1name
+ **Nilai Default** - Driver Amazon Redshift ODBC
+ **Tipe Data** - String
Nama tampilan yang akan digunakan untuk klien yang menggunakan BrowserIdcAuthPlugin.
Parameter ini bersifat opsional.
## idc\$1region
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
AWS Wilayah di mana instans AWS IAM Identity Center berada.
Parameter ini diperlukan hanya ketika mengautentikasi menggunakan `BrowserIdcAuthPlugin` dalam opsi konfigurasi plugin\$1name.
## idp\$1host
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Host IDP (penyedia identitas) yang Anda gunakan untuk mengautentikasi ke Amazon Redshift.
Parameter ini bersifat opsional.
## idp\$1port
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - Integer
Port untuk IDP (penyedia identitas) yang Anda gunakan untuk mengautentikasi ke Amazon Redshift. Bergantung pada port yang Anda pilih saat membuat, memodifikasi, atau memigrasi klaster, izinkan akses ke port yang dipilih.
Parameter ini bersifat opsional.
## idp\$1response\$1timeout
+ **Nilai Default** - 120
+ **Tipe Data** - Integer
Jumlah detik driver menunggu respons SAMP dari penyedia identitas saat menggunakan layanan SAMP atau Azure AD melalui plugin browser.
Parameter ini bersifat opsional.
## idp\$1penyewa
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
ID penyewa Azure AD yang terkait dengan aplikasi Amazon Redshift Anda.
Parameter ini diperlukan jika mengautentikasi melalui layanan Azure AD.
## idp\$1partisi
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Menentukan partisi cloud tempat penyedia identitas Anda (iDP) dikonfigurasi. Ini menentukan titik akhir otentikasi IDP mana yang terhubung ke driver.
Jika parameter ini dibiarkan kosong, driver default ke partisi komersial. Kemungkinan nilainya adalah:
+ `us-gov`: Gunakan nilai ini jika IDP Anda dikonfigurasi di Azure Government. Misalnya, Azure AD Government menggunakan `login.microsoftonline.us` endpoint.
+ `cn`: Gunakan nilai ini jika IDP Anda dikonfigurasi di partisi cloud Tiongkok. Misalnya, Azure AD Tiongkok menggunakan titik akhir. `login.chinacloudapi.cn`
Parameter ini bersifat opsional.
## idp\$1use\$1https\$1proxy
+ **Nilai Default** - 0
+ **Tipe Data** - Boolean
Boolean yang menentukan apakah driver melewati proses otentikasi untuk penyedia identitas (iDP) melalui server proxy.
+ 1 \$1 BENAR: Driver melewati proses otentikasi IDP melalui server proxy.
+ 0 \$1 SALAH. Driver tidak melewati proses otentikasi IDP melalui server proxy.
Parameter ini bersifat opsional.
## InstanceProfile
+ **Nilai Default** - 0
+ **Tipe Data** - Boolean
Boolean yang menentukan apakah driver menggunakan profil instans Amazon EC2, saat dikonfigurasi untuk menggunakan profil untuk otentikasi.
+ 1 \$1 BENAR: Driver menggunakan profil instans Amazon EC2.
+ 0 \$1 SALAH. Pengemudi menggunakan profil peran berantai yang ditentukan oleh opsi Nama Profil (**Profil**) sebagai gantinya.
Parameter ini bersifat opsional.
## issuer\$1url
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Menunjuk ke titik akhir instance server AWS IAM Identity Center.
Parameter ini diperlukan hanya ketika mengautentikasi menggunakan `BrowserIdcAuthPlugin` dalam opsi konfigurasi plugin\$1name.
## KeepAlive
+ **Nilai Default** - 1
+ **Tipe Data** - Boolean
Boolean yang menentukan apakah driver menggunakan TCP keepalives untuk mencegah koneksi dari timing out.
+ 1 \$1 BENAR: Driver menggunakan TCP keepalives untuk mencegah koneksi dari timing out.
+ 0 \$1 SALAH. Pengemudi tidak menggunakan keepalives TCP.
Parameter ini bersifat opsional.
## KeepAliveCount
+ **Nilai Default** - 0
+ **Tipe Data** - Integer
Jumlah paket TCP keepalive yang dapat hilang sebelum koneksi dianggap rusak. Ketika parameter ini diatur ke 0, driver menggunakan sistem default untuk pengaturan ini.
Parameter ini bersifat opsional.
## KeepAliveInterval
+ **Nilai Default** - 0
+ **Tipe Data** - Integer
Jumlah detik antara setiap transmisi ulang TCP keepalive. Ketika parameter ini diatur ke 0, driver menggunakan sistem default untuk pengaturan ini.
Parameter ini bersifat opsional.
## KeepAliveTime
+ **Nilai Default** - 0
+ **Tipe Data** - Integer
Jumlah detik tidak aktif sebelum driver mengirim paket TCP keepalive. Ketika parameter ini diatur ke 0, driver menggunakan sistem default untuk pengaturan ini.
Parameter ini bersifat opsional.
## listen\$1port
+ **Nilai Default** - 7890
+ **Tipe Data** - Integer
Port yang digunakan driver untuk menerima respons SAFL dari penyedia identitas atau kode otorisasi saat menggunakan layanan SAFL, Azure AD, atau AWS IAM Identity Center melalui plugin browser.
Parameter ini bersifat opsional.
## login\$1url
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
URL untuk sumber daya di situs web penyedia identitas saat menggunakan plugin Saml Browser generik.
Parameter ini diperlukan jika mengautentikasi dengan layanan SAMP atau Azure AD melalui plugin browser.
## loginToRp
+ **Nilai default** - urn:amazon:webservices
+ **Tipe Data** - String
Pihak yang mengandalkan percaya bahwa Anda ingin menggunakan untuk jenis otentikasi AD FS.
String ini opsional.
## LogLevel
+ **Nilai Default** - 0
+ **Tipe Data** - Integer
Gunakan properti ini untuk mengaktifkan atau menonaktifkan logging di driver dan untuk menentukan jumlah detail yang disertakan dalam log. file. Kami menyarankan Anda hanya mengaktifkan logging cukup lama untuk menangkap masalah, karena logging mengurangi kinerja dan dapat menghabiskan sejumlah besar ruang disk.
Atur properti ke salah satu nilai berikut:
+ 0: MATI. Nonaktifkan semua logging.
+ 1: KESALAHAN. Mencatat peristiwa kesalahan yang memungkinkan driver untuk terus berjalan tetapi menghasilkan kesalahan.
+ 2: API\$1CALL. Log panggilan fungsi API ODBC dengan nilai argumen fungsi.
+ 3: INFO. Log informasi umum yang menggambarkan kemajuan pengemudi.
+ 4: MSG\$1PROTOCOL. Log informasi rinci dari pesan pengemudi procotol.
+ 5: DEBUG. Mencatat semua aktivitas pengemudi
+ 6: DEBUG\$1APPEND. Terus tambahkan log untuk semua aktivitas pengemudi.
Saat logging diaktifkan, driver menghasilkan file log berikut di lokasi yang Anda tentukan di **LogPath**properti:
+ `redshift_odbc.log.1`File yang mencatat aktivitas driver yang terjadi selama jabat tangan koneksi.
+ `redshift_odbc.log`File untuk semua aktivitas driver setelah koneksi dibuat ke database.
Parameter ini bersifat opsional.
## LogPath
+ **Nilai Default** - Direktori TEMP khusus OS
+ **Tipe Data** - String
Jalur lengkap ke folder tempat driver menyimpan file log saat **LogLevel**lebih tinggi dari 0.
Parameter ini bersifat opsional.
## Min\$1tls
+ **Nilai Default** - 1.2
+ **Tipe Data** - String
Versi minimum dari driver TLS/SSL yang memungkinkan penyimpanan data untuk digunakan untuk mengenkripsi koneksi. Misalnya, jika TLS 1.2 ditentukan, TLS 1.1 tidak dapat digunakan untuk mengenkripsi koneksi.
Min\$1tls menerima nilai-nilai berikut:
+ 1.0: Koneksi harus menggunakan setidaknya TLS 1.0.
+ 1.1: Koneksi harus menggunakan setidaknya TLS 1.1.
+ 1.2: Koneksi harus menggunakan setidaknya TLS 1.2.
Parameter ini bersifat opsional.
## partner\$1spid
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nilai SPID mitra (ID penyedia layanan) yang akan digunakan saat mengautentikasi koneksi menggunakan layanan. PingFederate
Parameter ini bersifat opsional.
## Kata Sandi \$1 PWS
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Kata sandi yang sesuai dengan nama pengguna database yang Anda berikan di bidang User (**UID** \$1 **User** \$1 **LogonId**).
Parameter ini bersifat opsional.
## plugin\$1name
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama plugin penyedia kredensyal yang ingin Anda gunakan untuk otentikasi.
Nilai berikut didukung:
+ `ADFS`: Gunakan Layanan Federasi Direktori Aktif untuk otentikasi.
+ `AzureAD`: Gunakan Layanan Microsoft Azure Active Directory (AD) untuk otentikasi.
+ `BrowserAzureAD`: Gunakan plugin browser untuk Layanan Microsoft Azure Active Directory (AD) untuk otentikasi.
+ `BrowserIdcAuthPlugin `: Plugin otorisasi menggunakan AWS IAM Identity Center.
+ `BrowserSAML`: Gunakan plugin browser untuk layanan SAMP seperti Okta atau Ping untuk otentikasi.
+ `IdpTokenAuthPlugin`: Plugin otorisasi yang menerima token AWS IAM Identity Center atau OpenID Connect (OIDC) JSON berbasis token identitas (JWT) dari penyedia identitas web mana pun yang ditautkan ke IAM Identity Center. AWS
+ `JWT`: Gunakan JSON Web Token (JWT) untuk otentikasi.
+ `Ping`: Gunakan PingFederate layanan untuk otentikasi.
+ `Okta`: Gunakan layanan Okta untuk otentikasi.
Parameter ini bersifat opsional.
## Pelabuhan \$1 PortNumber
+ **Nilai default** - 5439
+ **Tipe Data** - Integer
Jumlah port TCP yang digunakan server Amazon Redshift untuk mendengarkan koneksi klien.
Parameter ini bersifat opsional.
## preferred\$1role
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Peran yang ingin Anda asumsikan selama koneksi ke Amazon Redshift. Ini digunakan untuk otentikasi IAM.
Parameter ini bersifat opsional.
## Profil
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama AWS profil pengguna yang digunakan untuk mengautentikasi ke Amazon Redshift.
+ Jika parameter Use Instance Profile (**InstanceProfile**properti) disetel ke 1 \$1 TRUE, setelan tersebut akan diutamakan dan driver menggunakan profil instans Amazon EC2 sebagai gantinya.
+ Lokasi default untuk file kredensyal yang berisi profil adalah. `~/.aws/Credentials` Variabel `AWS_SHARED_CREDENTIALS_FILE` lingkungan dapat digunakan untuk menunjuk ke file kredensyal yang berbeda.
Parameter ini bersifat opsional.
## provider\$1name
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Penyedia otentikasi yang dibuat oleh pengguna menggunakan kueri CREATE IDENTITY PROVIDER. Ini digunakan dalam otentikasi Amazon Redshift asli.
Parameter ini bersifat opsional.
## ProxyHost
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama host atau alamat IP dari server proxy yang ingin Anda sambungkan.
Parameter ini bersifat opsional.
## ProxyPort
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - Integer
Jumlah port yang digunakan server proxy untuk mendengarkan koneksi klien.
Parameter ini bersifat opsional.
## ProxyPwd
+ **Versi driver ValPrevious ODBC default** — Tidak ada
+ **Tipe Data** - String
Kata sandi yang Anda gunakan untuk mengakses server proxy.
Parameter ini bersifat opsional.
## ProxyUid
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama pengguna yang Anda gunakan untuk mengakses server proxy.
Parameter ini bersifat opsional.
## ReadOnly
+ **Nilai Default** - 0
+ **Tipe Data** - Boolean
Boolean yang menentukan apakah driver dalam mode read-only.
+ 1 \$1 BENAR: Koneksi dalam mode hanya-baca, dan tidak dapat menulis ke penyimpanan data.
+ 0 \$1 SALAH: Koneksi tidak dalam mode read-only, dan dapat menulis ke penyimpanan data.
Parameter ini bersifat opsional.
## region
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
AWS Wilayah tempat cluster Anda berada.
Parameter ini bersifat opsional.
## SecretAccessKey
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Kunci rahasia IAM untuk pengguna atau peran. Jika Anda mengatur parameter ini, Anda juga harus mengatur **AccessKeyID**.
Parameter ini bersifat opsional.
## SessionToken
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Token sesi IAM sementara yang terkait dengan peran IAM yang Anda gunakan untuk mengautentikasi.
Parameter ini bersifat opsional.
## Server \$1 HostName \$1 Tuan rumah
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Server endpoint untuk terhubung ke.
Parameter ini diperlukan.
## ssl\$1insecure
+ **Nilai Default** - 0
+ **Tipe Data** - Boolean
Boolean yang menentukan apakah driver memeriksa keaslian sertifikat server iDP.
+ 1 \$1 BENAR: Driver tidak memeriksa keaslian sertifikat server iDP.
+ 0 \$1 FALSE: Driver memeriksa keaslian sertifikat server iDP
Parameter ini bersifat opsional.
## SSLMode
+ **Nilai Default** - `verify-ca`
+ **Tipe Data** - String
Mode verifikasi sertifikat SSL untuk digunakan saat menghubungkan ke Amazon Redshift. Nilai-nilai berikut dimungkinkan:
+ `verify-full`: Connect hanya menggunakan SSL, otoritas sertifikat tepercaya, dan nama server yang cocok dengan sertifikat.
+ `verify-ca`: Connect hanya menggunakan SSL dan otoritas sertifikat tepercaya.
+ `require`: Connect hanya menggunakan SSL.
+ `prefer`: Connect menggunakan SSL jika tersedia. Jika tidak, sambungkan tanpa menggunakan SSL.
+ `allow`: Secara default, sambungkan tanpa menggunakan SSL. Jika server membutuhkan koneksi SSL, maka gunakan SSL.
+ `disable`: Connect tanpa menggunakan SSL.
Parameter ini bersifat opsional.
## StsConnectionTimeout
+ **Nilai Default** - 0
+ **Tipe Data** - Integer
Waktu tunggu maksimum untuk koneksi IAM, dalam hitungan detik. Jika disetel ke 0 atau tidak ditentukan, driver menunggu 60 detik untuk setiap AWS STS panggilan.
Parameter ini bersifat opsional.
## StsEndpointUrl
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Opsi ini menentukan endpoint utama yang digunakan untuk berkomunikasi dengan (). AWS Security Token Service AWS STS
Parameter ini bersifat opsional.
## token
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Pusat AWS Identitas IAM menyediakan token akses atau OpenID Connect (OIDC) JSON Web Token (JWT) yang disediakan oleh penyedia identitas web yang terhubung dengan IAM Identity Center. AWS Aplikasi Anda harus menghasilkan token ini dengan mengautentikasi pengguna aplikasi Anda dengan AWS IAM Identity Center atau penyedia identitas yang ditautkan dengan AWS IAM Identity Center.
Parameter ini bekerja dengan`IdpTokenAuthPlugin`.
## token\$1type
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Jenis token yang digunakan di`IdpTokenAuthPlugin`.
Anda dapat menentukan salah satu nilai berikut:
**ACCESS\$1TOKEN**
Masukkan ini jika Anda menggunakan token akses yang disediakan Pusat Identitas AWS IAM.
**EXT\$1JWT**
Masukkan ini jika Anda menggunakan OpenID Connect (OIDC) JSON Web Token (JWT) yang disediakan oleh penyedia identitas berbasis web yang terintegrasi dengan IAM Identity Center. AWS
Parameter ini bekerja dengan`IdpTokenAuthPlugin`.
## UID \$1 Pengguna \$1 LogonID
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Nama pengguna yang Anda gunakan untuk mengakses server Amazon Redshift.
Parameter ini diperlukan jika Anda menggunakan otentikasi database.
## UseUnicode
+ **Nilai Default** - 0
+ **Tipe Data** - Boolean
Boolean yang menentukan apakah driver mengembalikan data Redshift sebagai Unicode atau tipe SQL biasa.
+ 1 \$1 BENAR: Driver mengembalikan tipe SQL lebar untuk tipe data karakter.
+ SQL\$1WCHAR dikembalikan bukan SQL\$1CHAR.
+ SQL\$1WVARCHAR dikembalikan bukan SQL\$1VARCHAR.
+ SQL\$1WLONGVARCHAR dikembalikan bukan SQL\$1LONGVARCHAR.
+ 0 \$1 FALSE: Driver mengembalikan tipe SQL normal untuk tipe data karakter.
+ SQL\$1CHAR dikembalikan bukan SQL\$1WCHAR.
+ SQL\$1VARCHAR dikembalikan bukan SQL\$1WVARCHAR.
+ SQL\$1LONGVARCHAR dikembalikan bukan SQL\$1WLONGVARCHAR.
Parameter ini bersifat opsional. Ini tersedia dalam versi driver 2.1.15 dan yang lebih baru.
## web\$1identity\$1token
+ **Nilai Default** - Tidak Ada
+ **Tipe Data** - String
Token OAUTH yang disediakan oleh penyedia identitas. Ini digunakan dalam plugin JWT.
Parameter ini diperlukan jika Anda mengatur parameter **plugin\$1name** ke. BasicJwtCredentialsProvider
# Versi driver ODBC sebelumnya
Unduh versi driver Amazon Redshift ODBC versi 2.x sebelumnya hanya jika alat Anda memerlukan versi driver tertentu.
## Menggunakan versi driver ODBC sebelumnya untuk Microsoft Windows
Berikut ini adalah versi sebelumnya dari driver Amazon Redshift ODBC versi 2.x untuk Microsoft Windows:
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.14.0/AmazonRedshiftODBC64-2.1.14.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.14.0/AmazonRedshiftODBC64-2.1.14.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.13.0/AmazonRedshiftODBC64-2.1.13.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.13.0/AmazonRedshiftODBC64-2.1.13.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.12.0/AmazonRedshiftODBC64-2.1.12.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.12.0/AmazonRedshiftODBC64-2.1.12.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.11.0/AmazonRedshiftODBC64-2.1.11.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.11.0/AmazonRedshiftODBC64-2.1.11.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.10.0/AmazonRedshiftODBC64-2.1.10.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.10.0/AmazonRedshiftODBC64-2.1.10.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.9.0/AmazonRedshiftODBC64-2.1.9.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.9.0/AmazonRedshiftODBC64-2.1.9.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.9.0/AmazonRedshiftODBC64-2.1.9.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.9.0/AmazonRedshiftODBC64-2.1.9.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.8.0/AmazonRedshiftODBC64-2.1.8.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.8.0/AmazonRedshiftODBC64-2.1.8.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.7.0/AmazonRedshiftODBC64-2.1.7.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.7.0/AmazonRedshiftODBC64-2.1.7.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.6.0/AmazonRedshiftODBC64-2.1.6.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.6.0/AmazonRedshiftODBC64-2.1.6.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.4.0/AmazonRedshiftODBC64-2.1.4.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.4.0/AmazonRedshiftODBC64-2.1.4.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.3.0/AmazonRedshiftODBC64-2.1.3.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.3.0/AmazonRedshiftODBC64-2.1.3.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.2.0/AmazonRedshiftODBC64-2.1.2.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.2.0/AmazonRedshiftODBC64-2.1.2.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.1.0/AmazonRedshiftODBC64-2.1.1.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.1.0/AmazonRedshiftODBC64-2.1.1.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.0.0/AmazonRedshiftODBC64-2.1.0.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.0.0/AmazonRedshiftODBC64-2.1.0.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.1.0/AmazonRedshiftODBC64-2.0.1.0.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.1.0/AmazonRedshiftODBC64-2.0.1.0.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.11/AmazonRedshiftODBC64-2.0.0.11.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.11/AmazonRedshiftODBC64-2.0.0.11.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.9/AmazonRedshiftODBC64-2.0.0.9.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.9/AmazonRedshiftODBC64-2.0.0.9.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.8/AmazonRedshiftODBC64-2.0.0.8.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.8/AmazonRedshiftODBC64-2.0.0.8.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.7/AmazonRedshiftODBC64-2.0.0.7.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.7/AmazonRedshiftODBC64-2.0.0.7.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.6/AmazonRedshiftODBC64-2.0.0.6.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.6/AmazonRedshiftODBC64-2.0.0.6.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.5/AmazonRedshiftODBC64-2.0.0.5.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.5/AmazonRedshiftODBC64-2.0.0.5.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.3/AmazonRedshiftODBC64-2.0.0.3.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.3/AmazonRedshiftODBC64-2.0.0.3.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.1/AmazonRedshiftODBC64-2.0.0.1.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.1/AmazonRedshiftODBC64-2.0.0.1.msi)
## Gunakan versi driver ODBC sebelumnya untuk Linux
Berikut ini adalah versi sebelumnya dari driver Amazon Redshift ODBC versi 2.x untuk Linux:
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.14.0/AmazonRedshiftODBC-64-bit-2.1.14.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.14.0/AmazonRedshiftODBC-64-bit-2.1.14.0.x86_64.rpm) -64-bit-2.1.14.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.14.0/AmazonRedshiftODBC-64-bit-2.1.14.0.aarch64.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.14.0/AmazonRedshiftODBC-64-bit-2.1.14.0.aarch64.rpm)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.13.0/AmazonRedshiftODBC-64-bit-2.1.13.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.13.0/AmazonRedshiftODBC-64-bit-2.1.13.0.x86_64.rpm) -64-bit-2.1.13.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.13.0/AmazonRedshiftODBC-64-bit-2.1.13.0.aarch64.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.13.0/AmazonRedshiftODBC-64-bit-2.1.13.0.aarch64.rpm)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.12.0/AmazonRedshiftODBC-64-bit-2.1.12.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.12.0/AmazonRedshiftODBC-64-bit-2.1.12.0.x86_64.rpm) -64-bit-2.1.12.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.12.0/AmazonRedshiftODBC-64-bit-2.1.12.0.aarch64.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.12.0/AmazonRedshiftODBC-64-bit-2.1.12.0.aarch64.rpm)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.11.0/AmazonRedshiftODBC-64-bit-2.1.11.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.11.0/AmazonRedshiftODBC-64-bit-2.1.11.0.x86_64.rpm) -64-bit-2.1.11.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.11.0/AmazonRedshiftODBC-64-bit-2.1.11.0.aarch64.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.11.0/AmazonRedshiftODBC-64-bit-2.1.11.0.aarch64.rpm)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.10.0/AmazonRedshiftODBC-64-bit-2.1.10.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.10.0/AmazonRedshiftODBC-64-bit-2.1.10.0.x86_64.rpm) -64-bit-2.1.10.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.9.0/AmazonRedshiftODBC-64-bit-2.1.9.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.9.0/AmazonRedshiftODBC-64-bit-2.1.9.0.x86_64.rpm) -64-bit-2.1.9.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.8.0/AmazonRedshiftODBC-64-bit-2.1.8.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.8.0/AmazonRedshiftODBC-64-bit-2.1.8.0.x86_64.rpm) -64-bit-2.1.8.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.7.0/AmazonRedshiftODBC-64-bit-2.1.7.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.7.0/AmazonRedshiftODBC-64-bit-2.1.7.0.x86_64.rpm) -64-bit-2.1.7.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.6.0/AmazonRedshiftODBC-64-bit-2.1.6.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.6.0/AmazonRedshiftODBC-64-bit-2.1.6.0.x86_64.rpm) -64-bit-2.1.6.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.4.0/AmazonRedshiftODBC-64-bit-2.1.4.0.x86\$164.rpm Di Wilayah Tiongkok](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.4.0/AmazonRedshiftODBC-64-bit-2.1.4.0.x86_64.rpm)-64-bit-2.1.4.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.3.0/AmazonRedshiftODBC-64-bit-2.1.3.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.3.0/AmazonRedshiftODBC-64-bit-2.1.3.0.x86_64.rpm) -64-bit-2.1.3.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.2.0/AmazonRedshiftODBC-64-bit-2.1.2.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.2.0/AmazonRedshiftODBC-64-bit-2.1.2.0.x86_64.rpm) -64-bit-2.1.2.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.1.0/AmazonRedshiftODBC-64-bit-2.1.1.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.1.0/AmazonRedshiftODBC-64-bit-2.1.1.0.x86_64.rpm) -64-bit-2.1.1.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.0.0/AmazonRedshiftODBC-64-bit-2.1.0.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.0.0/AmazonRedshiftODBC-64-bit-2.1.0.0.x86_64.rpm) -64-bit-2.1.0.0.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.1.0/AmazonRedshiftODBC-64-bit-2.0.1.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.1.0/AmazonRedshiftODBC-64-bit-2.0.1.0.x86_64.rpm) [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.1.0/AmazonRedshiftODBC-64-bit-2.0.1.0.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.1.0/AmazonRedshiftODBC-64-bit-2.0.1.0.x86_64.rpm)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.11/AmazonRedshiftODBC-64-bit-2.0.0.11.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.11/AmazonRedshiftODBC-64-bit-2.0.0.11.x86_64.rpm) [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.11/AmazonRedshiftODBC-64-bit-2.0.0.11.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.11/AmazonRedshiftODBC-64-bit-2.0.0.11.x86_64.rpm)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.9/AmazonRedshiftODBC-64-bit-2.0.0.9.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.9/AmazonRedshiftODBC-64-bit-2.0.0.9.x86_64.rpm) [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.9/AmazonRedshiftODBC-64-bit-2.0.0.9.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.9/AmazonRedshiftODBC-64-bit-2.0.0.9.x86_64.rpm)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.8/AmazonRedshiftODBC-64-bit-2.0.0.8.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.8/AmazonRedshiftODBC-64-bit-2.0.0.8.x86_64.rpm) [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.8/AmazonRedshiftODBC-64-bit-2.0.0.8.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.8/AmazonRedshiftODBC-64-bit-2.0.0.8.x86_64.rpm)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.7/AmazonRedshiftODBC-64-bit-2.0.0.7.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.7/AmazonRedshiftODBC-64-bit-2.0.0.7.x86_64.rpm) [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.7/AmazonRedshiftODBC-64-bit-2.0.0.7.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.7/AmazonRedshiftODBC-64-bit-2.0.0.7.x86_64.rpm)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.6/AmazonRedshiftODBC-64-bit-2.0.0.6.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.6/AmazonRedshiftODBC-64-bit-2.0.0.6.x86_64.rpm) [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.6/AmazonRedshiftODBC-64-bit-2.0.0.6.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.6/AmazonRedshiftODBC-64-bit-2.0.0.6.x86_64.rpm)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.5/AmazonRedshiftODBC-64-bit-2.0.0.5.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.5/AmazonRedshiftODBC-64-bit-2.0.0.5.x86_64.rpm) [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.5/AmazonRedshiftODBC-64-bit-2.0.0.5.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.5/AmazonRedshiftODBC-64-bit-2.0.0.5.x86_64.rpm)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.3/AmazonRedshiftODBC-64-bit-2.0.0.3.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.3/AmazonRedshiftODBC-64-bit-2.0.0.3.x86_64.rpm) [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.3/AmazonRedshiftODBC-64-bit-2.0.0.3.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.3/AmazonRedshiftODBC-64-bit-2.0.0.3.x86_64.rpm)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.1/AmazonRedshiftODBC-64-bit-2.0.0.1.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.1/AmazonRedshiftODBC-64-bit-2.0.0.1.x86_64.rpm) [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.1/AmazonRedshiftODBC-64-bit-2.0.0.1.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.0.0.1/AmazonRedshiftODBC-64-bit-2.0.0.1.x86_64.rpm)
## Menggunakan versi driver ODBC sebelumnya untuk Apple macOS
Berikut ini adalah versi sebelumnya dari driver Amazon Redshift ODBC versi 2.x untuk Apple macOS:
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.14.0/AmazonRedshiftODBC-64-bit.2.1.14.0.universal.pkg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.14.0/AmazonRedshiftODBC-64-bit.2.1.14.0.universal.pkg)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.13.0/AmazonRedshiftODBC-64-bit.2.1.13.0.universal.pkg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.13.0/AmazonRedshiftODBC-64-bit.2.1.13.0.universal.pkg)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.12.0/AmazonRedshiftODBC-64-bit.2.1.12.0.universal.pkg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/2.1.12.0/AmazonRedshiftODBC-64-bit.2.1.12.0.universal.pkg)
# Mengkonfigurasi koneksi driver ODBC versi 1.x
Anda dapat menggunakan koneksi ODBC untuk terhubung ke klaster Amazon Redshift Anda dari banyak alat dan aplikasi klien SQL pihak ketiga. Untuk melakukan ini, atur koneksi di komputer klien Anda atau instans Amazon EC2. Jika alat klien Anda mendukung JDBC, Anda mungkin memilih untuk menggunakan jenis koneksi itu daripada ODBC karena kemudahan konfigurasi yang disediakan JDBC. Namun, jika alat klien Anda tidak mendukung JDBC, ikuti langkah-langkah di bagian ini untuk mengonfigurasi koneksi ODBC.
Amazon Redshift menyediakan driver ODBC 64-bit untuk sistem operasi Linux, Windows, dan macOS X. Driver ODBC 32-bit dihentikan. Pembaruan lebih lanjut tidak akan dirilis, kecuali untuk patch keamanan yang mendesak.
[Untuk informasi terbaru tentang fungsionalitas dan prasyarat driver ODBC, lihat catatan rilis driver Amazon Redshift ODBC.](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Release+Notes.pdf)
Untuk informasi penginstalan dan konfigurasi untuk driver Amazon Redshift ODBC, lihat panduan pemasangan dan konfigurasi konektor [Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
**Topics**
+ [Mendapatkan URL ODBC](obtain-odbc-url.md)
+ [Menggunakan driver Amazon Redshift ODBC di Microsoft Windows](install-odbc-driver-windows.md)
+ [Menggunakan driver Amazon Redshift ODBC di Linux](install-odbc-driver-linux.md)
+ [Menggunakan driver Amazon Redshift ODBC di macOS X](install-odbc-driver-mac.md)
+ [Opsi driver ODBC](configure-odbc-options.md)
+ [Versi driver ODBC sebelumnya](odbc-previous-versions.md)
# Mendapatkan URL ODBC
Amazon Redshift menampilkan URL ODBC untuk klaster Anda di konsol Amazon Redshift. URL ini berisi informasi untuk mengatur koneksi antara komputer klien Anda dan database.
URL ODBC memiliki format berikut: `Driver={driver};Server=endpoint;Database=database_name;UID=user_name;PWD=password;Port=port_number`
Bidang format yang ditunjukkan sebelumnya memiliki nilai berikut.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/obtain-odbc-url.html)
Bidang dalam tabel sebelumnya dapat berisi karakter khusus berikut:
```
[]{}(),;?*=!@
```
Jika Anda menggunakan karakter khusus ini, Anda harus melampirkan nilainya dalam kurung kurawal. Misalnya, nilai kata sandi `Your;password123` dalam string koneksi direpresentasikan sebagai`PWD={Your;password123};`.
Karena `Field=value` pasangan dipisahkan oleh titik koma, kombinasi `}` dan `;` dengan sejumlah spasi di antaranya dianggap sebagai akhir dari pasangan. `Field={value};` Kami menyarankan Anda menghindari urutan `};` dalam nilai bidang Anda. Misalnya, jika Anda menetapkan nilai kata sandi Anda sebagai`PWD={This is a passwor} ;d};`, kata sandi Anda akan menjadi `This is a passwor} ;` dan URL akan error.
Berikut ini adalah contoh URL ODBC.
```
Driver={Amazon Redshift (x64)};
Server=examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com;
Database=dev;
UID=adminuser;
PWD=insert_your_admin_user_password_here;
Port=5439
```
Untuk informasi tentang cara mendapatkan koneksi ODBC Anda, lihat[Menemukan string koneksi cluster Anda](connecting-connection-string.md).
# Menggunakan driver Amazon Redshift ODBC di Microsoft Windows
Anda menginstal driver Amazon Redshift ODBC di komputer klien yang mengakses gudang data Amazon Redshift. Setiap komputer tempat Anda menginstal driver harus memenuhi daftar persyaratan sistem minimum. Untuk informasi tentang persyaratan sistem minimum, lihat panduan [pemasangan dan konfigurasi konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
**Topics**
+ [Mengunduh dan menginstal driver Amazon Redshift ODBC](odbc-driver-windows-how-to-install.md)
+ [Membuat entri DSN sistem untuk koneksi ODBC](create-dsn-odbc-windows.md)
# Mengunduh dan menginstal driver Amazon Redshift ODBC
Gunakan prosedur berikut untuk mengunduh driver Amazon Redshift ODBC untuk sistem operasi Windows. Hanya gunakan driver selain ini jika Anda menjalankan aplikasi pihak ketiga yang disertifikasi untuk digunakan dengan Amazon Redshift dan yang memerlukan driver tertentu.
**Untuk menginstal driver ODBC**
1. Unduh salah satu dari berikut ini, tergantung pada arsitektur sistem alat atau aplikasi klien SQL Anda:
+ [64-bit ODBC driver versi 1.6.3](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/AmazonRedshiftODBC64-1.6.3.1008.msi) driver versi 1.6.3.
Nama driver ini adalah Amazon Redshift (x64).
+ [32-bit ODBC driver versi 1.4.52 Di AWS](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.52.1000/AmazonRedshiftODBC32-1.4.52.1000.msi) [ 32-bit ODBC driver versi 1.4.52](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/drivers/odbc/1.4.52.1000/AmazonRedshiftODBC32-1.4.52.1000.msi)
Nama driver ini adalah Amazon Redshift (x86). Driver ODBC 32-bit dihentikan. Pembaruan lebih lanjut tidak akan dirilis, kecuali untuk patch keamanan yang mendesak.
**catatan**
Unduh paket MSI yang sesuai dengan arsitektur sistem alat atau aplikasi klien SQL Anda. Misalnya, jika alat klien SQL Anda 64-bit, instal driver 64-bit.
Kemudian unduh dan tinjau perjanjian [SIM Amazon Redshift ODBC dan JDBC](https://s3.amazonaws.com/redshift-downloads/drivers/Amazon+Redshift+ODBC+and+JDBC+Driver+License+Agreement.pdf).
1. Klik dua kali file.msi, lalu ikuti langkah-langkah di wizard untuk menginstal driver.
# Membuat entri DSN sistem untuk koneksi ODBC
Setelah Anda mengunduh dan menginstal driver ODBC, tambahkan entri nama sumber data (DSN) ke komputer klien atau instans Amazon EC2. Alat klien SQL menggunakan sumber data ini untuk terhubung ke database Amazon Redshift.
Kami menyarankan Anda membuat sistem DSN bukan DSN pengguna. Beberapa aplikasi memuat data menggunakan akun pengguna yang berbeda. Aplikasi ini mungkin tidak dapat mendeteksi pengguna DSNs yang dibuat di bawah akun pengguna lain.
**catatan**
Untuk autentikasi menggunakan kredensial AWS Identity and Access Management (IAM) atau kredensial penyedia identitas (iDP), diperlukan langkah-langkah tambahan. Untuk informasi selengkapnya, lihat [Langkah 5: Konfigurasikan koneksi JDBC atau ODBC untuk menggunakan kredensil IAM](generating-iam-credentials-steps.md#generating-iam-credentials-configure-jdbc-odbc).
Untuk informasi tentang cara membuat entri DSN sistem, lihat panduan [pemasangan dan konfigurasi konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
**Untuk membuat entri DSN sistem untuk koneksi ODBC pada Windows**
1. Di menu **Start**, buka **Sumber Data ODBC**.
Pastikan Anda memilih Administrator Sumber Data ODBC yang memiliki bitness yang sama dengan aplikasi klien yang Anda gunakan untuk terhubung ke Amazon Redshift.
1. Di **Administrator Sumber Data ODBC**, pilih tab **Driver** dan cari folder driver:
+ **Driver Amazon Redshift ODBC (64-bit)**
+ **Driver Amazon Redshift ODBC (32-bit)**
1. Pilih tab **DSN Sistem** untuk mengonfigurasi driver untuk semua pengguna di komputer, atau tab **DSN Pengguna** untuk mengonfigurasi driver hanya untuk akun pengguna Anda.
1. Pilih **Tambahkan**. Jendela **Create New Data Source** terbuka.
1. **Pilih driver **Amazon Redshift** ODBC, lalu pilih Selesai.** Jendela **Pengaturan DSN Driver Amazon Redshift ODBC** terbuka.
1. Di bawah **Pengaturan Koneksi**, masukkan informasi berikut:
**Nama sumber data**
Masukkan sebuah nama untuk sumber data. Anda dapat menggunakan nama apa pun yang ingin Anda identifikasi sumber data nanti saat Anda membuat koneksi ke cluster. Misalnya, jika Anda mengikuti *Panduan Memulai Amazon Redshift*, Anda dapat mengetik `exampleclusterdsn` agar mudah mengingat cluster yang Anda kaitkan dengan DSN ini.
**Server**
Tentukan titik akhir untuk cluster Amazon Redshift Anda. Anda dapat menemukan informasi ini di konsol Amazon Redshift di halaman detail cluster. Untuk informasi selengkapnya, lihat [Mengonfigurasi koneksi di Amazon Redshift](configuring-connections.md).
**Port**
Masukkan nomor port yang digunakan database. Gunakan port yang cluster dikonfigurasi untuk digunakan ketika diluncurkan atau dimodifikasi.
**Basis Data**
Masukkan nama database Amazon Redshift. Jika Anda meluncurkan cluster Anda tanpa menentukan nama database, masukkan`dev`. Jika tidak, gunakan nama yang Anda pilih selama proses peluncuran. Jika Anda mengikuti *Panduan Memulai Amazon Redshift, masukkan*. `dev`
1. Di bawah **Otentikasi**, tentukan opsi konfigurasi untuk mengonfigurasi otentikasi standar atau IAM. Untuk informasi tentang opsi otentikasi, lihat “Mengonfigurasi Otentikasi di Windows” di Panduan Pemasangan dan Konfigurasi *Konektor Amazon Redshift ODBC*.
1. Di bawah **Pengaturan SSL**, tentukan nilai untuk hal berikut:
**Otentikasi SSL**
Pilih mode untuk menangani Secure Sockets Layer (SSL). Dalam lingkungan pengujian, Anda mungkin menggunakan`prefer`. Namun, untuk lingkungan produksi dan ketika pertukaran data yang aman diperlukan, gunakan `verify-ca` atau`verify-full`. Untuk informasi selengkapnya tentang penggunaan SSL di Windows, lihat “Mengonfigurasi Verifikasi SSL di Windows” di Panduan Pemasangan dan Konfigurasi *Konektor Amazon Redshift ODBC*.
1. Di bawah **Opsi Tambahan**, tentukan opsi tentang cara mengembalikan hasil kueri ke alat atau aplikasi klien SQL Anda. Untuk informasi selengkapnya, lihat “Mengonfigurasi Opsi Tambahan di Windows” di Panduan *Pemasangan dan Konfigurasi Konektor Amazon Redshift ODBC*.
1. Di **Opsi Logging**, tentukan nilai untuk opsi logging. Untuk informasi selengkapnya, lihat “Mengonfigurasi Opsi Pencatatan di Windows” di Panduan *Pemasangan dan Konfigurasi Konektor Amazon Redshift ODBC*.
Lalu pilih **OK**.
1. Di bawah **Opsi Tipe Data**, tentukan nilai untuk tipe data. Untuk informasi selengkapnya, lihat “Mengonfigurasi Opsi Jenis Data di Windows” di Panduan *Pemasangan dan Konfigurasi Konektor Amazon Redshift ODBC*.
Lalu pilih **OK**.
1. Pilih **Uji**. Jika komputer klien dapat terhubung ke database Amazon Redshift, Anda melihat pesan berikut: **Koneksi** berhasil.
Jika komputer klien gagal terhubung ke database, Anda dapat memecahkan masalah yang mungkin terjadi. Untuk informasi selengkapnya, lihat [Memecahkan masalah koneksi di Amazon Redshift](troubleshooting-connections.md).
1. Konfigurasikan keepalives TCP di Windows untuk mencegah koneksi dari waktu habis. Untuk informasi tentang cara mengonfigurasi keepalives TCP di Windows, lihat Panduan Pemasangan dan Konfigurasi Konektor *Amazon Redshift ODBC*.
1. Untuk membantu pemecahan masalah, konfigurasikan logging. Untuk informasi tentang cara mengonfigurasi logging di Windows, lihat Panduan *Instalasi dan Konfigurasi Konektor Amazon Redshift ODBC*.
# Menggunakan driver Amazon Redshift ODBC di Linux
Anda menginstal driver Amazon Redshift ODBC di komputer klien yang mengakses gudang data Amazon Redshift. Setiap komputer tempat Anda menginstal driver harus memenuhi daftar persyaratan sistem minimum. Untuk informasi tentang persyaratan sistem minimum, lihat panduan [pemasangan dan konfigurasi konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
**Topics**
+ [Mengunduh dan menginstal driver Amazon Redshift ODBC](odbc-driver-linux-how-to-install.md)
+ [Menggunakan manajer driver ODBC untuk mengkonfigurasi driver](odbc-driver-configure-linux.md)
# Mengunduh dan menginstal driver Amazon Redshift ODBC
Gunakan langkah-langkah di bagian ini untuk mengunduh dan menginstal driver Amazon Redshift ODBC pada distribusi Linux yang didukung. Proses instalasi menginstal file driver di direktori berikut:
+ `/opt/amazon/redshiftodbc/lib/64`(untuk driver 64-bit)
+ `/opt/amazon/redshiftodbc/ErrorMessages`
+ `/opt/amazon/redshiftodbc/Setup`
+ `/opt/amazon/redshiftodbc/lib/32`(untuk driver 32-bit)
**Untuk menginstal driver Amazon Redshift ODBC**
1. Unduh salah satu dari berikut ini, tergantung pada arsitektur sistem alat atau aplikasi klien SQL Anda:
+ [Versi driver RPM 64-bit 1.6.3](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/AmazonRedshiftODBC-64-bit-1.6.3.1008-1.x86_64.rpm) versi 1.6.3.
+ [64-bit Debian driver versi 1.6.3](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/AmazonRedshiftODBC-64-bit-1.6.3.1008-1.x86_64.deb) versi 1.6.3.
+ [Versi driver 32-bit 1.4.52 versi 1.6.3.](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.52.1000/AmazonRedshiftODBC-32-bit-1.4.52.1000-1.i686.rpm)
Nama untuk masing-masing driver ini adalah driver Amazon Redshift ODBC. Driver ODBC 32-bit dihentikan. Pembaruan lebih lanjut tidak akan dirilis, kecuali untuk patch keamanan yang mendesak.
**catatan**
Unduh paket yang sesuai dengan arsitektur sistem alat atau aplikasi klien SQL Anda. Misalnya, jika alat klien Anda 64-bit, instal driver 64-bit.
Kemudian unduh dan tinjau perjanjian [SIM Amazon Redshift ODBC dan JDBC](https://s3.amazonaws.com/redshift-downloads/drivers/Amazon+Redshift+ODBC+and+JDBC+Driver+License+Agreement.pdf).
1. Pergi ke lokasi di mana Anda mengunduh paket, dan kemudian jalankan salah satu perintah berikut. Gunakan perintah yang sesuai dengan distribusi Linux Anda.
+ Pada sistem operasi RHEL dan CentOS, jalankan perintah berikut.
```
yum -nogpgcheck localinstall RPMFileName
```
Ganti *`RPMFileName`* dengan nama file paket RPM. Misalnya, perintah berikut menunjukkan menginstal driver 64-bit.
```
yum -nogpgcheck localinstall AmazonRedshiftODBC-64-bit-1.x.xx.xxxx-x.x86_64.rpm
```
+ Pada SLES, jalankan perintah berikut.
```
zypper install RPMFileName
```
Ganti *`RPMFileName`* dengan nama file paket RPM. Misalnya, perintah berikut menunjukkan menginstal driver 64-bit.
```
zypper install AmazonRedshiftODBC-1.x.x.xxxx-x.x86_64.rpm
```
+ Pada Debian, jalankan perintah berikut.
```
sudo apt install ./DEBFileName.deb
```
Ganti `DEBFileName.deb` dengan nama file paket Debian. Misalnya, perintah berikut menunjukkan menginstal driver 64-bit.
```
sudo apt install ./AmazonRedshiftODBC-1.x.x.xxxx-x.x86_64.deb
```
**penting**
Setelah Anda selesai menginstal driver, konfigurasikan untuk digunakan pada sistem Anda. Untuk informasi selengkapnya tentang konfigurasi driver, lihat[Menggunakan manajer driver ODBC untuk mengkonfigurasi driverMenggunakan manajer driver ODBC untuk mengkonfigurasi driver](odbc-driver-configure-linux.md).
# Menggunakan manajer driver ODBC untuk mengkonfigurasi driver
Pada sistem operasi Linux, Anda menggunakan manajer driver ODBC untuk mengonfigurasi pengaturan koneksi ODBC. Manajer driver ODBC menggunakan file konfigurasi untuk menentukan dan mengkonfigurasi sumber data dan driver ODBC. Manajer driver ODBC yang Anda gunakan bergantung pada sistem operasi yang Anda gunakan. Untuk Linux, ini adalah manajer driver UnixODBC.
Untuk informasi selengkapnya tentang manajer driver ODBC yang didukung untuk mengonfigurasi driver Amazon Redshift ODBC, [Menggunakan driver Amazon Redshift ODBC di LinuxMenggunakan driver ODBC di Linux](install-odbc-driver-linux.md) lihat untuk sistem operasi Linux. Juga, lihat “Menentukan Manajer Driver ODBC di Mesin Non-Windows” di panduan pemasangan dan [konfigurasi konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
Tiga file diperlukan untuk mengonfigurasi driver Amazon Redshift ODBC`amazon.redshiftodbc.ini`:`odbc.ini`,, dan. `odbcinst.ini`
Jika Anda menginstal ke lokasi default, file `amazon.redshiftodbc.ini` konfigurasi terletak di salah satu direktori berikut:
+ `/opt/amazon/redshiftodbc/lib/64`(untuk driver 64-bit pada sistem operasi Linux)
+ `/opt/amazon/redshiftodbc/lib/32`(untuk driver 32-bit pada sistem operasi Linux)
Selain itu, `/opt/amazon/redshiftodbc/Setup` di Linux, ada sampel `odbc.ini` dan `odbcinst.ini` file. Anda dapat menggunakan file-file ini sebagai contoh untuk mengonfigurasi driver Amazon Redshift ODBC dan nama sumber data (DSN).
Kami tidak menyarankan menggunakan direktori instalasi driver Amazon Redshift ODBC untuk file konfigurasi. File sampel dalam `Setup` direktori hanya untuk tujuan contoh. Jika Anda menginstal ulang driver Amazon Redshift ODBC di lain waktu, atau meningkatkan ke versi yang lebih baru, direktori instalasi akan ditimpa. Anda kemudian kehilangan perubahan apa pun yang mungkin Anda buat pada file-file itu.
Untuk menghindari hal ini, salin `amazon.redshiftodbc.ini` file ke direktori selain direktori instalasi. Jika Anda menyalin file ini ke direktori home pengguna, tambahkan titik (.) ke awal nama file untuk menjadikannya file tersembunyi.
Untuk `odbcinst.ini` file `odbc.ini` dan, gunakan file konfigurasi di direktori home pengguna atau buat versi baru di direktori lain. Secara default, sistem operasi Linux Anda harus memiliki `odbc.ini` file dan `odbcinst.ini` file di direktori home pengguna (`/home/$USER`atau`~/`.). File default ini adalah file tersembunyi, yang ditunjukkan oleh titik (.) di depan setiap nama file. File-file ini hanya ditampilkan ketika Anda menggunakan `-a` bendera untuk daftar isi direktori.
Opsi apa pun yang Anda pilih untuk `odbcinst.ini` file `odbc.ini` dan, ubah file untuk menambahkan informasi konfigurasi driver dan DSN. Jika Anda membuat file baru, Anda juga perlu mengatur variabel lingkungan untuk menentukan di mana file konfigurasi ini berada.
Secara default, manajer driver ODBC dikonfigurasi untuk menggunakan versi tersembunyi dari file `odbc.ini` dan `odbcinst.ini` konfigurasi (bernama. `odbc.ini`dan. `odbcinst.ini`) terletak di direktori home. Mereka juga dikonfigurasi untuk menggunakan `amazon.redshiftodbc.ini` file di `/lib` subfolder direktori instalasi driver. Jika Anda menyimpan file konfigurasi ini di tempat lain, atur variabel lingkungan yang dijelaskan berikut sehingga manajer driver dapat menemukan file. Untuk informasi selengkapnya, lihat “Menentukan Lokasi File Konfigurasi Driver” di panduan [pemasangan dan konfigurasi konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
## Membuat nama sumber data pada sistem operasi Linux
Saat menghubungkan ke penyimpanan data Anda menggunakan nama sumber data (DSN), konfigurasikan `odbc.ini` file yang akan ditentukan DSNs. Tetapkan properti dalam `odbc.ini` file untuk membuat DSN yang menentukan informasi koneksi untuk penyimpanan data Anda.
Untuk informasi tentang cara mengonfigurasi `odbc.ini` file, lihat “Membuat Nama Sumber Data pada Mesin Non-Windows” di panduan [pemasangan dan konfigurasi konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf) ODBC
Gunakan format berikut pada sistem operasi Linux.
```
[ODBC Data Sources]
driver_name=dsn_name
[dsn_name]
Driver=path/driver_file
Host=cluster_endpoint
Port=port_number
Database=database_name
locale=locale
```
Contoh berikut menunjukkan konfigurasi untuk odbc.ini dengan driver ODBC 64-bit pada sistem operasi Linux.
```
[ODBC Data Sources]
Amazon_Redshift_x64=Amazon Redshift (x64)
[Amazon Redshift (x64)]
Driver=/opt/amazon/redshiftodbc/lib/64/libamazonredshiftodbc64.so
Host=examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com
Port=5932
Database=dev
locale=en-US
```
Contoh berikut menunjukkan konfigurasi untuk odbc.ini dengan driver ODBC 32-bit pada sistem operasi Linux.
```
[ODBC Data Sources]
Amazon_Redshift_x32=Amazon Redshift (x86)
[Amazon Redshift (x86)]
Driver=/opt/amazon/redshiftodbc/lib/32/libamazonredshiftodbc32.so
Host=examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com
Port=5932
Database=dev
locale=en-US
```
## Mengkonfigurasi koneksi tanpa DSN pada sistem operasi Linux
Untuk terhubung ke penyimpanan data Anda melalui koneksi yang tidak memiliki DSN, tentukan driver dalam `odbcinst.ini` file. Kemudian berikan string koneksi tanpa DSN di aplikasi Anda.
Untuk informasi tentang cara mengonfigurasi `odbcinst.ini` file dalam kasus ini, lihat “Mengonfigurasi Koneksi Tanpa DSN pada Mesin Non-Windows” di panduan pemasangan dan konfigurasi konektor Amazon Redshift [ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
Gunakan format berikut pada sistem operasi Linux.
```
[ODBC Drivers]
driver_name=Installed
...
[driver_name]
Description=driver_description
Driver=path/driver_file
...
```
Contoh berikut menunjukkan `odbcinst.ini` konfigurasi untuk driver 64-bit yang diinstal di direktori default pada sistem operasi Linux.
```
[ODBC Drivers]
Amazon Redshift (x64)=Installed
[Amazon Redshift (x64)]
Description=Amazon Redshift ODBC Driver (64-bit)
Driver=/opt/amazon/redshiftodbc/lib/64/libamazonredshiftodbc64.so
```
Contoh berikut menunjukkan `odbcinst.ini` konfigurasi untuk driver 32-bit yang diinstal di direktori default pada sistem operasi Linux.
```
[ODBC Drivers]
Amazon Redshift (x86)=Installed
[Amazon Redshift (x86)]
Description=Amazon Redshift ODBC Driver (32-bit)
Driver=/opt/amazon/redshiftodbc/lib/32/libamazonredshiftodbc32.so
```
## Mengonfigurasi variabel lingkungan
Gunakan manajer driver ODBC yang benar untuk memuat driver yang benar. Untuk melakukan ini, atur variabel lingkungan jalur perpustakaan. Untuk informasi selengkapnya, lihat “Menentukan Manajer Driver ODBC di Mesin Non-Windows” di panduan pemasangan dan konfigurasi [konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
Secara default, manajer driver ODBC dikonfigurasi untuk menggunakan versi tersembunyi dari file `odbc.ini` dan `odbcinst.ini` konfigurasi (bernama. `odbc.ini`dan. `odbcinst.ini`) terletak di direktori home. Mereka juga dikonfigurasi untuk menggunakan `amazon.redshiftodbc.ini` file di `/lib` subfolder direktori instalasi driver. Jika Anda menyimpan file konfigurasi ini di tempat lain, variabel lingkungan sehingga manajer driver dapat menemukan file. Untuk informasi selengkapnya, lihat “Menentukan Lokasi File Konfigurasi Driver” di Panduan *Pemasangan dan Konfigurasi Konektor Amazon Redshift ODBC*.
## Mengkonfigurasi fitur koneksi
Anda dapat mengonfigurasi fitur koneksi berikut untuk pengaturan ODBC Anda:
+ Konfigurasikan driver ODBC untuk memberikan kredensi dan mengautentikasi koneksi ke database Amazon Redshift.
+ Konfigurasikan driver ODBC untuk menyambung ke soket yang diaktifkan dengan Secure Sockets Layer (SSL), jika Anda terhubung ke server Amazon Redshift yang mengaktifkan SSL.
+ Konfigurasikan driver ODBC untuk terhubung ke Amazon Redshift melalui server proxy.
+ Konfigurasikan driver ODBC untuk menggunakan mode pemrosesan kueri untuk mencegah kueri menghabiskan terlalu banyak memori.
+ Konfigurasikan driver ODBC untuk meneruskan proses otentikasi IAM melalui server proxy.
+ Konfigurasikan driver ODBC untuk menggunakan keepalives TCP untuk mencegah koneksi dari waktu habis.
Untuk informasi tentang fitur koneksi ini, lihat panduan [pemasangan dan konfigurasi konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
# Menggunakan driver Amazon Redshift ODBC di macOS X
Anda menginstal driver di komputer klien yang mengakses gudang data Amazon Redshift. Setiap komputer tempat Anda menginstal driver harus memenuhi daftar persyaratan sistem minimum. Untuk informasi tentang persyaratan sistem minimum, lihat panduan [pemasangan dan konfigurasi konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
**Topics**
+ [Mengunduh dan menginstal driver Amazon Redshift ODBC](odbc-driver-mac-how-to-install.md)
+ [Gunakan manajer driver ODBC untuk mengonfigurasi driver](odbc-driver-configure-mac.md)
# Mengunduh dan menginstal driver Amazon Redshift ODBC
Gunakan langkah-langkah di bagian ini untuk mengunduh dan menginstal driver Amazon Redshift ODBC pada versi macOS X yang didukung. Proses instalasi menginstal file driver di direktori berikut:
+ `/opt/amazon/redshift/lib/universal`
+ `/opt/amazon/redshift/ErrorMessages`
+ `/opt/amazon/redshift/Setup`
**Untuk menginstal driver Amazon Redshift ODBC di macOS X**
1. [Untuk menginstal driver Amazon Redshift ODBC di macOS X, unduh driver macOS versi 1.6.3.](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/AmazonRedshiftODBC-64-bit.1.6.3.1008.universal.pkg)
Kemudian unduh dan tinjau perjanjian [SIM Amazon Redshift ODBC dan JDBC](https://s3.amazonaws.com/redshift-downloads/drivers/Amazon+Redshift+ODBC+and+JDBC+Driver+License+Agreement.pdf).
1. Klik dua kali **AmazonRedshiftODBC.pkg** untuk menjalankan installer.
1. Ikuti langkah-langkah di installer untuk menyelesaikan proses instalasi driver. Untuk melakukan instalasi, setujui ketentuan perjanjian lisensi.
**penting**
Setelah Anda selesai menginstal driver, konfigurasikan untuk digunakan pada sistem Anda. Untuk informasi selengkapnya tentang konfigurasi driver, lihat[Gunakan manajer driver ODBC untuk mengonfigurasi driverGunakan manajer driver ODBC untuk mengonfigurasi driver](odbc-driver-configure-mac.md).
# Gunakan manajer driver ODBC untuk mengonfigurasi driver
Pada sistem operasi macOS X, Anda menggunakan pengelola driver ODBC untuk mengonfigurasi setelan koneksi ODBC. Manajer driver ODBC menggunakan file konfigurasi untuk menentukan dan mengkonfigurasi sumber data dan driver ODBC. Manajer driver ODBC yang Anda gunakan bergantung pada sistem operasi yang Anda gunakan. Untuk sistem operasi macOS X, ini adalah manajer driver IodBC.
Untuk informasi selengkapnya tentang pengelola driver ODBC yang didukung untuk mengonfigurasi driver Amazon Redshift ODBC, lihat [Menggunakan driver Amazon Redshift ODBC di macOS XMenggunakan driver ODBC di macOS X](install-odbc-driver-mac.md) untuk sistem operasi macOS X. Juga, lihat “Menentukan Manajer Driver ODBC di Mesin Non-Windows” di panduan pemasangan dan [konfigurasi konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
Tiga file diperlukan untuk mengonfigurasi driver Amazon Redshift ODBC`amazon.redshiftodbc.ini`:`odbc.ini`,, dan. `odbcinst.ini`
Jika Anda menginstal ke lokasi default, file `amazon.redshiftodbc.ini` konfigurasi terletak di`/opt/amazon/redshift/lib`.
Selain itu, `/opt/amazon/redshift/Setup` di bawah macOS X, ada sampel `odbc.ini` dan `odbcinst.ini` file. Anda dapat menggunakan file-file ini sebagai contoh untuk mengonfigurasi driver Amazon Redshift ODBC dan nama sumber data (DSN).
Kami tidak menyarankan menggunakan direktori instalasi driver Amazon Redshift ODBC untuk file konfigurasi. File sampel dalam `Setup` direktori hanya untuk tujuan contoh. Jika Anda menginstal ulang driver Amazon Redshift ODBC di lain waktu, atau meningkatkan ke versi yang lebih baru, direktori instalasi akan ditimpa. Anda kemudian kehilangan perubahan apa pun yang mungkin Anda buat pada file-file itu.
Untuk menghindari hal ini, salin `amazon.redshiftodbc.ini` file ke direktori selain direktori instalasi. Jika Anda menyalin file ini ke direktori home pengguna, tambahkan titik (.) ke awal nama file untuk menjadikannya file tersembunyi.
Untuk `odbcinst.ini` file `odbc.ini` dan, gunakan file konfigurasi di direktori home pengguna atau buat versi baru di direktori lain. Secara default, sistem operasi macOS X Anda harus memiliki `odbc.ini` file dan `odbcinst.ini` file di direktori home pengguna (`/home/$USER`atau`~/`.). File default ini adalah file tersembunyi, yang ditunjukkan oleh titik (.) di depan setiap nama file. File-file ini hanya ditampilkan ketika Anda menggunakan `-a` bendera untuk daftar isi direktori.
Opsi apa pun yang Anda pilih untuk `odbcinst.ini` file `odbc.ini` dan, ubah file untuk menambahkan informasi konfigurasi driver dan DSN. Jika Anda membuat file baru, Anda juga perlu mengatur variabel lingkungan untuk menentukan di mana file konfigurasi ini berada.
Secara default, manajer driver ODBC dikonfigurasi untuk menggunakan versi tersembunyi dari file `odbc.ini` dan `odbcinst.ini` konfigurasi (bernama. `odbc.ini`dan. `odbcinst.ini`) terletak di direktori home. Mereka juga dikonfigurasi untuk menggunakan `amazon.redshiftodbc.ini` file di `/lib` subfolder direktori instalasi driver. Jika Anda menyimpan file konfigurasi ini di tempat lain, atur variabel lingkungan yang dijelaskan berikut sehingga manajer driver dapat menemukan file. Untuk informasi selengkapnya, lihat “Menentukan Lokasi File Konfigurasi Driver” di panduan [pemasangan dan konfigurasi konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
## Membuat nama sumber data sistem operasi macOS X
Saat menghubungkan ke penyimpanan data Anda menggunakan nama sumber data (DSN), konfigurasikan `odbc.ini` file yang akan ditentukan DSNs. Tetapkan properti dalam `odbc.ini` file untuk membuat DSN yang menentukan informasi koneksi untuk penyimpanan data Anda.
Untuk informasi tentang cara mengonfigurasi `odbc.ini` file, lihat “Membuat Nama Sumber Data pada Mesin Non-Windows” di panduan [pemasangan dan konfigurasi konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf) ODBC
Gunakan format berikut pada sistem operasi macOS X.
```
[ODBC Data Sources]
driver_name=dsn_name
[dsn_name]
Driver=path/lib/amazonredshiftodbc.dylib
Host=cluster_endpoint
Port=port_number
Database=database_name
locale=locale
```
Contoh berikut menunjukkan konfigurasi untuk `odbc.ini` pada sistem operasi macOS X.
```
[ODBC Data Sources]
Amazon_Redshift_dylib=Amazon Redshift DSN for macOS X
[Amazon Redshift DSN for macOS X]
Driver=/opt/amazon/redshift/lib/amazonredshiftodbc.dylib
Host=examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com
Port=5932
Database=dev
locale=en-US
```
## Mengkonfigurasi koneksi tanpa DSN pada sistem operasi macOS X
Untuk terhubung ke penyimpanan data Anda melalui koneksi yang tidak memiliki DSN, tentukan driver dalam `odbcinst.ini` file. Kemudian berikan string koneksi tanpa DSN di aplikasi Anda.
Untuk informasi tentang cara mengonfigurasi `odbcinst.ini` file dalam kasus ini, lihat “Mengonfigurasi Koneksi Tanpa DSN pada Mesin Non-Windows” di panduan pemasangan dan konfigurasi konektor Amazon Redshift [ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf). .
Gunakan format berikut pada sistem operasi macOS X.
```
[ODBC Drivers]
driver_name=Installed
...
[driver_name]
Description=driver_description
Driver=path/lib/amazonredshiftodbc.dylib
...
```
Contoh berikut menunjukkan `odbcinst.ini` konfigurasi untuk driver yang diinstal di direktori default pada sistem operasi macOS X.
```
[ODBC Drivers]
Amazon RedshiftODBC DSN=Installed
[Amazon RedshiftODBC DSN]
Description=Amazon Redshift ODBC Driver for macOS X
Driver=/opt/amazon/redshift/lib/amazonredshiftodbc.dylib
```
## Mengonfigurasi variabel lingkungan
Gunakan manajer driver ODBC yang benar untuk memuat driver yang benar. Untuk melakukan ini, atur variabel lingkungan jalur perpustakaan. Untuk informasi selengkapnya, lihat “Menentukan Manajer Driver ODBC di Mesin Non-Windows” di panduan pemasangan dan konfigurasi [konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
Secara default, manajer driver ODBC dikonfigurasi untuk menggunakan versi tersembunyi dari file `odbc.ini` dan `odbcinst.ini` konfigurasi (bernama. `odbc.ini`dan. `odbcinst.ini`) terletak di direktori home. Mereka juga dikonfigurasi untuk menggunakan `amazon.redshiftodbc.ini` file di `/lib` subfolder direktori instalasi driver. Jika Anda menyimpan file konfigurasi ini di tempat lain, variabel lingkungan sehingga manajer driver dapat menemukan file. Untuk informasi selengkapnya, lihat “Menentukan Lokasi File Konfigurasi Driver” di Panduan *Pemasangan dan Konfigurasi Konektor Amazon Redshift ODBC*.
## Mengkonfigurasi fitur koneksi
Anda dapat mengonfigurasi fitur koneksi berikut untuk pengaturan ODBC Anda:
+ Konfigurasikan driver ODBC untuk memberikan kredensi dan mengautentikasi koneksi ke database Amazon Redshift.
+ Konfigurasikan driver ODBC untuk menyambung ke soket yang diaktifkan dengan Secure Sockets Layer (SSL), jika Anda terhubung ke server Amazon Redshift yang mengaktifkan SSL.
+ Konfigurasikan driver ODBC untuk terhubung ke Amazon Redshift melalui server proxy.
+ Konfigurasikan driver ODBC untuk menggunakan mode pemrosesan kueri untuk mencegah kueri menghabiskan terlalu banyak memori.
+ Konfigurasikan driver ODBC untuk meneruskan proses otentikasi IAM melalui server proxy.
+ Konfigurasikan driver ODBC untuk menggunakan keepalives TCP untuk mencegah koneksi dari waktu habis.
Untuk informasi tentang fitur koneksi ini, lihat panduan [pemasangan dan konfigurasi konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
# Opsi driver ODBC
Anda dapat menggunakan opsi konfigurasi untuk mengontrol perilaku driver Amazon Redshift ODBC.
Di Microsoft Windows, Anda biasanya mengatur opsi driver saat mengonfigurasi nama sumber data (DSN). Anda juga dapat mengatur opsi driver dalam string koneksi saat Anda terhubung secara terprogram, atau dengan menambahkan atau mengubah kunci registri. `HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\your_DSN` Untuk informasi selengkapnya tentang mengonfigurasi DSN, lihat. [Menggunakan driver Amazon Redshift ODBC di Microsoft Windows](install-odbc-driver-windows.md)
Di macOS X, Anda mengatur opsi konfigurasi driver di `amazon.redshiftodbc.ini` file `odbc.ini` dan file Anda, seperti yang dijelaskan dalam. [Gunakan manajer driver ODBC untuk mengonfigurasi driverGunakan manajer driver ODBC untuk mengonfigurasi driver](odbc-driver-configure-mac.md) Opsi konfigurasi yang diatur dalam `amazon.redshiftodbc.ini` file berlaku untuk semua koneksi. Sebaliknya, opsi konfigurasi yang diatur dalam `odbc.ini` file khusus untuk koneksi. Opsi konfigurasi yang disetel lebih `odbc.ini` diutamakan daripada opsi konfigurasi yang ditetapkan. `amazon.redshiftodbc.ini`
Untuk informasi tentang cara mengatur opsi konfigurasi driver ODBC, lihat panduan [pemasangan dan konfigurasi konektor Amazon Redshift ODBC](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1008/Amazon+Redshift+ODBC+Connector+Install+Guide.pdf).
# Versi driver ODBC sebelumnya
Unduh versi driver Amazon Redshift ODBC sebelumnya hanya jika alat Anda memerlukan versi driver tertentu.
## Versi driver ODBC sebelumnya untuk Windows
Berikut ini adalah driver 64-bit:
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1006/AmazonRedshiftODBC64-1.6.3.1006.msi Di Wilayah AWS](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1006/AmazonRedshiftODBC64-1.6.3.1006.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.1.1000/AmazonRedshiftODBC64-1.6.1.1000.msi Di Wilayah AWS](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.1.1000/AmazonRedshiftODBC64-1.6.1.1000.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.20.1024/AmazonRedshiftODBC64-1.5.20.1024.msi Di Wilayah AWS](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.20.1024/AmazonRedshiftODBC64-1.5.20.1024.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.16.1019/AmazonRedshiftODBC64-1.5.16.1019.msi Di Wilayah AWS](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.16.1019/AmazonRedshiftODBC64-1.5.16.1019.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.9.1011/AmazonRedshiftODBC64-1.5.9.1011.msi Di Wilayah AWS](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.9.1011/AmazonRedshiftODBC64-1.5.9.1011.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.7.1007/AmazonRedshiftODBC64-1.5.7.1007.msi Di Wilayah AWS](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.7.1007/AmazonRedshiftODBC64-1.5.7.1007.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.65.1000/AmazonRedshiftODBC64-1.4.65.1000.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.65.1000/AmazonRedshiftODBC64-1.4.65.1000.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.62.1000/AmazonRedshiftODBC64-1.4.62.1000.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.62.1000/AmazonRedshiftODBC64-1.4.62.1000.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.59.1000/AmazonRedshiftODBC64-1.4.59.1000.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.59.1000/AmazonRedshiftODBC64-1.4.59.1000.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.56.1000/AmazonRedshiftODBC64-1.4.56.1000.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.56.1000/AmazonRedshiftODBC64-1.4.56.1000.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.53.1000/AmazonRedshiftODBC64-1.4.53.1000.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.53.1000/AmazonRedshiftODBC64-1.4.53.1000.msi)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.52.1000/AmazonRedshiftODBC64-1.4.52.1000.msi](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.52.1000/AmazonRedshiftODBC64-1.4.52.1000.msi)
Driver 32-bit dihentikan dan versi sebelumnya tidak didukung.
## Versi driver ODBC sebelumnya untuk Linux
Berikut ini adalah versi driver 64-bit:
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1006/AmazonRedshiftODBC-64-bit-1.6.3.1006-1.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1006/AmazonRedshiftODBC-64-bit-1.6.3.1006-1.x86_64.rpm) -64-bit-1.6.3.1006-1.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.1.1000/AmazonRedshiftODBC-64-bit-1.6.1.1000-1.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.1.1000/AmazonRedshiftODBC-64-bit-1.6.1.1000-1.x86_64.rpm) -64-bit-1.6.1.1000-1.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.20.1024/AmazonRedshiftODBC-64-bit-1.5.20.1024-1.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.20.1024/AmazonRedshiftODBC-64-bit-1.5.20.1024-1.x86_64.rpm) -64-bit-1.5.20.1024-1.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.16.1019/AmazonRedshiftODBC-64-bit-1.5.16.1019-1.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.16.1019/AmazonRedshiftODBC-64-bit-1.5.16.1019-1.x86_64.rpm)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.9.1011/AmazonRedshiftODBC-64-bit-1.5.9.1011-1.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.9.1011/AmazonRedshiftODBC-64-bit-1.5.9.1011-1.x86_64.rpm) -64-bit-1.5.9.1011-1.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.7.1007/AmazonRedshiftODBC-64-bit-1.5.7.1007-1.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.7.1007/AmazonRedshiftODBC-64-bit-1.5.7.1007-1.x86_64.rpm) -64-bit-1.5.7.1007-1.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.65.1000/AmazonRedshiftODBC-64-bit-1.4.65.1000-1.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.65.1000/AmazonRedshiftODBC-64-bit-1.4.65.1000-1.x86_64.rpm) -64-bit-1.4.65.1000-1.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.62.1000/AmazonRedshiftODBC-64-bit-1.4.62.1000-1.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.62.1000/AmazonRedshiftODBC-64-bit-1.4.62.1000-1.x86_64.rpm) -64-bit-1.4.62.1000-1.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.59.1000/AmazonRedshiftODBC-64-bit-1.4.59.1000-1.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.59.1000/AmazonRedshiftODBC-64-bit-1.4.59.1000-1.x86_64.rpm) -64-bit-1.4.59.1000-1.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.59.1000/AmazonRedshiftODBC-64-bit-1.4.59.1000-1.x86\$164.deb](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.59.1000/AmazonRedshiftODBC-64-bit-1.4.59.1000-1.x86_64.deb)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.56.1000/AmazonRedshiftODBC-64-bit-1.4.56.1000-1.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.56.1000/AmazonRedshiftODBC-64-bit-1.4.56.1000-1.x86_64.rpm) -64-bit-1.4.56.1000-1.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.56.1000/AmazonRedshiftODBC-64-bit-1.4.56.1000-1.x86\$164.deb](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.56.1000/AmazonRedshiftODBC-64-bit-1.4.56.1000-1.x86_64.deb)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.52.1000/AmazonRedshiftODBC-64-bit-1.4.52.1000-1.x86\$164.rpm](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.52.1000/AmazonRedshiftODBC-64-bit-1.4.52.1000-1.x86_64.rpm) -64-bit-1.4.52.1000-1.x86\$164.rpm
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.52.1000/AmazonRedshiftODBC-64-bit-1.4.52.1000-1.x86\$164.deb](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.52.1000/AmazonRedshiftODBC-64-bit-1.4.52.1000-1.x86_64.deb)
Driver 32-bit dihentikan dan versi sebelumnya tidak didukung.
## Versi driver ODBC sebelumnya untuk macOS X
Berikut ini adalah versi driver Amazon Redshift ODBC untuk macOS X:
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1006/AmazonRedshiftODBC-64-bit.1.6.3.1006.universal.pkg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.3.1006/AmazonRedshiftODBC-64-bit.1.6.3.1006.universal.pkg)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.1.1000/AmazonRedshiftODBC-64-bit.1.6.1.1000.universal.pkg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.6.1.1000/AmazonRedshiftODBC-64-bit.1.6.1.1000.universal.pkg)
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.20.1024/AmazonRedshiftODBC-1.5.20.1024.arm64.dmg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.20.1024/AmazonRedshiftODBC-1.5.20.1024.arm64.dmg) -1.5.20.1024.arm64.dmg
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.20.1024/AmazonRedshiftODBC-1.5.20.1024.x86\$164.dmg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.20.1024/AmazonRedshiftODBC-1.5.20.1024.x86_64.dmg) -1.5.20.1024.x86\$164.dmg
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.16.1019/AmazonRedshiftODBC-1.5.16.1019.x86\$164.dmg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.16.1019/AmazonRedshiftODBC-1.5.16.1019.x86_64.dmg) -1.5.16.1019.x86\$164.dmg
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.9.1011/AmazonRedshiftODBC-1.5.9.1011.x86\$164.dmg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.9.1011/AmazonRedshiftODBC-1.5.9.1011.x86_64.dmg) -1.5.9.1011.x86\$164.dmg
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.7.1007/AmazonRedshiftODBC-1.5.7.1007.x86\$164.dmg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.5.7.1007/AmazonRedshiftODBC-1.5.7.1007.x86_64.dmg) -1.5.7.1007.x86\$164.dmg
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.65.1000/AmazonRedshiftODBC-1.4.65.1000.dmg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.65.1000/AmazonRedshiftODBC-1.4.65.1000.dmg) -1.4.65.1000.dmg
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.62.1000/AmazonRedshiftODBC-1.4.62.1000.dmg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.62.1000/AmazonRedshiftODBC-1.4.62.1000.dmg) -1.4.62.1000.dmg
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.59.1000/AmazonRedshiftODBC-1.4.59.1000.dmg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.59.1000/AmazonRedshiftODBC-1.4.59.1000.dmg) -1.4.59.1000.dmg
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.56.1000/AmazonRedshiftODBC-1.4.56.1000.dmg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.56.1000/AmazonRedshiftODBC-1.4.56.1000.dmg) -1.4.56.1000.dmg
+ [https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.52.1000/AmazonRedshiftODBC-1.4.52.1000.dmg](https://s3.amazonaws.com/redshift-downloads/drivers/odbc/1.4.52.1000/AmazonRedshiftODBC-1.4.52.1000.dmg) -1.4.52.1000.dmg
# Mengkonfigurasi opsi keamanan untuk koneksi
Amazon Redshift mendukung koneksi Secure Sockets Layer (SSL) untuk mengenkripsi data dan sertifikat server untuk memvalidasi sertifikat server yang terhubung dengan klien.
## SSL
Untuk mendukung koneksi SSL, Amazon Redshift membuat dan menginstal sertifikat SSL [(ACM)AWS Certificate Manager yang](https://aws.amazon.com/certificate-manager/) dikeluarkan pada setiap cluster. Sertifikat ACM dipercaya publik oleh sebagian besar sistem operasi, browser web, dan klien. Anda mungkin perlu mengunduh bundel sertifikat jika klien atau aplikasi SQL Anda terhubung ke Amazon Redshift menggunakan SSL dengan `sslmode` opsi koneksi disetel `require` ke`verify-ca`,, atau. `verify-full` Jika klien Anda memerlukan sertifikat, Amazon Redshift menyediakan sertifikat bundel sebagai berikut:
+ Unduh bundel dari [https://s3.amazonaws.com/redshift-downloads/amazon-trust-ca-bundle.crt](https://s3.amazonaws.com/redshift-downloads/amazon-trust-ca-bundle.crt).
+ Nomor MD5 checksum yang diharapkan adalah 418dea9b6d5d5de7a8f1ac42e164cdcf.
+ Nomor checksum sha256 adalah 36dba8e4b8041cd14b9d60158893963301bcbb92e1c456847784de2acb5bd550.
Jangan gunakan bundel sertifikat sebelumnya yang berada di`https://s3.amazonaws.com/redshift-downloads/redshift-ca-bundle.crt`.
+ Di Wilayah AWS Tiongkok, unduh bundel [https://s3---cn-north-1.amazonaws.com.rproxy.govskope.usdari. cn/redshift-downloads-cn/amazon- trust-ca-bundle .crt](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/amazon-trust-ca-bundle.crt).
+ Nomor MD5 checksum yang diharapkan adalah 418dea9b6d5d5de7a8f1ac42e164cdcf.
+ Nomor checksum sha256 adalah 36dba8e4b8041cd14b9d60158893963301bcbb92e1c456847784de2acb5bd550.
Jangan gunakan bundel sertifikat sebelumnya yang berada di `https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/redshift-ca-bundle.crt` dan `https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/redshift-ssl-ca-cert.pem`
**penting**
Amazon Redshift telah mengubah cara sertifikat SSL dikelola. Anda mungkin perlu memperbarui sertifikat CA root kepercayaan Anda saat ini untuk terus terhubung ke cluster Anda menggunakan SSL. Untuk informasi selengkapnya, lihat [Transisi ke sertifikat ACM untuk koneksi SSL](connecting-transitioning-to-acm-certs.md).
Secara default, database cluster menerima koneksi apakah menggunakan SSL atau tidak. Untuk mengonfigurasi klaster Anda agar memerlukan koneksi SSL, atur `require_SSL` parameter ke `true` dalam grup parameter yang terkait dengan cluster.
Amazon Redshift mendukung mode SSL yang sesuai dengan Federal Information Processing Standard (FIPS) 140-2. Mode SSL yang sesuai dengan FIPS dinonaktifkan secara default.
**penting**
Aktifkan mode SSL yang sesuai dengan FIPS hanya jika sistem Anda harus sesuai dengan FIPS.
Untuk mengaktifkan mode SSL yang sesuai dengan FIPS, setel `use_fips_ssl` parameter dan parameter ke `true` dalam grup `require_SSL` parameter yang terkait dengan cluster Amazon Redshift atau grup kerja Redshift Serverless. Untuk informasi tentang memodifikasi grup parameter pada klaster, lihat[Grup parameter Amazon Redshift](working-with-parameter-groups.md). Untuk informasi tentang memodifikasi grup parameter pada workgroup, lihat. [Mengonfigurasi koneksi SSL yang sesuai dengan FIPS ke Amazon Redshift Tanpa Server](serverless-connecting.md#serverless_secure-fips-ssl)
Amazon Redshift mendukung protokol perjanjian kunci Elliptic Curve Diffie—Hellman Ephemeral (ECDHE). Dengan ECDHE, klien dan server masing-masing memiliki elliptic curve public-private key pair yang digunakan untuk membangun rahasia bersama melalui saluran yang tidak aman. Anda tidak perlu mengonfigurasi apa pun di Amazon Redshift untuk mengaktifkan ECDHE. Jika Anda terhubung dari alat klien SQL yang menggunakan ECDHE untuk mengenkripsi komunikasi antara klien dan server, Amazon Redshift menggunakan daftar sandi yang disediakan untuk membuat koneksi yang sesuai. [Untuk informasi lebih lanjut, lihat [Elliptic curve diffie—hellman](https://en.wikipedia.org/wiki/Elliptic_curve_Diffie%E2%80%93Hellman) di Wikipedia dan Ciphers di situs web OpenSSL.](https://www.openssl.org/)
## SSL dan percaya sertifikat CA di ODBC
Jika Anda terhubung menggunakan driver Amazon Redshift ODBC terbaru (versi 1.3.7.1000 atau yang lebih baru), Anda dapat melewati bagian ini. Untuk mengunduh driver terbaru, lihat[Mengonfigurasi koneksi untuk driver ODBC versi 2.x untuk Amazon Redshift](odbc20-install.md).
Anda mungkin perlu memperbarui sertifikat CA root kepercayaan Anda saat ini untuk terus terhubung ke cluster Anda menggunakan SSL. Untuk informasi selengkapnya, lihat [SSL](#connect-using-ssl).
Anda dapat memverifikasi bahwa sertifikat yang Anda unduh cocok dengan nomor MD5 checksum yang diharapkan. Untuk melakukan ini, Anda dapat menggunakan program MD5sum pada sistem operasi Linux, atau alat lain pada sistem operasi Windows dan macOS X.
ODBC DSNs berisi `sslmode` pengaturan yang menentukan cara menangani enkripsi untuk koneksi klien dan verifikasi sertifikat server. Amazon Redshift mendukung `sslmode` nilai-nilai berikut dari koneksi klien:
+ `disable`
SSL dinonaktifkan dan koneksi tidak dienkripsi.
+ `allow`
SSL digunakan jika server membutuhkannya.
+ `prefer`
SSL digunakan jika server mendukungnya. Amazon Redshift mendukung SSL, jadi SSL digunakan saat Anda menyetelnya. `sslmode` `prefer`
+ `require`
SSL diperlukan.
+ `verify-ca`
SSL harus digunakan dan sertifikat server harus diverifikasi.
+ `verify-full`
SSL harus digunakan. Sertifikat server harus diverifikasi dan nama host server harus cocok dengan atribut hostname pada sertifikat.
Anda dapat menentukan apakah SSL digunakan dan sertifikat server diverifikasi dalam koneksi antara klien dan server. Untuk melakukan ini, Anda perlu meninjau `sslmode` pengaturan untuk ODBC DSN Anda pada klien dan `require_SSL` pengaturan untuk cluster Amazon Redshift di server. Tabel berikut menjelaskan hasil enkripsi untuk berbagai kombinasi pengaturan klien dan server:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/connecting-ssl-support.html)
### Connect menggunakan sertifikat server dengan ODBC di Microsoft Windows
Jika Anda ingin terhubung ke cluster menggunakan SSL dan sertifikat server, unduh sertifikat terlebih dahulu ke komputer klien Anda atau instans Amazon EC2. Kemudian konfigurasikan ODBC DSN.
1. Unduh bundel otoritas sertifikat Amazon Redshift ke komputer klien Anda di `lib` folder di direktori instalasi driver Anda, dan simpan file sebagai. `root.crt` Untuk informasi unduhan, lihat [SSL](#connect-using-ssl).
1. Buka **Administrator Sumber Data ODBC**, dan tambahkan atau edit entri DSN sistem untuk koneksi ODBC Anda. Untuk **Mode SSL**, pilih `verify-full` kecuali Anda menggunakan alias DNS. Jika Anda menggunakan alias DNS, pilih. `verify-ca` Lalu, pilih **Simpan**.
Untuk informasi selengkapnya tentang mengonfigurasi ODBC DSN, lihat. [Mengonfigurasi koneksi untuk driver ODBC versi 2.x untuk Amazon Redshift](odbc20-install.md)
## Sertifikat SSL dan server di Java
SSL menyediakan satu lapisan keamanan dengan mengenkripsi data yang bergerak antara klien dan cluster Anda. Menggunakan sertifikat server memberikan lapisan keamanan tambahan dengan memvalidasi bahwa klaster tersebut adalah klaster Amazon Redshift. Ia melakukannya dengan memeriksa sertifikat server yang secara otomatis diinstal pada semua cluster yang Anda sediakan. Untuk informasi lebih lanjut tentang menggunakan sertifikat server dengan JDBC, buka [Mengkonfigurasi klien dalam](https://jdbc.postgresql.org/documentation/ssl/#configuring-the-client) dokumentasi PostgreSQL.
### Connect menggunakan sertifikat CA trust di Java
**penting**
Amazon Redshift telah mengubah cara sertifikat SSL dikelola. Anda mungkin perlu memperbarui sertifikat CA root kepercayaan Anda saat ini untuk terus terhubung ke cluster Anda menggunakan SSL. Untuk informasi selengkapnya, lihat [SSL](#connect-using-ssl).
**Untuk terhubung menggunakan sertifikat CA trust**
Anda dapat menggunakan `redshift-keytool.jar` file untuk mengimpor sertifikat CA di bundel Amazon Redshift Certificate Authority ke Java TrustStore atau private Anda. TrustStore
1. Jika Anda menggunakan `-Djavax.net.ssl.trustStore` opsi baris perintah Java, hapus dari baris perintah, jika memungkinkan.
1. Unduh [redshift-keytool.jar](https://s3.amazonaws.com/redshift-downloads/redshift-keytool.jar).
1. Lakukan salah satu tindakan berikut:
+ Untuk mengimpor bundel Amazon Redshift Certificate Authority ke Java TrustStore, jalankan perintah berikut.
```
java -jar redshift-keytool.jar -s
```
+ Untuk mengimpor bundel Amazon Redshift Certificate Authority ke private Anda TrustStore, jalankan perintah berikut:
```
java -jar redshift-keytool.jar -k -p
```
# Transisi ke sertifikat ACM untuk koneksi SSL
Amazon Redshift mengganti sertifikat SSL di klaster Anda dengan sertifikat yang dikeluarkan [AWS Certificate Manager (ACM](https://aws.amazon.com/certificate-manager/)). ACM adalah otoritas sertifikat publik tepercaya (CA) yang dipercaya oleh sebagian besar sistem saat ini. Anda mungkin perlu memperbarui sertifikat CA root kepercayaan Anda saat ini untuk terus terhubung ke cluster Anda menggunakan SSL.
Perubahan ini hanya memengaruhi Anda jika semua hal berikut berlaku:
+ Klien atau aplikasi SQL Anda terhubung ke klaster Amazon Redshift menggunakan SSL dengan `sslMode` opsi koneksi disetel `require` ke`verify-ca`,, atau opsi konfigurasi. `verify-full`
+ Anda tidak menggunakan driver Amazon Redshift ODBC atau JDBC, atau Anda menggunakan driver Amazon Redshift sebelum ODBC versi 1.3.7.1000 atau JDBC versi 1.2.8.1005.
Jika perubahan ini memengaruhi Anda di Wilayah Amazon Redshift komersial, maka Anda harus memperbarui sertifikat CA root kepercayaan Anda saat ini sebelum 23 Oktober 2017. Amazon Redshift akan mentransisikan cluster Anda untuk menggunakan sertifikat ACM antara sekarang dan 23 Oktober 2017. Perubahan seharusnya sangat sedikit atau tidak berpengaruh pada kinerja atau ketersediaan cluster Anda.
Jika perubahan ini memengaruhi Anda di Wilayah AWS GovCloud (US) (AS), maka Anda harus memperbarui sertifikat CA root kepercayaan Anda saat ini sebelum 1 April 2020 untuk menghindari gangguan layanan. Mulai tanggal ini, klien yang terhubung ke klaster Amazon Redshift menggunakan koneksi terenkripsi SSL memerlukan otoritas sertifikat tepercaya (CA) tambahan. Klien menggunakan otoritas sertifikat tepercaya untuk mengonfirmasi identitas klaster Amazon Redshift saat mereka terhubung dengannya. Tindakan Anda diperlukan untuk memperbarui klien dan aplikasi SQL Anda untuk menggunakan bundel sertifikat yang diperbarui yang menyertakan CA tepercaya baru.
**penting**
Di Wilayah Tiongkok pada 5 Januari 2021, Amazon Redshift mengganti sertifikat SSL di AWS Certificate Manager klaster Anda dengan sertifikat yang dikeluarkan (ACM). Jika perubahan ini memengaruhi Anda di Wilayah Tiongkok (Beijing) atau Wilayah Tiongkok (Ningxia), maka Anda harus memperbarui sertifikat CA root trust Anda saat ini sebelum 5 Januari 2021 untuk menghindari gangguan layanan. Mulai tanggal ini, klien yang terhubung ke klaster Amazon Redshift menggunakan koneksi terenkripsi SSL memerlukan otoritas sertifikat tepercaya (CA) tambahan. Klien menggunakan otoritas sertifikat tepercaya untuk mengonfirmasi identitas klaster Amazon Redshift saat mereka terhubung dengannya. Tindakan Anda diperlukan untuk memperbarui klien dan aplikasi SQL Anda untuk menggunakan bundel sertifikat yang diperbarui yang menyertakan CA tepercaya baru.
+ [Menggunakan driver Amazon Redshift ODBC atau JDBC terbaru](#connecting-transitioning-to-acm-latest-odbc-jdbc)
+ [Menggunakan driver Amazon Redshift ODBC atau JDBC sebelumnya](#connecting-transitioning-to-acm-earlier-odbc-jdbc)
+ [Menggunakan jenis koneksi SSL lainnya](#connecting-transitioning-to-acm-other-ssl-types)
## Menggunakan driver Amazon Redshift ODBC atau JDBC terbaru
Metode yang disukai adalah menggunakan driver Amazon Redshift ODBC atau JDBC terbaru. Driver Amazon Redshift dimulai dengan ODBC versi 1.3.7.1000 dan JDBC versi 1.2.8.1005 secara otomatis mengelola transisi dari sertifikat yang ditandatangani sendiri Amazon Redshift ke sertifikat ACM. Untuk mengunduh driver terbaru, lihat[Mengonfigurasi koneksi untuk driver JDBC versi 2.x untuk Amazon Redshift](jdbc20-install.md).
Jika Anda menggunakan driver Amazon Redshift JDBC terbaru, sebaiknya jangan gunakan `-Djavax.net.ssl.trustStore` dalam opsi JVM. Jika Anda harus menggunakan`-Djavax.net.ssl.trustStore`, impor bundel otoritas sertifikat Redshift ke truststore yang ditunjuknya. Untuk informasi unduhan, lihat [SSL](connecting-ssl-support.md#connect-using-ssl). Untuk informasi selengkapnya, lihat [Mengimpor bundel otoritas sertifikat Amazon Redshift ke dalam TrustStore](#importing-the-acm-bundle-to-truststore).
## Menggunakan driver Amazon Redshift ODBC atau JDBC sebelumnya
+ Jika ODBC DSN Anda dikonfigurasi`SSLCertPath`, timpa file sertifikat di jalur yang ditentukan.
+ Jika tidak `SSLCertPath` disetel, timpa file sertifikat yang disebutkan `root.crt` di lokasi DLL driver.
Jika Anda harus menggunakan driver Amazon Redshift JDBC sebelum versi 1.2.8.1005, lakukan salah satu hal berikut:
+ Jika string koneksi JDBC Anda menggunakan `sslCert` opsi, hapus opsi. `sslCert` Kemudian impor bundel otoritas sertifikat Redshift ke Java Anda. TrustStore Untuk informasi unduhan, lihat [SSL](connecting-ssl-support.md#connect-using-ssl). Untuk informasi selengkapnya, lihat [Mengimpor bundel otoritas sertifikat Amazon Redshift ke dalam TrustStore](#importing-the-acm-bundle-to-truststore).
+ Jika Anda menggunakan `-Djavax.net.ssl.trustStore` opsi baris perintah Java, hapus dari baris perintah, jika memungkinkan. Kemudian impor bundel otoritas sertifikat Redshift ke Java Anda. TrustStore Untuk informasi unduhan, lihat [SSL](connecting-ssl-support.md#connect-using-ssl). Untuk informasi selengkapnya, lihat [Mengimpor bundel otoritas sertifikat Amazon Redshift ke dalam TrustStore](#importing-the-acm-bundle-to-truststore).
### Mengimpor bundel otoritas sertifikat Amazon Redshift ke dalam TrustStore
Anda dapat menggunakan `redshift-keytool.jar` untuk mengimpor sertifikat CA di bundel Amazon Redshift Certificate Authority ke Java TrustStore atau truststore pribadi Anda.
**Untuk mengimpor bundel otoritas sertifikat Amazon Redshift ke dalam TrustStore**
1. Unduh [redshift-keytool.jar](https://s3.amazonaws.com/redshift-downloads/redshift-keytool.jar).
1. Lakukan salah satu tindakan berikut:
+ Untuk mengimpor bundel Amazon Redshift Certificate Authority ke Java TrustStore, jalankan perintah berikut.
```
java -jar redshift-keytool.jar -s
```
+ Untuk mengimpor bundel Amazon Redshift Certificate Authority ke private Anda TrustStore, jalankan perintah berikut:
```
java -jar redshift-keytool.jar -k -p
```
## Menggunakan jenis koneksi SSL lainnya
Ikuti langkah-langkah di bagian ini jika Anda terhubung menggunakan salah satu dari berikut ini:
+ Driver ODBC sumber terbuka
+ Driver JDBC sumber terbuka
+ Antarmuka [baris perintah Amazon Redshift RSQL](https://docs.aws.amazon.com/redshift/latest/mgmt/rsql-query-tool.html)
+ Binding bahasa apa pun berdasarkan libpq, seperti psycopg2 (Python) dan ruby-pg (Ruby)
**Untuk menggunakan sertifikat ACM dengan jenis koneksi SSL lainnya:**
1. Unduh bundel otoritas sertifikat Amazon Redshift. Untuk informasi unduhan, lihat [SSL](connecting-ssl-support.md#connect-using-ssl).
1. Tempatkan sertifikat dari bundel di `root.crt` file Anda.
+ Pada sistem operasi Linux dan macOS X, file tersebut adalah. `~/.postgresql/root.crt`
+ Di Microsoft Windows, filenya adalah`%APPDATA%\postgresql\root.crt`.
# Menghubungkan dari alat dan kode klien
Amazon Redshift menyediakan editor kueri Amazon Redshift v2 untuk terhubung ke cluster dan grup kerja Anda. Untuk informasi selengkapnya, lihat [Menanyakan database menggunakan editor kueri v2Mengkueri database menggunakan editor kueri Amazon Redshift v2](query-editor-v2.md).
Bagian ini menyediakan beberapa opsi untuk alat pihak ketiga untuk terhubung. Selain itu, ini menjelaskan cara terhubung ke cluster Anda secara terprogram.
**Topics**
+ [Menghubungkan dengan Amazon Redshift RSQL](rsql-query-tool.md)
+ [Connect ke cluster dengan Amazon Redshift RSQL](rsql-query-tool-starting-tool-connection.md)
+ [Perintah meta Amazon Redshift RSQL](rsql-query-tool-commands.md)
+ [Variabel Amazon Redshift RSQL](rsql-query-tool-variables.md)
+ [Kode kesalahan Amazon Redshift RSQL](rsql-query-tool-error-codes.md)
+ [Variabel lingkungan Amazon Redshift RSQL](rsql-query-tool-environment-variables.md)
# Menghubungkan dengan Amazon Redshift RSQL
Amazon Redshift RSQL adalah klien baris perintah untuk berinteraksi dengan cluster dan database Amazon Redshift. Anda dapat terhubung ke klaster Amazon Redshift, menjelaskan objek database, data kueri, dan melihat hasil kueri dalam berbagai format keluaran.
Amazon Redshift RSQL mendukung kemampuan alat baris perintah PostgreSQL psql dengan serangkaian kemampuan tambahan khusus untuk Amazon Redshift. Sumber daya yang dimaksud meliputi:
+ Anda dapat menggunakan otentikasi masuk tunggal menggunakan AD FS,, Okta PingIdentity, Azure ADm atau penyedia identitas berbasis lainnya. SAML/JWT Anda juga dapat menggunakan penyedia identitas SAMP berbasis browser untuk otentikasi multi-faktor (MFA).
+ Anda dapat mendeskripsikan properti atau atribut objek Amazon Redshift seperti kunci distribusi tabel, kunci pengurutan tabel, tampilan pengikatan akhir (LBVs), dan tampilan terwujud. Anda juga dapat menjelaskan properti atau atribut tabel eksternal dalam AWS Glue katalog atau Apache Hive Metastore, database eksternal di Amazon RDS untuk PostgreSQL, Amazon Aurora PostgreSQL Edisi yang kompatibel dengan PostgreSQL, RDS untuk MySQL (pratinjau) dan Amazon Aurora Edisi yang kompatibel dengan MySQL (pratinjau), dan tabel yang dibagikan menggunakan Amazon Redshift Berbagi data.
+ Anda juga dapat menggunakan perintah aliran kontrol yang disempurnakan seperti `IF` (`\ELSEIF`, `\ELSE,``\ENDIF`), `\GOTO` dan`\LABEL`.
Dengan mode batch Amazon Redshift RSQL, yang menjalankan skrip yang diteruskan sebagai parameter input, Anda dapat menjalankan skrip yang menyertakan SQL dan logika bisnis yang kompleks. Jika Anda memiliki gudang data lokal yang dikelola sendiri, Anda dapat menggunakan Amazon Redshift RSQL untuk mengganti skrip ekstrak, transformasi, pemuatan (ETL), dan otomatisasi yang ada, seperti skrip Teradata BTEQ. Menggunakan RSQL membantu Anda menghindari penerapan ulang skrip secara manual dalam bahasa prosedural.
Amazon Redshift RSQL tersedia untuk sistem operasi Linux, Windows, dan macOS X.
Untuk melaporkan masalah Amazon Redshift RSQL, tulis ke @amazon .com. redshift-rsql-support
**Topics**
+ [Memulai dengan Amazon Redshift RSQL](rsql-query-tool-getting-started.md)
+ [Log perubahan Amazon Redshift RSQL](rsql-query-tool-changelog.md)
# Memulai dengan Amazon Redshift RSQL
Instal Amazon Redshift RSQL di komputer dengan sistem operasi Linux, macOS, atau Microsoft Windows.
## Unduh RSQL
+
+
+
+
+
Lihat log perubahan dan unduhan untuk versi sebelumnya di[Log perubahan Amazon Redshift RSQL](rsql-query-tool-changelog.md).
## Instal RSQL untuk Linux
Ikuti langkah-langkah di bawah ini untuk menginstal RSQL untuk Linux.
1. Instal manajer driver dengan perintah berikut:
```
sudo yum install unixODBC
```
1. Instal driver ODBC:[Mengunduh dan menginstal driver Amazon Redshift ODBCMengunduh dan menginstal driver ODBC](odbc20-install-linux.md).
1. Salin file ini ke direktori home Anda:
```
cp /opt/amazon/redshiftodbcx64/odbc.ini ~/.odbc.ini
```
1. Atur variabel lingkungan untuk menunjuk ke lokasi file:
```
export ODBCINI=~/.odbc.ini
export ODBCSYSINI=/opt/amazon/redshiftodbcx64/
export AMAZONREDSHIFTODBCINI=/opt/amazon/redshiftodbcx64/amazon.redshiftodbc.ini
```
1. Anda sekarang dapat menginstal RSQL dengan menjalankan perintah berikut.
```
sudo rpm -i AmazonRedshiftRsql-.rhel.x86_64.rpm
```
## Instal RSQL untuk Mac
Ikuti langkah-langkah di bawah ini untuk menginstal RSQL for Mac OSX.
1. Instal manajer driver dengan perintah berikut:
```
brew install unixodbc --build-from-source
```
1. Instal driver ODBC:[Mengunduh dan menginstal driver Amazon Redshift ODBCMengunduh dan menginstal driver ODBC](odbc-driver-mac-how-to-install.md).
1. Salin file ini ke direktori home Anda:
```
cp /opt/amazon/redshift/Setup/odbc.ini ~/.odbc.ini
```
1. Atur variabel lingkungan untuk menunjuk ke lokasi file:
```
export ODBCINI=~/.odbc.ini
export ODBCSYSINI=/opt/amazon/redshift/Setup
export AMAZONREDSHIFTODBCINI=/opt/amazon/redshift/lib/amazon.redshiftodbc.ini
```
1. Setel `DYLD_LIBRARY_PATH` ke lokasi libodbc.dylib Anda jika tidak masuk. `/usr/local/lib`
```
export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:/usr/local/lib
```
1. Klik dua kali file pkg untuk menjalankan installer.
1. Ikuti langkah-langkah di installer untuk menyelesaikan instalasi. Setuju dengan ketentuan perjanjian lisensi.
## Instal RSQL untuk Windows
Ikuti langkah-langkah di bawah ini untuk menginstal RSQL untuk Windows.
1. Instal driver ODBC:[Mengunduh dan menginstal driver Amazon Redshift ODBCMengunduh dan menginstal driver ODBC](odbc-driver-windows-how-to-install.md).
1. Klik dua kali file unduhan RSQL untuk menjalankan penginstal, lalu ikuti petunjuk untuk menyelesaikan instalasi.
# Log perubahan Amazon Redshift RSQL
*1.1.2 (2025-12-11)*
Perbaikan Bug
+ Memperbaiki bug yang menyebabkan kegagalan dengan perintah\$1 goto dan\$1 label.
+ Memperbaiki bug yang mencegah RSQL mencetak nilai variabel saat variabel diapit tanda kutip.
+ Memperbaiki bug yang menyebabkan RSQL crash saat hasil kueri melebihi ukuran parameter ODBC DSN Fetch saat diaktifkan. UseDeclareFetch
+ Memperbaiki masalah di mana beberapa halaman hasil dikembalikan sekaligus meskipun pager diaktifkan.
+ Memperbaiki bug yang memicu crash RSQL saat kueri gagal dalam blok transaksi.
*1.1.1 (2025-11-20)*
Perbaikan Bug
+ Memperbaiki masalah di mana RSQL salah mengurai kueri saat menggunakan flag -c. Perbaikan ini berlaku untuk semua platform.
+ Perbaiki bug di Mac yang mencegah pengguna menggunakan perintah\$1 s di RSQL.
*1.1.0 (2025-11-11)*
Perbaikan Bug
+ Menyelesaikan masalah kebocoran memori yang menyebabkan crash tak terduga di RSQL.
+ Dihapus ketergantungan OpenSSL dari RSQL.
+ Konflik penautan tetap dengan libpq/psql instalasi di lingkungan yang sama.
+ Kompatibilitas platform yang ditingkatkan untuk Amazon Linux 2023, Windows, dan macOS.
+ Memperbaiki masalah di mana output akan terpotong saat melebihi ukuran tampilan saat ini.
*1.0.8 (2023-06-19)*
Perbaikan Bug
+ Memperbaiki masalah saat output terpotong dengan perintah SHOW.
+ Menambahkan dukungan ke\$1 de untuk menjelaskan aliran Kinesis eksternal dan topik Kafka.
*1.0.7 (2023-03-22)*
Perbaikan Bug
+ Memperbaiki masalah di mana RSQL tidak dapat menggambarkan tampilan terwujud.
+ Memperbaiki kesalahan penolakan izin pada stl\$1connection\$1log saat menggunakan Amazon Redshift Serverless.
+ Memperbaiki masalah di mana RSQL dapat memproses label\$1 GOTO secara tidak benar.
+ Memperbaiki masalah saat pesan SSL dicetak dalam mode senyap.
+ Memperbaiki masalah dengan karakter acak yang ditampilkan saat menjelaskan prosedur yang disimpan.
+ Memperbaiki masalah dengan mencetak ERROR/INFO pesan duplikat.
Baru
+ RSQL sekarang mendapatkan informasi SSL langsung dari driver ODBC.
*1.0.6 (2023-02-21)*
Perbaikan Bug
+ Memperbaiki masalah di mana\$1 d melempar kesalahan - sintaks input tidak valid untuk integer: “xid” - pada patch Redshift 1.0.46086 (P173).
Baru
+ Berganti nama file instalasi untuk mencerminkan arsitektur yang didukung.
*1.0.5 (2022-06-27)*
Perbaikan Bug
+ Kirim pesan kesalahan SQL ke kesalahan standar (stderr).
+ Memperbaiki masalah dengan kode keluar saat menggunakan ON\$1ERROR\$1STOP. Skrip sekarang berakhir setelah mengalami kesalahan dan mengembalikan kode keluar yang benar.
+ Maxerror sekarang tidak peka huruf besar/kecil.
Baru
+ Menambahkan dukungan untuk driver ODBC 2.x.
*1.0.4 (2022-03-19)*
+ Tambahkan dukungan untuk variabel lingkungan RSPASSWORD. Tetapkan kata sandi untuk terhubung ke Amazon Redshift. Misalnya, `export RSPASSWORD=TestPassw0rd`.
*1.0.3 (2021-12-08)*
Perbaikan Bug
+ Dialog tetap muncul saat menggunakan `\c` atau `\logon` beralih antar database di OS Windows.
+ Memperbaiki kerusakan saat memeriksa informasi ssl.
## Amazon Redshift RSQL versi sebelumnya
Pilih salah satu tautan untuk mengunduh versi Amazon Redshift RSQL yang Anda butuhkan, berdasarkan sistem operasi Anda.
**Linux 64-bit RPM**
+ [RSQL Versi 1.1.1](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.1/AmazonRedshiftRsql-1.1.1.rhel.x86_64.rpm)
+ [RSQL Versi 1.1.0](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.0/AmazonRedshiftRsql-1.1.0.rhel.x86_64.rpm)
+ [RSQL Versi](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.8/AmazonRedshiftRsql-1.0.8.x86_64.rpm)
+ [RSQL Versi](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.7/AmazonRedshiftRsql-1.0.7.x86_64.rpm)
+ [RSQL Versi](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.6/AmazonRedshiftRsql-1.0.6.x86_64.rpm)
+ [RSQL Versi 1.0.5](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.5/AmazonRedshiftRsql-1.0.5-1.x86_64.rpm)
+ [RSQL Versi](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.4/AmazonRedshiftRsql-1.0.4-1.x86_64.rpm)
+ [RSQL Versi 1.0.3](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.3/AmazonRedshiftRsql-1.0.3-1.x86_64.rpm) [ 64-bit RSQL Versi 1.0.3]( https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/amazon-redshift-rsql/1.0.3/AmazonRedshiftRsql-1.0.3-1.x86_64.rpm)
+ [RSQL Versi 1.0.1](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.1/AmazonRedshiftRsql-1.0.1-1.x86_64.rpm) [ 64-bit RSQL Versi 1.0.1]( https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/amazon-redshift-rsql/1.0.1/AmazonRedshiftRsql-1.0.1-1.x86_64.rpm)
**Mac OS 64-bit DMG/PKG**
+ [RSQL Versi 1.1.1](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.1/AmazonRedshiftRsql-1.1.1.universal.pkg)
+ [RSQL Versi 1.1.0](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.0/AmazonRedshiftRsql-1.1.0.universal.pkg)
+ [RSQL Versi](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.8/AmazonRedshiftRsql-1.0.8.x86_64.dmg)
+ [RSQL Versi](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.7/AmazonRedshiftRsql-1.0.7.x86_64.dmg)
+ [RSQL Versi](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.6/AmazonRedshiftRsql-1.0.6.x86_64.dmg)
+ [RSQL Versi 1.0.5](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.5/AmazonRedshiftRsql-1.0.5.dmg) [ 64-bit RSQL Versi 1.0.5](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/amazon-redshift-rsql/1.0.5/AmazonRedshiftRsql-1.0.5.dmg)
+ [RSQL Versi 1.0.4 Di](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.4/AmazonRedshiftRsql-1.0.4.dmg) [: 64-bit RSQL Versi 1.0.4](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/amazon-redshift-rsql/1.0.4/AmazonRedshiftRsql-1.0.4.dmg)
+ [RSQL Versi 1.0.3](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.3/AmazonRedshiftRsql-1.0.3.dmg) [ 64-bit RSQL Versi 1.0.3](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/amazon-redshift-rsql/1.0.3/AmazonRedshiftRsql-1.0.3.dmg)
+ [RSQL Versi 1.0.1](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.1/AmazonRedshiftRsql-1.0.1.dmg) [ 64-bit RSQL Versi 1.0.1](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/amazon-redshift-rsql/1.0.1/AmazonRedshiftRsql-1.0.1.dmg)
**Windows 64-bit MSI**
+ [RSQL Versi 1.1.1](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.1/AmazonRedshiftRsql-1.1.1.x86_64.msi)
+ [RSQL Versi 1.1.0](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.1.0/AmazonRedshiftRsql-1.1.0.x86_64.msi)
+ [RSQL Versi](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.8/AmazonRedshiftRsql-1.0.8.x86_64.msi)
+ [RSQL Versi](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.7/AmazonRedshiftRsql-1.0.7.x86_64.msi)
+ [RSQL Versi](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.6/AmazonRedshiftRsql-1.0.6.x86_64.msi)
+ [RSQL Versi 1.0.5](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.5/AmazonRedshiftRsql-1.0.5.msi)
+ [RSQL Versi](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.4/AmazonRedshiftRsql-1.0.4.msi)
+ [RSQL Versi 1.0.3](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.3/AmazonRedshiftRsql-1.0.3.msi) [ 64-bit RSQL Versi 1.0.3](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/amazon-redshift-rsql/1.0.3/AmazonRedshiftRsql-1.0.3.msi)
+ [RSQL Versi 1.0.1](https://s3.amazonaws.com/redshift-downloads/amazon-redshift-rsql/1.0.1/AmazonRedshiftRsql-1.0.1.msi) [ 64-bit RSQL Versi 1.0.1](https://s3---cn-north-1.amazonaws.com.rproxy.govskope.us.cn/redshift-downloads-cn/amazon-redshift-rsql/1.0.1/AmazonRedshiftRsql-1.0.1.msi)
# Connect ke cluster dengan Amazon Redshift RSQL
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
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 -U -d -p
```
Di sini, berikut ini berlaku:
+ **adalah **Endpoint** yang Anda rekam pada langkah sebelumnya.
+ **adalah nama pengguna dengan izin untuk terhubung ke cluster.
+ **adalah **Nama Database** yang Anda rekam pada langkah sebelumnya.
+ **adalah **Port** yang Anda rekam pada langkah sebelumnya. **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 ** 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
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
Berikut ini menunjukkan contoh konfigurasi koneksi DSN yang menggunakan kata sandi. Default `` 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=
Port=
Database=
UID=
PWD=
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
Anda dapat mengonfigurasi DSN untuk otentikasi masuk tunggal. Berikut ini menunjukkan contoh konfigurasi koneksi DSN yang menggunakan tanda tunggal Okta.
```
[testokta]
Driver=
SSLMode=verify-ca
Min_TLS=1.2
boolsaschar=0
Host=
clusterid=
region=
Database=
locale=en-US
iam=1
plugin_name=
uid=
pwd=
idp_host=
app_id=
app_name=
preferred_role=
```
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=
SSLMode=verify-ca
Min_TLS=1.2
boolsaschar=0
Host=
Port=
clusterid=
region=
Database=
locale=en-us
iam=1
plugin_name=
uid=
pwd=
idp_tenant=
client_id=
client_secret=
```
### Menggunakan koneksi DSN dengan profil IAM
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
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
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
```
# Perintah meta Amazon Redshift RSQL
Perintah meta Amazon Redshift RSQL mengembalikan catatan informasi tentang database atau objek database tertentu. Hasil dapat mencakup berbagai kolom dan metadata. Perintah lain melakukan tindakan tertentu. Perintah ini didahului dengan garis miring terbalik.
## \$1 d [S \$1]
Daftar tabel buatan pengguna lokal, tampilan reguler, tampilan yang mengikat akhir, dan tampilan terwujud. `\dS `juga mencantumkan tabel dan tampilan`\d`, seperti, tetapi objek sistem disertakan dalam catatan yang dikembalikan. `+`Hasil di kolom metadata tambahan `description` untuk semua objek yang terdaftar. Berikut ini menunjukkan catatan sampel dikembalikan sebagai hasil dari perintah.
```
List of relations
schema | name | type | owner
--------+-----------+-------+---------
public | category | table | awsuser
public | date | table | awsuser
public | event | table | awsuser
public | listing | table | awsuser
public | sales | table | awsuser
public | users | table | awsuser
public | venue | table | awsuser
(7 rows)
```
## \$1 d [S\$1] NAMA
Menjelaskan tabel, tampilan, atau indeks. Termasuk nama kolom dan jenis. Ini juga menyediakan diststyle, konfigurasi cadangan, membuat tanggal (tabel dibuat setelah Oktober 2018), dan kendala. Misalnya, `\dS+ sample` mengembalikan properti objek. Menambahkan `S+` hasil di kolom tambahan termasuk dalam catatan yang dikembalikan.
```
Table "public.sample"
Column | Type | Collation | Nullable | Default Value | Encoding | DistKey | SortKey
--------+-----------------------------+----------------+----------+---------------+-----------+---------+---------
col1 | smallint | | NO | | none | t | 1
col2 | character(100) | case_sensitive | YES | | none | f | 2
col3 | character varying(100) | case_sensitive | YES | | text32k | f | 3
col4 | timestamp without time zone | | YES | | runlength | f | 0
col5 | super | | YES | | zstd | f | 0
col6 | bigint | | YES | | az64 | f | 0
Diststyle: KEY
Backup: YES
Created: 2021-07-20 19:47:27.997045
Unique Constraints:
"sample_pkey" PRIMARY KEY (col1)
"sample_col2_key" UNIQUE (col2)
Foreign-key constraints:
"sample_col2_fkey" FOREIGN KEY (col2) REFERENCES lineitem(l_orderkey)
```
Gaya distribusi, atau *Diststyle*, dari tabel bisa KEY, AUTO, EVEN atau ALL.
*Backup* menunjukkan apakah tabel dicadangkan saat snapshot diambil. Nilai-nilai yang valid adalah `YES` atau `NO`.
*Dibuat* adalah stempel waktu untuk saat tabel dibuat. Tanggal pembuatan tidak tersedia untuk tabel Amazon Redshift yang dibuat sebelum November 2018. Tabel yang dibuat sebelum tanggal ini ditampilkan n/a (Tidak Tersedia).
Kendala *Unik mencantumkan kendala* kunci unik dan primer di atas meja.
*Kendala kunci asing mencantumkan kendala* kunci asing di atas meja.
## \$1 dC [\$1] [POLA]
Daftar gips. Termasuk jenis sumber, tipe target, dan apakah pemeran itu implisit.
Berikut ini menunjukkan subset hasil dari`\dC+`.
```
List of casts
source type | target type | function | implicit? | description
-----------------------------+-----------------------------+---------------------+---------------+-------------
"char" | character | bpchar | in assignment |
"char" | character varying | text | in assignment |
"char" | integer | int4 | no |
"char" | text | text | yes |
"path" | point | point | no |
"path" | polygon | polygon | in assignment |
abstime | date | date | in assignment |
abstime | integer | (binary coercible) | no |
abstime | time without time zone | time | in assignment |
abstime | timestamp with time zone | timestamptz | yes |
abstime | timestamp without time zone | timestamp | yes |
bigint | bit | bit | no |
bigint | boolean | bool | yes |
bigint | character | bpchar | in assignment |
bigint | character varying | text | in assignment |
bigint | double precision | float8 | yes |
bigint | integer | int4 | in assignment |
bigint | numeric | numeric | yes |
bigint | oid | oid | yes |
bigint | real | float4 | yes |
bigint | regclass | oid | yes |
bigint | regoper | oid | yes |
bigint | regoperator | oid | yes |
bigint | regproc | oid | yes |
bigint | regprocedure | oid | yes |
bigint | regtype | oid | yes |
bigint | smallint | int2 | in assignment |
bigint | super | int8_partiql | in assignment |
```
## \$1 dd [S] [POLA]
Menampilkan deskripsi objek yang tidak ditampilkan di tempat lain.
## \$1 de
Daftar tabel eksternal. Ini termasuk tabel di AWS Glue Data Catalog, Hive Metastore dan tabel federasi dari Amazon MySQL, Amazon PostgreSQL, dan tabel data RDS/Aurora Amazon Redshift. RDS/Aurora
## \$1 NAMA
Menjelaskan tabel eksternal.
Contoh berikut menunjukkan tabel AWS Glue eksternal.
```
# \de spectrum.lineitem
Glue External table "spectrum.lineitem"
Column | External Type | Redshift Type | Position | Partition Key | Nullable
-----------------+---------------+---------------+----------+---------------+----------
l_orderkey | bigint | bigint | 1 | 0 |
l_partkey | bigint | bigint | 2 | 0 |
l_suppkey | int | int | 3 | 0 |
l_linenumber | int | int | 4 | 0 |
l_quantity | decimal(12,2) | decimal(12,2) | 5 | 0 |
l_extendedprice | decimal(12,2) | decimal(12,2) | 6 | 0 |
l_discount | decimal(12,2) | decimal(12,2) | 7 | 0 |
l_tax | decimal(12,2) | decimal(12,2) | 8 | 0 |
l_returnflag | char(1) | char(1) | 9 | 0 |
l_linestatus | char(1) | char(1) | 10 | 0 |
l_shipdate | date | date | 11 | 0 |
l_commitdate | date | date | 12 | 0 |
l_receiptdate | date | date | 13 | 0 |
l_shipinstruct | char(25) | char(25) | 14 | 0 |
l_shipmode | char(10) | char(10) | 15 | 0 |
l_comment | varchar(44) | varchar(44) | 16 | 0 |
Location: s3://redshiftbucket/kfhose2019/12/31
Input_format: org.apache.hadoop.mapred.TextInputFormat
Output_format: org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat
Serialization_lib: org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe
Serde_parameters: {"field.delim":"|","serialization.format":"|"}
Parameters: {"EXTERNAL":"TRUE","numRows":"178196721475","transient_lastDdlTime":"1577771873"}
```
Meja Hive Metastore.
```
# \de emr.lineitem
Hive Metastore External Table "emr.lineitem"
Column | External Type | Redshift Type | Position | Partition Key | Nullable
-----------------+---------------+---------------+----------+---------------+----------
l_orderkey | bigint | bigint | 1 | 0 |
l_partkey | bigint | bigint | 2 | 0 |
l_suppkey | int | int | 3 | 0 |
l_linenumber | int | int | 4 | 0 |
l_quantity | decimal(12,2) | decimal(12,2) | 5 | 0 |
l_extendedprice | decimal(12,2) | decimal(12,2) | 6 | 0 |
l_discount | decimal(12,2) | decimal(12,2) | 7 | 0 |
l_tax | decimal(12,2) | decimal(12,2) | 8 | 0 |
l_returnflag | char(1) | char(1) | 9 | 0 |
l_linestatus | char(1) | char(1) | 10 | 0 |
l_commitdate | date | date | 11 | 0 |
l_receiptdate | date | date | 12 | 0 |
l_shipinstruct | char(25) | char(25) | 13 | 0 |
l_shipmode | char(10) | char(10) | 14 | 0 |
l_comment | varchar(44) | varchar(44) | 15 | 0 |
l_shipdate | date | date | 16 | 1 |
Location: s3://redshiftbucket/cetas
Input_format: org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat
Output_format: org.apache.hadoop.hive.ql.io.parquet.MapredParquetOutputFormat
Serialization_lib: org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe
Serde_parameters: {"serialization.format":"1"}
Parameters: {"EXTERNAL":"TRUE", "numRows":"4307207", "transient_lastDdlTime":"1626990007"}
```
PostgreSQL tabel eksternal.
```
# \de pgrsql.alltypes
Postgres Federated Table "pgrsql.alltypes"
Column | External Type | Redshift Type | Position | Partition Key | Nullable
--------+-----------------------------+-----------------------------+----------+---------------+----------
col1 | bigint | bigint | 1 | 0 |
col2 | bigint | bigint | 2 | 0 |
col5 | boolean | boolean | 3 | 0 |
col6 | box | varchar(65535) | 4 | 0 |
col7 | bytea | varchar(65535) | 5 | 0 |
col8 | character(10) | character(10) | 6 | 0 |
col9 | character varying(10) | character varying(10) | 7 | 0 |
col10 | cidr | varchar(65535) | 8 | 0 |
col11 | circle | varchar(65535) | 9 | 0 |
col12 | date | date | 10 | 0 |
col13 | double precision | double precision | 11 | 0 |
col14 | inet | varchar(65535) | 12 | 0 |
col15 | integer | integer | 13 | 0 |
col16 | interval | varchar(65535) | 14 | 0 |
col17 | json | varchar(65535) | 15 | 0 |
col18 | jsonb | varchar(65535) | 16 | 0 |
col19 | line | varchar(65535) | 17 | 0 |
col20 | lseg | varchar(65535) | 18 | 0 |
col21 | macaddr | varchar(65535) | 19 | 0 |
col22 | macaddr8 | varchar(65535) | 20 | 0 |
col23 | money | varchar(65535) | 21 | 0 |
col24 | numeric | numeric(38,20) | 22 | 0 |
col25 | path | varchar(65535) | 23 | 0 |
col26 | pg_lsn | varchar(65535) | 24 | 0 |
col28 | point | varchar(65535) | 25 | 0 |
col29 | polygon | varchar(65535) | 26 | 0 |
col30 | real | real | 27 | 0 |
col31 | smallint | smallint | 28 | 0 |
col32 | smallint | smallint | 29 | 0 |
col33 | integer | integer | 30 | 0 |
col34 | text | varchar(65535) | 31 | 0 |
col35 | time without time zone | varchar(65535) | 32 | 0 |
col36 | time with time zone | varchar(65535) | 33 | 0 |
col37 | timestamp without time zone | timestamp without time zone | 34 | 0 |
col38 | timestamp with time zone | timestamp with time zone | 35 | 0 |
col39 | tsquery | varchar(65535) | 36 | 0 |
col40 | tsvector | varchar(65535) | 37 | 0 |
col41 | txid_snapshot | varchar(65535) | 38 | 0 |
col42 | uuid | varchar(65535) | 39 | 0 |
col43 | xml | varchar(65535) | 40 | 0 |
```
## \$1 df [anptw] [S\$1] [POLA]
Daftar fungsi dari berbagai jenis. Perintah`\df`, misalnya, mengembalikan daftar fungsi. Hasil mencakup properti seperti nama, tipe data yang dikembalikan, hak akses, dan metadata tambahan. Jenis fungsi dapat mencakup pemicu, prosedur tersimpan, fungsi jendela, dan jenis lainnya. Ketika Anda menambahkan `S+` ke perintah, misalnya`\dfantS+`, kolom metadata tambahan disertakan, seperti`owner`,, dan. `security` `access privileges`
## \$1 dL [S\$1] [POLA]
Daftar data tentang bahasa prosedural yang terkait dengan database. Informasi mencakup nama, seperti plpgsql, dan metadata tambahan, yang mencakup apakah itu tepercaya, hak akses, dan deskripsi. Contoh panggilan, misalnya`\dLS+`, yang mencantumkan bahasa dan propertinya. Ketika Anda menambahkan `S+` ke perintah, kolom metadata tambahan disertakan, seperti dan. `call handler` `access privileges`
Hasil sampel:
```
List of languages
name | trusted | internal language | call handler | validator | access privileges | description
-----------+---------+-------------------+-------------------------+------------------------------------------------------------+-------------------+--------------------------------
c | f | t | - | fmgr_c_validator(oid) | | Dynamically-loaded C functions
exfunc | f | f | exfunc_call_handler() | - | rdsdb=U/rdsdb |
internal | f | t | - | fmgr_internal_validator(oid) | | Built-in functions
mlfunc | f | f | mlfunc_call_handler() | - | rdsdb=U/rdsdb |
plpgsql | t | f | plpgsql_call_handler() | plpgsql_validator(oid) | |
plpythonu | f | f | plpython_call_handler() | plpython_compiler(cstring,cstring,cstring,cstring,cstring) | rdsdb=U/rdsdb |
sql | t | t | - | fmgr_sql_validator(oid) | =U/rdsdb | SQL-language functions
```
## \$1 dm [S\$1] [POLA]
Daftar tampilan terwujud. Misalnya, `\dmS+` daftar tampilan terwujud dan propertinya. Saat Anda menambahkan `S+` ke perintah, kolom metadata tambahan disertakan.
## \$1 dn [S\$1] [POLA]
Daftar skema. Ketika Anda menambahkan `S+` ke perintah, misalnya`\dnS+`, kolom metadata tambahan disertakan, seperti dan. `description` `access privileges`
## \$1 dp [POLA]
Daftar hak akses tabel, tampilan, dan urutan.
## \$1 dt [S\$1] [POLA]
Daftar tabel. Ketika Anda menambahkan `S+` ke perintah, misalnya`\dtS+`, kolom metadata tambahan disertakan, seperti `description` dalam kasus ini.
## \$1 du
Daftar pengguna untuk database. Termasuk nama dan peran mereka, seperti Superuser, dan atribut.
## \$1 dv [S\$1] [POLA]
Daftar tampilan. Termasuk skema, jenis, dan data pemilik. Ketika Anda menambahkan `S+` ke perintah, misalnya`\dvS+`, kolom metadata tambahan disertakan.
## \$1 H
Menghidupkan output HTML. Ini berguna untuk mengembalikan hasil yang diformat dengan cepat. Misalnya, `select * from sales; \H` mengembalikan hasil dari tabel penjualan, dalam HTML. Untuk beralih kembali ke hasil tablular, gunakan`\q`, atau diam.
## \$1 saya
Menjalankan perintah dari file. Misalnya, dengan asumsi Anda memiliki rsql\$1steps.sql di direktori kerja Anda, berikut ini menjalankan perintah dalam file:`\i rsql_steps.sql`.
## \$1 l [\$1] [POLA]
Daftar database. Termasuk pemilik, pengkodean, dan informasi tambahan.
## \$1 q
Keluar, atau `\q` perintah, log off sesi database dan keluar dari RSQL.
## \$1 sv [\$1] NAMA TAMPILAN
Menunjukkan definisi tampilan.
## \$1 waktu
Menunjukkan waktu berjalan, untuk kueri, misalnya.
## \$1 z [POLA]
Output yang sama dengan\$1 dp.
## \$1?
Menampilkan informasi bantuan. Parameter opsional menentukan item untuk menjelaskan.
## \$1 KELUAR
Log off semua sesi database dan keluar dari Amazon Redshift RSQL. Selain itu, Anda dapat menentukan kode keluar opsional. Misalnya, `\EXIT 15` akan keluar dari terminal Amazon Redshift RSQL dan mengembalikan kode keluar 15.
Contoh berikut menunjukkan output dari koneksi dan keluar dari RSQL.
```
% rsql -D testuser
DSN Connected
DBMS Name: Amazon Redshift
Driver Name: Amazon Redshift ODBC Driver
Driver Version: 1.4.34.1000
Rsql Version: 1.0.1
Redshift Version: 1.0.29306
Type "help" for help.
(testcluster) user1@dev=# \exit 15
% echo $?
15
```
## \$1 EKSPOR
Menentukan nama file ekspor yang RSQL gunakan untuk menyimpan informasi database yang dikembalikan oleh pernyataan SQL SELECT berikutnya.
export\$101.sql
```
\export report file='E:\\accounts.out'
\rset rformat off
\rset width 1500
\rset heading "General Title"
\rset titledashes on
select * from td_dwh.accounts;
\export reset
```
Keluaran konsol
```
Rformat is off.
Target width is 1500.
Heading is set to: General Title
Titledashes is on.
(exported 40 rows)
```
## \$1 MASUK
Terhubung ke database. Anda dapat menentukan parameter koneksi menggunakan sintaks posisi atau sebagai string koneksi.
Sintaks perintah adalah sebagai berikut: `\logon {[DBNAME|- USERNAME|- HOST|- PORT|- [PASSWORD]] | conninfo}`
`DBNAME`Ini adalah nama database untuk terhubung ke. `USERNAME`Itu adalah nama pengguna untuk terhubung sebagai. `HOST`Defaultnya adalah`localhost`. `PORT`Defaultnya adalah`5439`.
Ketika nama host ditentukan dalam `\LOGON` perintah, itu menjadi nama host default untuk `\LOGON` perintah tambahan. Untuk mengubah nama host default, tentukan yang baru `HOST` dalam `\LOGON` perintah tambahan.
Contoh output dari `\LOGON` perintah untuk `user1` berikut.
```
(testcluster) user1@redshiftdb=# \logon dev
DBMS Name: Amazon Redshift
Driver Name: Amazon Redshift ODBC Driver
Driver Version: 1.4.27.1000
Rsql Version: 1.0.1
You are now connected to database "dev" as user "user1".
(testcluster) user1@dev=#
```
Output sampel untuk *pengguna2*.
```
(testcluster) user1@dev=# \logon dev user2 testcluster2.example.com
Password for user user2:
DBMS Name: Amazon Redshift
Driver Name: Amazon Redshift ODBC Driver
Driver Version: 1.4.27.1000
Rsql Version: 1.0.1
You are now connected to database "dev" as user "user2" on host "testcluster2.example.com" at port "5439".
(testcluster2) user2@dev=#
```
## \$1 KOMENTAR
Perpanjangan `\echo` perintah. `\REMARK`mencetak string yang ditentukan ke aliran output. `\REMARK `meluas `\echo` dengan menambahkan kemampuan untuk memecah output melalui jalur terpisah.
Contoh berikut menunjukkan output dari perintah.
```
(testcluster) user1@dev=# \remark 'hello//world'
hello
world
```
## \$1 RSET
Perintah `\rset` menetapkan parameter perintah dan variabel. `\rset`memiliki mode interaktif dan batch. Itu tidak mendukung opsi sebagai opsi bash, seperti *-x*, atau argumen, misalnya *--*.
Ini menetapkan variabel, seperti berikut ini:
+ TINGKAT KESALAHAN
+ HEADING dan RTITLE
+ RFORMAT
+ MAXERROR
+ TITLEDASHES
+ LEBAR
Contoh berikut menentukan judul.
```
\rset heading "Winter Sales Report"
```
Untuk lebih banyak contoh cara menggunakan`\rset`, Anda dapat menemukan beberapa [Variabel Amazon Redshift RSQL](rsql-query-tool-variables.md) topik.
## \$1 LARI
Menjalankan skrip Amazon Redshift RSQL yang terdapat dalam file yang ditentukan. `\RUN`memperluas `\i` perintah dengan menambahkan opsi untuk melewati baris header dalam file.
Jika nama file menyertakan koma, titik koma, atau spasi, lampirkan dalam tanda kutip tunggal. Selain itu, jika teks mengikuti nama file, lampirkan dalam tanda kutip. Di UNIX, nama file peka huruf besar/kecil. Di Windows, nama file tidak peka huruf besar/kecil.
Contoh berikut menunjukkan output dari perintah.
```
(testcluster) user1@dev=# \! cat test.sql
select count(*) as lineitem_cnt from lineitem;
select count(*) as customer_cnt from customer;
select count(*) as orders_cnt from orders;
(testcluster) user1@dev=# \run file=test.sql
lineitem_cnt
--------------
4307207
(1 row)
customer_cnt
--------------
37796166
(1 row)
orders_cnt
------------
0
(1 row)
(testcluster) user1@dev=# \run file=test.sql skip=2
2 records skipped in RUN file.
orders_cnt
------------
0
(1 row)
```
## \$1 OS
Sebuah alias untuk `\!` perintah. `\OS`menjalankan perintah sistem operasi yang diteruskan sebagai parameter. Kontrol kembali ke Amazon Redshift RSQL setelah perintah dijalankan. Misalnya, Anda dapat menjalankan perintah berikut untuk mencetak waktu tanggal sistem saat ini dan kembali ke terminal RSQL:. `\os date`
```
(testcluster) user1@dev=# \os date
Tue Sep 7 20:47:54 UTC 2021
```
## \$1 GOTO
Perintah baru untuk Amazon Redshift RSQL. `\GOTO`melewatkan semua perintah intervensi dan melanjutkan pemrosesan pada yang ditentukan. `\LABEL` `\LABEL`Harus menjadi referensi ke depan. Anda tidak dapat melompat ke `\LABEL` yang secara leksikal mendahului. `\GOTO`
Berikut menampilkan contoh output.
```
(testcluster) user1@dev=# \! cat test.sql
select count(*) as cnt from lineitem \gset
select :cnt as cnt;
\if :cnt > 100
\goto LABELB
\endif
\label LABELA
\remark 'this is label LABELA'
\label LABELB
\remark 'this is label LABELB'
(testcluster) user1@dev=# \i test.sql
cnt
---------
4307207
(1 row)
\label LABELA ignored
\label LABELB processed
this is label LABELB
```
## \$1 LABEL
Perintah baru untuk Amazon Redshift RSQL. `\LABEL`menetapkan titik masuk untuk menjalankan program, sebagai target untuk `\GOTO` perintah.
Berikut ini menunjukkan contoh output dari perintah.
```
(testcluster) user1@dev=# \! cat test.sql
select count(*) from lineitem limit 5;
\goto LABELB
\remark "this step was skipped by goto label";
\label LABELA
\remark 'this is label LABELA'
\label LABELB
\remark 'this is label LABELB'
(testcluster) user1@dev=# \i testgoto.sql
count
4307193
(1 row)
\label LABELA ignored
\label LABELB processed
this is label LABELB
```
## \$1 IF (\$1 ELSEIF,\$1 ELSE,\$1 ENDIF)
`\IF`dan perintah terkait menjalankan bagian dari skrip input secara kondisional. Perpanjangan dari perintah PSQL `\if` (`\elif`,`\else`,`\endif`). `\IF`dan `\ELSEIF` mendukung ekspresi boolean termasuk`AND`, `OR` dan `NOT` kondisi.
Berikut ini menunjukkan contoh output dari perintah.
```
(testcluster) user1@dev=# \! cat test.sql
SELECT query FROM stv_inflight LIMIT 1 \gset
select :query as query;
\if :query > 1000000
\remark 'Query id is greater than 1000000'
\elseif :query = 1000000
\remark 'Query id is equal than 1000000'
\else
\remark 'Query id is less than 1000000'
\endif
(testcluster) user1@dev=# \i test.sql
query
--------
994803
(1 row)
Query id is less than 1000000
```
Gunakan `ERRORCODE` dalam logika percabangan Anda.
```
\if :'ERRORCODE' = '00000'
\remark 'The statement was executed without error'
\else
\remark :LAST_ERROR_MESSAGE
\endif
```
Gunakan `\GOTO` dalam `\IF` blok untuk mengontrol bagaimana kode dijalankan.
# Variabel Amazon Redshift RSQL
Beberapa kata kunci bertindak sebagai variabel dalam RSQL. Anda dapat mengatur masing-masing ke nilai tertentu, atau mengatur ulang nilainya. Sebagian besar diatur dengan`\rset`, yang memiliki mode interaktif dan mode batch. Perintah dapat didefinisikan dalam huruf kecil atau huruf besar.
## JUMLAH AKTIVITAS
Menunjukkan jumlah baris yang dipengaruhi oleh permintaan terakhir yang dikirimkan. Untuk permintaan pengembalian data, ini adalah jumlah baris yang dikembalikan ke RSQL dari database. Nilainya adalah 0 atau bilangan bulat positif. Nilai maksimum adalah 18.446.744.073.709.551.615.
Variabel `ACTIVITYCOUNT` yang diperlakukan secara khusus mirip dengan variabel`ROW_COUNT`. Namun, `ROW_COUNT` tidak melaporkan jumlah baris yang terpengaruh ke aplikasi klien pada penyelesaian perintah untuk`SELECT`, `COPY` atau`UNLOAD`. Tapi `ACTIVITYCOUNT` tidak.
activitycount\$101.sql:
```
select viewname, schemaname
from pg_views
where schemaname = 'not_existing_schema';
\if :ACTIVITYCOUNT = 0
\remark 'views do not exist'
\endif
```
Keluaran konsol:
```
viewname | schemaname
----------+------------
(0 rows)
views do not exist
```
## TINGKAT KESALAHAN
Menetapkan tingkat keparahan untuk kesalahan. Gunakan tingkat keparahan untuk menentukan tindakan. Jika `ERRORLEVEL` perintah belum digunakan, nilainya secara `ON` default.
errorlevel\$101.sql:
```
\rset errorlevel 42P01 severity 0
select * from tbl;
select 1 as col;
\echo exit
\quit
```
Keluaran konsol:
```
Errorlevel is on.
rsql: ERROR: relation "tbl" does not exist
(1 row)
col
1
exit
```
## HEADING dan RTITLE
Memungkinkan pengguna untuk menentukan header yang muncul di bagian atas laporan. Header yang ditentukan oleh `RSET RTITLE` perintah secara otomatis menyertakan tanggal sistem saat ini dari komputer klien.
konten rset\$1heading\$1rtitle\$102.rsql:
```
\remark Starting...
\rset rtitle "Marketing Department||Confidential//Third Quarter//Chicago"
\rset width 70
\rset rformat on
select * from rsql_test.tbl_currency order by id limit 2;
\exit
\remark Finishing...
```
Keluaran konsol:
```
Starting...
Rtitle is set to: &DATE||Marketing Department||Confidential//Third Quarter//Chicago (Changes will take effect after RFORMAT is
switched ON)
Target width is 70.
Rformat is on.
09/11/20 Marketing Department Confidential
Third Quarter
Chicago
id | bankid | name | start_date
100 | 1 | USD | 2020-09-11 10:51:39.106905
110 | 1 | EUR | 2020-09-11 10:51:39.106905
(2 rows)
Press any key to continue . . .
```
## MAXERROR
Menentukan tingkat keparahan kesalahan maksimum di luar mana RSQL menghentikan pemrosesan pekerjaan. Kode pengembalian adalah nilai integer yang RSQL kembali ke sistem operasi klien setelah menyelesaikan setiap pekerjaan atau tugas. Nilai kode pengembalian menunjukkan status penyelesaian pekerjaan atau tugas. Jika skrip berisi pernyataan yang menghasilkan tingkat keparahan kesalahan lebih besar dari `maxerror` nilai yang ditentukan, RSQL segera keluar. Oleh karena itu, untuk memiliki RSQL keluar pada tingkat keparahan kesalahan 8, gunakan. `RSET MAXERROR 7`
konten maxerror\$101.sql:
```
\rset maxerror 0
select 1 as col;
\quit
```
Keluaran konsol:
```
Maxerror is default.
(1 row)
col
1
```
## RFORMAT
Memungkinkan pengguna untuk menentukan apakah akan menerapkan pengaturan untuk perintah pemformatan.
konten rset\$1rformat.rsql:
```
\remark Starting...
\pset border 2
\pset format wrapped
\pset expanded on
\pset title 'Great Title'
select * from rsql_test.tbl_long where id = 500;
\rset rformat
select * from rsql_test.tbl_long where id = 500;
\rset rformat off
select * from rsql_test.tbl_long where id = 500;
\rset rformat on
select * from rsql_test.tbl_long where id = 500;
\exit
\remark Finishing...
```
Keluaran konsol:
```
Starting...
Border style is 2. (Changes will take effect after RFORMAT is switched ON)
Output format is wrapped. (Changes will take effect after RFORMAT is switched ON)
Expanded display is on. (Changes will take effect after RFORMAT is switched ON)
Title is "Great Title". (Changes will take effect after RFORMAT is switched ON)
id | long_string
500 | In general, the higher the number the more borders and lines the tables will have, but details depend on the particular
format.
(1 row)
Rformat is on.
Great Title
+-[ RECORD 1 ]+----------------------------------------------------------------------------------------------------------------------
-----------+
| id | 500
|
| long_string | In general, the higher the number the more borders and lines the tables will have, but details depend on the
particular format. |
+-------------+----------------------------------------------------------------------------------------------------------------------
-----------+
Rformat is off.
id | long_string
500 | In general, the higher the number the more borders and lines the tables will have, but details depend on the particular format.
(1 row)
Rformat is on.
Great Title
+-[ RECORD 1 ]+----------------------------------------------------------------------------------------------------------------------
-----------+
| id | 500
|
| long_string | In general, the higher the number the more borders and lines the tables will have, but details depend on the
particular format. |
+-------------+----------------------------------------------------------------------------------------------------------------------
-----------+
Press any key to continue . . .
```
## ROW\$1COUNT
Mendapat jumlah catatan yang dipengaruhi oleh kueri sebelumnya. Ini biasanya digunakan untuk memeriksa hasil, seperti dalam fragmen kode berikut:
```
SET result = ROW_COUNT;
IF result = 0
...
```
## TITLEDASHES
Kontrol ini memungkinkan pengguna untuk menentukan apakah garis karakter dasbor akan dicetak di atas data kolom yang dikembalikan untuk pernyataan SQL.
Contoh:
```
\rset titledashes on
select dept_no, emp_no, salary from rsql_test.EMPLOYEE
where dept_no = 100;
\rset titledashes off
select dept_no, emp_no, salary from rsql_test.EMPLOYEE
where dept_no = 100;
```
Keluaran konsol:
```
dept_no emp_no salary
----------- ----------- --------------------
100 1000346 1300.00
100 1000245 5000.00
100 1000262 2450.00
dept_no emp_no salary
100 1000346 1300.00
100 1000245 5000.00
100 1000262 2450.00
```
## LEBAR
Menetapkan format output untuk dibungkus dan menentukan lebar target untuk setiap baris dalam laporan. Tanpa parameter, ia mengembalikan pengaturan saat ini untuk format dan lebar target.
konten rset\$1width\$101.rsql:
```
\echo Starting...
\rset width
\rset width 50
\rset width
\quit
\echo Finishing...
```
Keluaran konsol:
```
Starting...
Target width is 75.
Target width is 50.
Target width is 50.
Press any key to continue . . .
```
Contoh dengan parameter:
```
\echo Starting...
\rset rformat on
\pset format wrapped
select * from rsql_test.tbl_long where id = 500;
\rset width 50
select * from rsql_test.tbl_long where id = 500;
\quit
\echo Finishing...
```
Keluaran konsol:
```
Starting...
Rformat is on.
Output format is wrapped.
id | long_string
500 | In general, the higher the number the more borders and lines the ta.
|.bles will have, but details depend on the particular format.
(1 row)
Target width is 50.
id | long_string
500 | In general, the higher the number the more.
|. borders and lines the tables will have, b.
|.ut details depend on the particular format.
|..
(1 row)
Press any key to continue . . .
```
# Kode kesalahan Amazon Redshift RSQL
Pesan sukses, peringatan, dan pengecualian:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/rsql-query-tool-error-codes.html)
Pengecualian data:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/rsql-query-tool-error-codes.html)
Pelanggaran kendala integritas:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/redshift/latest/mgmt/rsql-query-tool-error-codes.html)
# Variabel lingkungan Amazon Redshift RSQL
Amazon Redshift RSQL dapat menggunakan variabel lingkungan untuk memilih nilai parameter default.
## RSPASSWORD
**penting**
Kami tidak menyarankan menggunakan variabel lingkungan ini untuk alasan keamanan, karena beberapa sistem operasi memungkinkan pengguna non-administratif untuk melihat variabel lingkungan proses.
Menetapkan kata sandi untuk Amazon Redshift RSQL untuk digunakan saat menghubungkan ke Amazon Redshift. Variabel lingkungan ini memerlukan Amazon Redshift RSQL 1.0.4 ke atas.
RSQL memprioritaskan RSPASSWORD jika ada yang disetel. Jika RSPASSWORD tidak disetel dan Anda terhubung menggunakan DSN, RSQL mengambil kata sandi dari parameter file DSN. Akhirnya, jika RSPASSWORD tidak diatur dan Anda tidak menggunakan DSN, RSQL menyediakan prompt kata sandi setelah mencoba untuk terhubung.
Berikut ini adalah contoh pengaturan RSPASSWORD:
```
export RSPASSWORD=TestPassw0rd
```
# Menggunakan profil otentikasi untuk terhubung ke Amazon Redshift
Jika Anda memiliki banyak koneksi ke Amazon Redshift, mungkin sulit untuk mengelola pengaturan untuk semuanya. Seringkali, setiap koneksi JDBC atau ODBC menggunakan opsi konfigurasi tertentu. Dengan menggunakan profil otentikasi, Anda dapat menyimpan opsi koneksi bersama-sama. Dengan cara ini, pengguna Anda dapat memilih profil untuk terhubung dan menghindari pengaturan pengaturan untuk opsi individual. Profil dapat diterapkan ke berbagai skenario dan jenis pengguna.
Setelah Anda membuat profil otentikasi, pengguna dapat menambahkan ready-to-use profil ke string koneksi. Dengan melakukan ini, mereka dapat terhubung ke Amazon Redshift dengan pengaturan yang tepat untuk setiap peran dan kasus penggunaan.
Untuk informasi Amazon Redshift API, lihat. [CreateAuthenticationProfile](https://docs.aws.amazon.com/redshift/latest/APIReference/redshift-api.pdf#API_CreateAuthenticationProfile)
# Membuat profil otentikasi
Menggunakan AWS CLI, Anda membuat profil otentikasi dengan `create-authentication-profile` perintah. Ini mengasumsikan bahwa Anda memiliki cluster Amazon Redshift yang sudah ada dan database yang ada. Kredensil Anda harus memiliki izin untuk terhubung ke database Amazon Redshift dan hak untuk mengambil profil otentikasi. Anda memberikan opsi konfigurasi sebagai string JSON, atau referensi file yang berisi string JSON Anda.
```
create-authentication-profile --authentication-profile-name --authentication-profile-content
```
Contoh berikut membuat profil yang disebut`ExampleProfileName`. Di sini, Anda dapat menambahkan kunci dan nilai yang menentukan nama cluster Anda dan pengaturan opsi lainnya, sebagai string JSON.
```
create-authentication-profile --authentication-profile-name "ExampleProfileName" --authentication-profile-content "{\"AllowDBUserOverride\":\"1\",\"Client_ID\":\"ExampleClientID\",\"App_ID\":\"ExampleAppID\",\"AutoCreate\":false,\"enableFetchRingBuffer\":true,\"databaseMetadataCurrentDbOnly\":true}"
}
```
Perintah ini membuat profil dengan pengaturan JSON yang ditentukan. Berikut ini dikembalikan, yang menunjukkan bahwa profil dibuat.
`{"AuthenticationProfileName": "ExampleProfileName", "AuthenticationProfileContent": "{\"AllowDBUserOverride\":\"1\",\"Client_ID\":\"ExampleClientID\",\"App_ID\":\"ExampleAppID\",\"AutoCreate\":false,\"enableFetchRingBuffer\":true,\"databaseMetadataCurrentDbOnly\":true}" } `
## Batasan dan kuota untuk membuat profil otentikasi
Setiap pelanggan memiliki kuota sepuluh (10) profil otentikasi.
Kesalahan tertentu dapat terjadi dengan profil otentikasi. Contohnya adalah jika Anda membuat profil baru dengan nama yang sudah ada, atau jika Anda melebihi kuota profil Anda. Untuk informasi selengkapnya, lihat [CreateAuthenticationProfile](https://docs.aws.amazon.com/redshift/latest/APIReference/redshift-api.pdf#API_CreateAuthenticationProfile).
Anda tidak dapat menyimpan kunci dan nilai opsi tertentu untuk string koneksi JDBC, ODBC, dan Python di toko profil otentikasi:
+ `AccessKeyID`
+ `access_key_id`
+ `SecretAccessKey`
+ `secret_access_key_id`
+ `PWD`
+ `Password`
+ `password`
Anda tidak dapat menyimpan kunci atau nilai `AuthProfile` di toko profil, untuk string koneksi JDBC atau ODBC. Untuk koneksi Python, Anda tidak dapat menyimpan. `auth_profile`
Profil otentikasi disimpan di Amazon DynamoDB dan dikelola oleh. AWS
# Menghubungkan dengan profil otentikasi
Setelah Anda membuat profil otentikasi, Anda dapat menyertakan nama profil sebagai opsi koneksi untuk JDBC versi 2.0. `AuthProfile` Menggunakan opsi koneksi ini mengambil pengaturan yang disimpan.
```
jdbc:redshift:iam://endpoint:port/database?AuthProfile=&AccessKeyID=&SecretAccessKey=
```
Berikut ini adalah contoh string URL JDBC.
```
jdbc:redshift:iam://examplecluster:us-west-2/dev?AuthProfile="ExampleProfile"&AccessKeyID="AKIAIOSFODNN7EXAMPLE"&SecretAccessKey="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
```
Tentukan `AccessKeyID` dan `SecretAccessKey` di URL JDBC, bersama dengan nama profil otentikasi.
Anda juga dapat memisahkan opsi konfigurasi dengan pembatas titik koma, seperti pada contoh berikut, yang mencakup opsi untuk logging.
```
jdbc:redshift:iam://my_redshift_end_point:5439/dev?LogLevel=6;LogPath=/tmp;AuthProfile=my_profile;AccessKeyID="AKIAIOSFODNN7EXAMPLE";SecretAccessKey="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
```
**catatan**
Jangan menambahkan informasi rahasia ke profil otentikasi. Misalnya, jangan menyimpan `SecretAccessKey` nilai `AccessKeyID` atau dalam profil otentikasi. Toko profil otentikasi memiliki aturan untuk melarang penyimpanan kunci rahasia. Anda mendapatkan kesalahan jika Anda mencoba menyimpan kunci dan nilai yang terkait dengan informasi sensitif.
# Mendapatkan profil otentikasi
Untuk membuat daftar profil otentikasi yang ada, hubungi perintah berikut.
```
describe-authentication-profiles --authentication-profile-name
```
Contoh berikut menunjukkan dua profil diambil. Semua profil dikembalikan jika Anda tidak menentukan nama profil.
`{ "AuthenticationProfiles": [ { "AuthenticationProfileName": "testProfile1", "AuthenticationProfileContent": "{\"AllowDBUserOverride\":\"1\",\"Client_ID\":\"ExampleClientID\",\"App_ID\":\"ExampleAppID\",\"AutoCreate\":false,\"enableFetchRingBuffer\":true,\"databaseMetadataCurrentDbOnly\":true}" }, { "AuthenticationProfileName": "testProfile2", "AuthenticationProfileContent": "{\"AllowDBUserOverride\":\"1\",\"Client_ID\":\"ExampleClientID\",\"App_ID\":\"ExampleAppID\",\"AutoCreate\":false,\"enableFetchRingBuffer\":true,\"databaseMetadataCurrentDbOnly\":true}" } ] } `
# Memecahkan masalah koneksi di Amazon Redshift
Jika Anda memiliki masalah dengan menghubungkan ke cluster Anda dari alat klien SQL, ada beberapa hal yang dapat Anda periksa untuk mempersempit masalah. Jika Anda menggunakan sertifikat SSL atau server, pertama-tama hapus kompleksitas ini saat Anda memecahkan masalah koneksi. Kemudian tambahkan ini kembali ketika Anda telah menemukan solusi. Untuk informasi selengkapnya, lihat [Mengkonfigurasi opsi keamanan untuk koneksi](connecting-ssl-support.md).
Untuk informasi tentang perubahan perilaku dalam fungsionalitas Amazon Redshift yang dapat memengaruhi aplikasi Anda, lihat. [Perubahan perilaku di Amazon Redshift](behavior-changes.md)
**penting**
Amazon Redshift telah mengubah cara sertifikat SSL dikelola. Jika Anda mengalami masalah saat menghubungkan menggunakan SSL, Anda mungkin perlu memperbarui sertifikat CA root kepercayaan Anda saat ini. Untuk informasi selengkapnya, lihat [Transisi ke sertifikat ACM untuk koneksi SSL](connecting-transitioning-to-acm-certs.md).
Bagian berikut memiliki beberapa contoh pesan kesalahan dan kemungkinan solusi untuk masalah koneksi. Karena alat klien SQL yang berbeda menyediakan pesan kesalahan yang berbeda, ini bukan daftar lengkap, tetapi harus menjadi titik awal yang baik untuk memecahkan masalah.
## Menghubungkan dari luar Amazon EC2 dan menghadapi masalah batas waktu firewall
Koneksi klien Anda ke database tampak hang atau batas waktu saat menjalankan kueri panjang, seperti perintah COPY. Dalam kasus ini, Anda mungkin mengamati bahwa konsol Amazon Redshift menampilkan bahwa kueri telah selesai, tetapi alat klien itu sendiri tampaknya masih menjalankan kueri. Hasil kueri mungkin hilang atau tidak lengkap tergantung kapan koneksi berhenti.
### Solusi yang mungkin
Masalah ini terjadi saat Anda terhubung ke Amazon Redshift dari mesin selain instans Amazon EC2. Dalam hal ini, koneksi idle diakhiri oleh komponen jaringan perantara, seperti firewall, setelah periode tidak aktif. Perilaku ini khas ketika Anda masuk dari jaringan pribadi virtual (VPN) atau jaringan lokal Anda.
Untuk menghindari batas waktu ini, kami merekomendasikan perubahan berikut:
+ Tingkatkan nilai sistem klien yang berhubungan dengan TCP/IP batas waktu. Buat perubahan ini di komputer yang Anda gunakan untuk terhubung ke cluster Anda. Periode batas waktu harus disesuaikan untuk klien dan jaringan Anda. Untuk informasi selengkapnya, lihat [Ubah TCP/IP pengaturan batas waktu](#connecting-firewall-guidance.change-tcpip-settings).
+ Secara opsional, atur perilaku keepalive di tingkat DSN. Untuk informasi selengkapnya, lihat [Ubah pengaturan batas waktu DSN](#connecting-firewall-guidance.change-dsn-settings).
### Ubah TCP/IP pengaturan batas waktu
Untuk mengubah pengaturan TCP/IP batas waktu, konfigurasikan pengaturan batas waktu sesuai dengan sistem operasi yang Anda gunakan untuk terhubung ke cluster Anda.
+ Linux — Jika klien Anda berjalan di Linux, jalankan perintah berikut sebagai pengguna root untuk mengubah pengaturan batas waktu untuk sesi saat ini:
```
/sbin/sysctl -w net.ipv4.tcp_keepalive_time=200 net.ipv4.tcp_keepalive_intvl=200 net.ipv4.tcp_keepalive_probes=5
```
Untuk mempertahankan pengaturan, membuat atau memodifikasi file `/etc/sysctl.conf` dengan nilai-nilai berikut kemudian reboot sistem Anda.
```
net.ipv4.tcp_keepalive_time=200
net.ipv4.tcp_keepalive_intvl=200
net.ipv4.tcp_keepalive_probes=5
```
+ Windows — Jika klien Anda berjalan pada Windows, edit nilai untuk pengaturan registri berikut di bawah HKEY\$1LOCAL\$1MACHINE\$1 SYSTEM\$1\$1 Services\$1 Tcpip\$1 CurrentControlSet Parameters\$1:
+ KeepAliveTime: 30000
+ KeepAliveInterval: 1000
+ TcpMaxDataRetransmissions: 10
Pengaturan ini menggunakan tipe data DWORD. Jika tidak ada di bawah jalur registri, Anda dapat membuat pengaturan dan menentukan nilai yang disarankan ini. Untuk informasi lebih lanjut tentang mengedit registri Windows, lihat dokumentasi Windows.
Setelah Anda menetapkan nilai-nilai ini, restart komputer Anda agar perubahan diterapkan.
+ Mac - Jika klien Anda berjalan di Mac, jalankan perintah berikut untuk mengubah pengaturan batas waktu untuk sesi saat ini:
```
sudo sysctl net.inet.tcp.keepintvl=200000
sudo sysctl net.inet.tcp.keepidle=200000
sudo sysctl net.inet.tcp.keepinit=200000
sudo sysctl net.inet.tcp.always_keepalive=1
```
Untuk mempertahankan pengaturan, membuat atau memodifikasi file `/etc/sysctl.conf` dengan nilai-nilai berikut:
```
net.inet.tcp.keepidle=200000
net.inet.tcp.keepintvl=200000
net.inet.tcp.keepinit=200000
net.inet.tcp.always_keepalive=1
```
Nyalakan kembali komputer Anda, lalu jalankan perintah berikut untuk memverifikasi bahwa nilainya ditetapkan.
```
sysctl net.inet.tcp.keepidle
sysctl net.inet.tcp.keepintvl
sysctl net.inet.tcp.keepinit
sysctl net.inet.tcp.always_keepalive
```
### Ubah pengaturan batas waktu DSN
Anda dapat mengatur perilaku keepalive di tingkat DSN jika Anda mau. Anda melakukan ini dengan menambahkan atau memodifikasi parameter berikut dalam file odbc.ini:
**KeepAlivesCount**
Jumlah paket TCP keepalive yang dapat hilang sebelum koneksi dianggap rusak.
**KeepAlivesIdle**
Jumlah detik tidak aktif sebelum driver mengirim paket TCP keepalive.
**KeepAlivesInterval**
Jumlah detik antara setiap transmisi ulang TCP keepalive.
Jika parameter ini tidak ada, atau jika mereka memiliki nilai 0, sistem menggunakan parameter keepalive yang ditentukan TCP/IP untuk menentukan perilaku DSN keepalive. Di Windows, Anda dapat menemukan TCP/IP parameter di registri di`HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\`. Di Linux dan macOS, Anda dapat menemukan TCP/IP parameter dapat ditemukan di file sysctl.conf.
## Koneksi ditolak atau gagal
Ketika koneksi Anda ditolak atau gagal, Anda mungkin menerima kesalahan yang mirip dengan salah satu dari berikut ini.
+ “Gagal membuat koneksi ke**.”
+ “Tidak dapat terhubung ke server: Waktu koneksi habis. Apakah server berjalan pada host *''* dan menerima koneksi TCP/IP pada port?” *''*
+ “Koneksi ditolak. Periksa apakah nama host dan port sudah benar dan bahwa postmaster menerima TCP/IP koneksi.”
### Solusi yang mungkin
Umumnya, ketika Anda menerima pesan kesalahan yang menunjukkan bahwa ada kegagalan untuk membuat koneksi, itu adalah masalah dengan izin untuk mengakses cluster atau dengan lalu lintas jaringan yang mencapai cluster.
Untuk terhubung ke klaster dari alat klien di luar jaringan tempat klaster berada, Anda menambahkan aturan masuk ke grup keamanan klaster. Konfigurasi aturan tergantung pada apakah cluster Amazon Redshift dibuat di cloud pribadi virtual (VPC):
+ Jika Anda membuat klaster Amazon Redshift di cloud pribadi virtual (VPC) berdasarkan Amazon VPC, tambahkan aturan masuk ke grup keamanan VPC yang menentukan alamat klien, di Amazon VPC. CIDR/IP Untuk informasi selengkapnya tentang mengonfigurasi grup keamanan VPC untuk klaster Anda dan opsi yang dapat diakses publik, lihat. [Sumber daya Redshift dalam VPC](managing-clusters-vpc.md)
+ Jika Anda membuat klaster Amazon Redshift di luar VPC, tambahkan CIDR/IP alamat klien Anda ke grup keamanan klaster di Amazon Redshift. Untuk informasi selengkapnya tentang mengonfigurasi grup keamanan klaster, lihat[Grup keamanan Amazon Redshift](security-network-isolation.md#working-with-security-groups).
Jika Anda mencoba menyambung ke klaster dari alat klien yang berjalan pada instans Amazon EC2, Anda juga menambahkan aturan masuk. Dalam hal ini, tambahkan aturan ke grup keamanan cluster. Aturan harus menentukan grup keamanan Amazon EC2 yang terkait dengan instans Amazon EC2 alat klien.
Dalam beberapa kasus, Anda mungkin memiliki lapisan antara klien dan server Anda, seperti firewall. Dalam kasus ini, pastikan firewall menerima koneksi masuk melalui port yang Anda konfigurasikan untuk cluster Anda.
## Klien dan driver tidak kompatibel
Jika klien dan driver Anda tidak kompatibel, Anda mungkin menerima kesalahan yang mengatakan, “DSN yang ditentukan berisi ketidakcocokan arsitektur antara Driver dan Aplikasi.”
### Solusi yang mungkin
Ketika Anda mencoba untuk menghubungkan dan mendapatkan kesalahan tentang ketidakcocokan arsitektur, ini berarti bahwa alat klien dan driver tidak kompatibel. Ini terjadi karena arsitektur sistem mereka tidak cocok. Misalnya, ini dapat terjadi jika Anda memiliki alat klien 32-bit tetapi telah menginstal versi 64-bit driver. Terkadang alat klien 64-bit dapat menggunakan driver 32-bit, tetapi Anda tidak dapat menggunakan aplikasi 32-bit dengan driver 64-bit. Pastikan driver dan alat klien menggunakan versi arsitektur sistem yang sama.
## Kueri tampaknya hang dan terkadang gagal mencapai cluster
Anda mengalami masalah dengan penyelesaian kueri, di mana kueri tampaknya berjalan tetapi hang di alat klien SQL. Terkadang kueri gagal muncul di cluster, seperti di tabel sistem atau konsol Amazon Redshift.
### Solusi yang mungkin
Masalah ini bisa terjadi karena packet drop. Dalam hal ini, ada perbedaan ukuran unit transmisi maksimum (MTU) di jalur jaringan antara dua host Internet Protocol (IP). Ukuran MTU menentukan ukuran maksimum, dalam byte, dari paket yang dapat ditransfer dalam satu bingkai Ethernet melalui koneksi jaringan. Pada tahun AWS, beberapa jenis instans Amazon EC2 mendukung MTU 1500 (frame Ethernet v2) dan jenis instans lainnya mendukung MTU 9001 (bingkai jumbo TCP/IP).
Untuk menghindari masalah yang dapat terjadi dengan perbedaan ukuran MTU, sebaiknya lakukan salah satu hal berikut:
+ Jika klaster Anda menggunakan platform EC2-VPC, konfigurasikan grup keamanan Amazon VPC dengan aturan Internet Control Message Protocol (ICMP) kustom masuk yang muncul. `Destination Unreachable` Aturan dengan demikian menginstruksikan host asal untuk menggunakan ukuran MTU terendah di sepanjang jalur jaringan. Untuk detail tentang pendekatan ini, lihat[Mengkonfigurasi grup keamanan untuk memungkinkan ICMP “tujuan tidak dapat dijangkau”](#configure-custom-icmp).
+ Jika cluster Anda menggunakan platform EC2-Classic, atau Anda tidak dapat mengizinkan aturan masuk ICMP, nonaktifkan bingkai TCP/IP jumbo sehingga frame Ethernet v2 digunakan. Untuk detail tentang pendekatan ini, lihat[Mengkonfigurasi MTU dari sebuah instance](#set-mtu).
### Mengkonfigurasi grup keamanan untuk memungkinkan ICMP “tujuan tidak dapat dijangkau”
Ketika ada perbedaan ukuran MTU di jaringan antara dua host, pertama-tama pastikan bahwa pengaturan jaringan Anda tidak memblokir jalur penemuan MTU (PMTUD). PMTUD memungkinkan host penerima untuk menanggapi host asal dengan pesan ICMP berikut:. `Destination Unreachable: fragmentation needed and DF set (ICMP Type 3, Code 4)` Pesan ini menginstruksikan host asal untuk menggunakan ukuran MTU terendah di sepanjang jalur jaringan untuk mengirim ulang permintaan. Tanpa negosiasi ini, paket drop dapat terjadi karena permintaan terlalu besar untuk diterima oleh host penerima. Untuk informasi lebih lanjut tentang pesan ICMP ini, kunjungi situs *web Internet Engineering Task Force (IETF*). [RFC792](http://tools.ietf.org/html/rfc792)
Jika Anda tidak secara eksplisit mengonfigurasi aturan masuk ICMP ini untuk grup keamanan VPC Amazon Anda, PMTUD diblokir. Dalam AWS, grup keamanan adalah firewall virtual yang menentukan aturan untuk lalu lintas masuk dan keluar ke suatu instans. Untuk informasi tentang grup keamanan klaster Amazon Redshift, lihat. [Grup keamanan Amazon Redshift](security-network-isolation.md#working-with-security-groups) Untuk cluster yang menggunakan platform EC2-VPC, Amazon Redshift menggunakan grup keamanan VPC untuk mengizinkan atau menolak lalu lintas ke cluster. Secara default, grup keamanan dikunci dan menolak semua lalu lintas masuk. *Untuk informasi tentang cara menyetel aturan masuk dan keluar untuk instans EC2-Classic atau EC2-VPC, lihat Perbedaan [antara instans di EC2-Classic dan VPC di Panduan Pengguna Amazon](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-classic-platform.html#ec2_classic_platform) EC2.*
Untuk informasi selengkapnya tentang cara menambahkan aturan ke grup keamanan VPC, lihat. [Grup keamanan VPC](managing-vpc-security-groups.md) *Untuk informasi selengkapnya tentang setelan PMTUD tertentu yang diperlukan dalam aturan ini, lihat [Penemuan Path MTU di Panduan Pengguna](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/network_mtu.html#path_mtu_discovery) Amazon EC2.*
### Mengkonfigurasi MTU dari sebuah instance
Dalam beberapa kasus, klaster Anda mungkin menggunakan platform EC2-Classic atau Anda tidak dapat mengizinkan aturan ICMP khusus untuk lalu lintas masuk. Dalam kasus ini, kami menyarankan Anda menyesuaikan MTU ke 1500 pada antarmuka jaringan (NIC) dari instans EC2 yang Anda sambungkan ke cluster Amazon Redshift Anda. Penyesuaian ini menonaktifkan bingkai TCP/IP jumbo untuk memastikan bahwa koneksi secara konsisten menggunakan ukuran paket yang sama. Namun, opsi ini mengurangi throughput jaringan maksimum untuk instans sepenuhnya, tidak hanya untuk koneksi ke Amazon Redshift. Untuk informasi selengkapnya, lihat prosedur berikut ini.
**Untuk mengatur MTU pada sistem operasi Microsoft Windows**
Jika klien Anda berjalan di sistem operasi Microsoft Windows, Anda dapat meninjau dan mengatur nilai MTU untuk adaptor Ethernet dengan menggunakan perintah. `netsh`
1. Jalankan perintah berikut untuk menentukan nilai MTU saat ini:
```
netsh interface ipv4 show subinterfaces
```
1. Tinjau `MTU` nilai `Ethernet` adaptor dalam output.
1. Jika nilainya tidak`1500`, jalankan perintah berikut untuk mengaturnya:
```
netsh interface ipv4 set subinterface "Ethernet" mtu=1500 store=persistent
```
Setelah Anda menetapkan nilai ini, restart komputer Anda agar perubahan diterapkan.
**Untuk mengatur MTU pada sistem operasi Linux**
Jika klien Anda berjalan di sistem operasi Linux, Anda dapat meninjau dan mengatur nilai MTU dengan menggunakan `ip` perintah.
1. Jalankan perintah berikut untuk menentukan nilai MTU saat ini:
```
$ ip link show eth0
```
1. Tinjau nilai berikut `mtu` dalam output.
1. Jika nilainya tidak`1500`, jalankan perintah berikut untuk mengaturnya:
```
$ sudo ip link set dev eth0 mtu 1500
```
**Untuk mengatur MTU pada sistem operasi Mac**
+ Ikuti petunjuk tentang situs dukungan macOS. `How to change the MTU for troubleshooting purposes` Untuk informasi lebih lanjut, cari [situs dukungan.](https://support.apple.com)
## Mengatur parameter ukuran pengambilan JDBC
Secara default, driver Redshift JDBC menggunakan buffer ring untuk mengelola memori secara efisien dan mencegah kesalahan. out-of-memory Parameter ukuran pengambilan hanya berlaku ketika buffer cincin dinonaktifkan secara eksplisit. Untuk informasi lebih lanjut, tinjau [tautannya](https://docs.aws.amazon.com/redshift/latest/mgmt/jdbc20-configuration-options.html#jdbc20-enablefetchringbuffer-option). Dalam konfigurasi ini, Anda harus mengatur ukuran pengambilan untuk mengontrol berapa banyak baris yang diambil di setiap batch.
Gunakan parameter ukuran ambil saat:
+ Anda membutuhkan kontrol halus atas batching berbasis baris
+ Bekerja dengan aplikasi lama yang memerlukan perilaku ukuran pengambilan tradisional
Ketika buffer dering dinonaktifkan, driver JDBC mengumpulkan semua hasil untuk kueri pada satu waktu secara default. Kueri yang mengembalikan set hasil besar dapat menghabiskan memori yang berlebihan. Untuk mengambil set hasil dalam batch, bukan sekaligus, atur parameter ukuran pengambilan JDBC di aplikasi Anda.
**catatan**
Ukuran pengambilan tidak didukung untuk ODBC.
Untuk kinerja terbaik, atur ukuran pengambilan ke nilai tertinggi yang tidak menyebabkan kesalahan memori. Nilai ukuran pengambilan yang lebih rendah menghasilkan lebih banyak perjalanan server, yang memperpanjang waktu eksekusi. Server menyimpan sumber daya, termasuk slot kueri WLM dan memori terkait, hingga klien mengambil seluruh kumpulan hasil atau kueri dibatalkan. Saat Anda menyetel ukuran pengambilan dengan tepat, sumber daya tersebut dirilis lebih cepat, membuatnya tersedia untuk kueri lain.
**catatan**
Jika Anda perlu mengekstrak kumpulan data besar, sebaiknya gunakan pernyataan [UNLOAD](https://docs.aws.amazon.com/redshift/latest/dg/r_UNLOAD.html) untuk mentransfer data ke Amazon S3. Saat Anda menggunakan UNLOAD, node komputasi bekerja secara paralel untuk mempercepat transfer data.
Untuk informasi selengkapnya tentang pengaturan parameter ukuran pengambilan JDBC, buka [Mendapatkan hasil berdasarkan kursor dalam dokumentasi PostgreSQL](https://jdbc.postgresql.org/documentation/query/#getting-results-based-on-a-cursor).