Amazon Redshift tidak akan lagi mendukung penggunaan Python UDF setelah 30 Juni 2026. Kami akan mulai menegakkannya secara bertahap. Untuk informasi lebih lanjut tentang detail opsi akhir masa pakai dan migrasi Python, lihat posting blog
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Opsi untuk konfigurasi driver JDBC versi 2.x
Berikut ini, Anda dapat menemukan deskripsi untuk opsi yang dapat Anda tentukan untuk versi 2.x dari driver Amazon Redshift JDBC. Opsi konfigurasi tidak peka huruf besar/kecil.
Anda dapat mengatur properti konfigurasi menggunakan URL koneksi. Untuk informasi selengkapnya, lihat Membangun URL koneksi.
Topik
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 string atau profil pengguna yang ada. Jika Anda menentukan parameter ini, Anda juga harus menentukan SecretAccessKey parameternya. Jika diteruskan dalam URL JDBC, AccessKey ID harus dikodekan URL.
Parameter ini bersifat opsional.
AllowDBUserOverride
-
Nilai Default — 0
-
Tipe Data - String
Opsi ini menentukan apakah driver menggunakan DbUser nilai dari pernyataan SAML atau nilai yang ditentukan dalam properti DbUser koneksi di URL koneksi.
Parameter ini bersifat opsional.
- 1
-
Pengemudi menggunakan
DbUsernilai dari pernyataan SAML.Jika pernyataan SAML tidak menentukan nilai untuk
DBUser, driver menggunakan nilai yang ditentukan dalam propertiDBUserkoneksi. Jika properti koneksi juga tidak menentukan nilai, driver menggunakan nilai yang ditentukan dalam profil koneksi. - 0
-
Driver menggunakan
DBUsernilai yang ditentukan dalam propertiDBUserkoneksi.Jika properti
DBUserkoneksi tidak menentukan nilai, driver menggunakan nilai yang ditentukan dalam profil koneksi. Jika profil koneksi juga tidak menentukan nilai, driver menggunakan nilai dari pernyataan SAML.
App_ID
-
Nilai Default - Tidak ada
-
Tipe Data - String
ID Okta-provided unik yang terkait dengan aplikasi Amazon Redshift Anda.
Parameter ini diperlukan jika otentikasi melalui layanan Okta.
App_Name
-
Nilai Default - Tidak ada
-
Tipe Data - String
Nama aplikasi Okta yang Anda gunakan untuk mengotentikasi koneksi ke Amazon Redshift.
Parameter ini bersifat opsional.
ApplicationName
-
Nilai Default - null
-
Tipe Data - String
Nama aplikasi yang akan 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 yang ditentukan tidak ada.
Parameter ini bersifat opsional.
- true
-
Jika pengguna yang ditentukan oleh salah
DBUsersatu atau ID unik (UID) tidak ada, pengguna baru dengan nama itu dibuat. - false
-
Driver tidak menyebabkan pengguna baru dibuat. Jika pengguna yang ditentukan tidak ada, otentikasi gagal.
Client_ID
-
Nilai Default - Tidak ada
-
Tipe Data - String
ID klien yang akan digunakan saat mengotentikasi koneksi menggunakan layanan Azure AD.
Parameter ini diperlukan jika mengotentikasi melalui layanan Azure AD.
Client_Secret
-
Nilai Default - Tidak ada
-
Tipe Data - String
Rahasia Klien untuk digunakan saat mengotentikasi koneksi menggunakan layanan Azure AD.
Parameter ini diperlukan jika mengotentikasi melalui layanan Azure AD.
ID Cluster
-
Nilai Default - Tidak ada
-
Tipe Data - String
Nama cluster Amazon Redshift yang ingin Anda sambungkan. Driver mencoba mendeteksi parameter ini dari host yang diberikan. Jika Anda menggunakan Network Load Balancer (NLB) dan menghubungkan melalui IAM, driver akan gagal mendeteksinya, sehingga Anda dapat mengaturnya menggunakan opsi koneksi ini.
Parameter ini bersifat opsional.
Kompresi
-
Nilai Default — nonaktif
-
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.
-
mati
Tidak menggunakan kompresi untuk komunikasi protokol kawat dengan Amazon Redshift.
ConnectTimeout
-
Nilai Default - 10
-
Tipe Data — Integer
Nilai batas waktu yang digunakan untuk operasi sambungan soket. Jika waktu yang diperlukan untuk membuat koneksi Amazon Redshift melebihi nilai ini, koneksi dianggap tidak tersedia. Waktu tunggu ditentukan dalam detik. Nilai 0 berarti tidak ada batas waktu yang ditentukan.
Parameter ini bersifat opsional.
KoneksiZona Waktu
-
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.
- SERVER
-
Mengkonfigurasi 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 [...];
basis data MetadataCurrentDbOnly
-
Nilai Default — true
-
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 yang akan 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 nama grup database yang ada yang dipisahkan koma yang DBUser bergabung untuk sesi saat ini.
Parameter ini bersifat opsional.
NAMA DB
-
Nilai Default - null
-
Tipe Data - String
Nama database yang akan dihubungkan. 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.
default RowFetchSize
-
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 dari. ResultSet
DisableIsValidQuery
-
Nilai Default - Salah
-
Tipe Data — Boolean
Opsi ini menentukan apakah driver mengirimkan kueri 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 mati secara tidak terduga.
- false
-
Driver mengirimkan kueri saat menggunakan Connection.isValid () untuk menentukan apakah koneksi database aktif.
mengaktifkan FetchRingBuffer
-
Nilai Default — true
-
Tipe Data — Boolean
Opsi ini menentukan bahwa driver mengambil baris menggunakan buffer cincin pada utas terpisah. RingBufferSize Parameter fetch menentukan ukuran buffer cincin.
Ring buffer mengimplementasikan manajemen memori otomatis di JDBC untuk mencegah kesalahan di luar memori (OOM) selama operasi pengambilan data. Ring buffer memantau ukuran aktual data buffer secara real-time, memastikan penggunaan memori total oleh driver tetap dalam batas yang ditentukan. Ketika kapasitas buffer tercapai, driver menjeda operasi pengambilan data, mencegah luapan memori tanpa memerlukan intervensi manual. Pengaman 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 cincin pengambilan untuk transaksi tersebut disetel ke false. nilai enable tidak berubahFetchRingBuffer.
Parameter ini bersifat opsional.
catatan
Ketika buffer cincin dinonaktifkan dan ukuran pengambilan tidak dikonfigurasi dengan benar, masalah kehabisan memori (OOM) dapat terjadi. Untuk informasi selengkapnya tentang mengkonfigurasi ukuran pengambilan, lihat di sini.
mengaktifkan MultiSqlSupport
-
Nilai Default — true
-
Tipe Data — Boolean
Opsi ini menentukan apakah akan memproses beberapa perintah SQL yang 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.
EnableTableTypes
-
Nilai Default — true
-
Tipe Data — Boolean
Opsi ini menentukan apakah driver mengenali informasi tipe tabel terperinci dari sumber data dalam hasil getTableTypes DatabaseMetaData metode getTables dan. Secara default, driver mengenali tipe tabel terperinci.
Parameter ini bersifat opsional. Ini tersedia dalam versi driver 2.2.8 dan yang lebih baru.
- true
-
Driver mengenali jenis tabel berikut: TABEL, TAMPILAN, TABEL SISTEM, TAMPILAN SISTEM, TABEL EKSTERNAL, dan TEMPORER LOKAL.
- false
-
Driver menormalkan informasi tipe tabel terperinci ke dalam tipe tabel generik dan VIEW tabel.
mengambil RingBufferSize
-
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. Pengambilan dilanjutkan saat aplikasi membaca baris dan membebaskan ruang di buffer cincin.
Parameter ini bersifat opsional.
ForceLowercase
-
Nilai Default — false
-
Tipe Data — Boolean
Opsi ini menentukan apakah driver menggunakan huruf kecil semua grup database (DbGroups) yang dikirim dari penyedia identitas ke Amazon Redshift saat menggunakan otentikasi masuk tunggal.
Parameter ini bersifat opsional.
- true
-
Driver menggunakan huruf kecil semua grup database yang dikirim dari penyedia identitas.
- false
-
Driver tidak mengubah grup database.
Federasi Grup
-
Nilai Default — false
-
Tipe Data — Boolean
Opsi ini menentukan apakah akan menggunakan grup IDP Amazon Redshift. Ini didukung oleh GetClusterCredentialsV2 API.
Parameter ini bersifat opsional.
- true
-
Gunakan grup Amazon Redshift Identity Provider (IDP).
- false
-
Gunakan API STS dan GetClusterCredentials untuk federasi pengguna dan secara eksplisit tentukan DbGroups untuk koneksi.
HOST
-
Nilai Default - null
-
Tipe Data - String
Nama host server Amazon Redshift untuk dihubungkan. 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 kredenSIAL IAM di-cache.
Parameter ini bersifat opsional.
- true
-
KredenSIAL IAM tidak di-cache.
- false
-
KredenSIAL IAM di-cache. Ini meningkatkan kinerja ketika permintaan ke gateway API dibatasi, misalnya.
IAMDurasi
-
Nilai Default - 900
-
Tipe Data — Integer
Lamanya waktu, dalam detik, hingga kredenSIAL IAM sementara kedaluwarsa.
-
Nilai minimum — 900
-
Nilai maksimum — 3,600
Parameter ini bersifat opsional.
Idc_Client_Display_Name
-
Nilai Default - Driver Amazon Redshift JDBC
-
Tipe Data - String
Nama tampilan yang akan digunakan untuk klien yang menggunakan BrowserIdcAuthPlugin.
Parameter ini bersifat opsional.
Idc_Region
-
Nilai Default - Tidak ada
-
Tipe Data - String
Wil AWS ayah tempat instance Pusat Identitas IAM berada.
Parameter ini diperlukan hanya saat mengotentikasi menggunakan BrowserIdcAuthPlugin opsi konfigurasi plugin_name.
IDP_Host
-
Nilai Default - Tidak ada
-
Tipe Data - String
Host IdP (penyedia identitas) yang Anda gunakan untuk mengotentikasi ke Amazon Redshift. Ini dapat ditentukan baik dalam string koneksi atau dalam profil.
Parameter ini bersifat opsional.
Partisi IDP
-
Nilai Default - Tidak ada
-
Tipe Data - String
Menentukan partisi cloud tempat penyedia identitas (IdP) Anda 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 titik akhirlogin.microsoftonline.us.cn: Gunakan nilai ini jika IdP Anda dikonfigurasi di partisi cloud China. Misalnya, Azure AD China menggunakan titik akhirlogin.chinacloudapi.cn.
Parameter ini bersifat opsional.
IDP_Port
-
Nilai Default - Tidak ada
-
Tipe Data - String
Port yang digunakan oleh IdP (penyedia identitas). Anda dapat menentukan port di string koneksi atau di profil. Port default adalah 5439. Bergantung pada port yang Anda pilih saat membuat, memodifikasi, atau memigrasikan cluster, izinkan akses ke port yang dipilih.
Parameter ini bersifat opsional.
IDP_Tenant
-
Nilai Default - Tidak ada
-
Tipe Data - String
ID penyewa Azure AD untuk aplikasi Amazon Redshift Anda.
Parameter ini diperlukan jika mengotentikasi melalui layanan Azure AD.
IdP_ Response_Timeout
-
Nilai Default - 120
-
Tipe Data — Integer
Jumlah waktu, dalam detik, pengemudi menunggu respons SAML dari penyedia identitas saat menggunakan layanan SAML atau Azure AD melalui plugin browser.
Parameter ini bersifat opsional.
IniFile
-
Nilai Default - Tidak ada
-
Tipe Data - String
Jalur lengkap file.ini, termasuk nama file. Contoh:
IniFile="C:\tools\rsjdbc.ini"
Untuk informasi tentang file.ini, lihatMembuat file inisialisasi (.ini) untuk driver JDBC versi 2.x.
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, lihatMembuat file inisialisasi (.ini) untuk driver JDBC versi 2.x.
Contoh berikut menentukan bagian [Prod] dari file.ini:
IniSection="Prod"
Parameter ini bersifat opsional.
Adalah tanpa server
-
Nilai Default — false
-
Tipe Data — Boolean
Opsi ini menentukan apakah host titik akhir Amazon Redshift adalah instance tanpa server. Driver 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 titik akhir Amazon Redshift adalah instance tanpa server.
- false
-
Host titik akhir Amazon Redshift adalah cluster yang disediakan.
Issuer_Url
-
Nilai Default - Tidak ada
-
Tipe Data - String
Menunjuk ke titik akhir instans server AWS IAM Identity Center.
Parameter ini diperlukan hanya saat mengotentikasi menggunakan BrowserIdcAuthPlugin opsi konfigurasi plugin_name.
Listen_Port
-
Nilai Default - 7890
-
Tipe Data — Integer
Port yang digunakan driver untuk menerima respons SAML dari penyedia identitas atau kode otorisasi saat menggunakan layanan SAML, Azure AD, atau AWS Identity Center melalui plugin browser.
Parameter ini bersifat opsional.
Login_URL
-
Nilai Default - Tidak ada
-
Tipe Data - String
URL untuk sumber daya di situs web penyedia identitas saat menggunakan layanan SAML atau Azure AD melalui plugin browser.
Parameter ini diperlukan jika melakukan otentikasi dengan layanan SAML atau Azure AD melalui plugin browser.
MasukWaktu habis
-
Nilai Default — 0
-
Tipe Data — Integer
Jumlah detik yang harus menunggu sebelum waktu habis saat menghubungkan dan mengotentikasi ke server. Jika membangun koneksi membutuhkan waktu lebih lama dari ambang ini, maka koneksi dibatalkan.
Bila properti ini disetel ke 0, koneksi tidak habis waktu.
Parameter ini bersifat opsional.
Masuk ToRp
-
Nilai Default -
urn:amazon:webservices -
Tipe Data - String
Kepercayaan pihak yang bergantung yang ingin Anda gunakan untuk jenis otentikasi AD FS.
Parameter ini bersifat 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 file log.
Aktifkan logging hanya cukup lama untuk menangkap masalah. Logging menurunkan kinerja dan dapat menghabiskan 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 driver membatalkan.
- 2
-
Aktifkan logging pada tingkat ERROR, yang mencatat peristiwa kesalahan yang mungkin masih memungkinkan driver untuk terus berjalan.
- 3
-
Aktifkan logging pada tingkat PERINGATAN, yang mencatat peristiwa yang mungkin mengakibatkan kesalahan jika tindakan tidak diambil.
- 4
-
Aktifkan logging pada tingkat INFO, yang mencatat informasi umum yang menggambarkan kemajuan driver.
- 5
-
Aktifkan logging pada tingkat DEBUG, yang mencatat informasi terperinci yang berguna untuk men-debug driver.
- 6
-
Aktifkan logging pada tingkat 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 angka yang membedakan setiap file log dari yang lain. File ini mencatat aktivitas driver yang khusus untuk koneksi.
Jika nil LogPath ainya tidak valid, driver mengirimkan informasi yang dicatat ke aliran keluaran standar,System.out.
LogPath
-
Nilai Default — Direktori kerja saat ini.
-
Tipe Data - String
Jalur lengkap ke folder tempat driver menyimpan file log saat DSILogLevel properti diaktifkan.
Untuk memastikan bahwa URL koneksi kompatibel dengan semua aplikasi JDBC, kami sarankan Anda menghindari garis miring terbalik (\) 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 kueri yang digunakan dalam panggilan getTables.
- 0
-
Tidak Ada Skema Kueri Universal
- 1
-
Kueri Skema Lokal
- 2
-
Kueri Skema Eksternal
Parameter ini bersifat opsional.
Partner_SPID
-
Nilai Default - Tidak ada
-
Tipe Data - String
Nilai SPID mitra (ID penyedia layanan) yang akan digunakan saat mengotentikasi 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_Host. Saat menggunakan otentikasi standar, ini dapat digunakan untuk kata sandi database Amazon Redshift alih-alih PWD.
Parameter ini bersifat opsional.
Plugin_Name
-
Nilai Default - Tidak ada
-
Tipe Data - String
Nama kelas yang sepenuhnya memenuhi syarat untuk mengimplementasikan plugin penyedia kredenSIAL tertentu.
Parameter ini bersifat opsional.
Opsi penyedia berikut didukung:
-
AdfsCredentialsProvider— Layanan Federasi Direktori Aktif. -
AzureCredentialsProvider— Layanan Direktori Aktif Microsoft Azure (AD). -
BasicJwtCredentialsProvider— Layanan Token Web JSON (JWT). -
BasicSamlCredentialsProvider- Kredentif Security Assertion Markup Language (SAML) yang dapat Anda gunakan dengan banyak penyedia layanan SAML. -
BrowserAzureCredentialsProvider— Layanan Direktori Aktif Microsoft Azure (AD) Browser. -
BrowserAzureOAuth2CredentialsProvider— Layanan Browser Microsoft Azure Active Directory (AD) untuk Otentikasi Asli. -
BrowserIdcAuthPlugin— Plugin otorisasi menggunakan Pusat Identi AWS tas IAM. -
BrowserSamlCredentialsProvider— Browser SAML untuk layanan SAML seperti Okta, Ping, atau ADFS. -
IdpTokenAuthPlugin— Plugin otorisasi yang menerima token Pusat Identi AWS tas IAM atau token identitas OpenID Connect (OIDC) (JWT) dari penyedia JSON-based identitas web mana pun yang ditautkan ke AWS Pusat Identitas IAM. -
OktaCredentialsProvider— Layanan Okta. -
PingCredentialsProvider— PingFederate Layanan.
PELABUHAN
-
Nilai Default - null
-
Tipe Data — Integer
Port server Amazon Redshift untuk dihubungkan. Anda dapat menggunakan opsi ini untuk menentukan port di URL koneksi JDBC.
Parameter ini bersifat opsional.
PreferPQ
-
Nilai Default — true
-
Tipe Data — Boolean
Opsi ini mengontrol apakah pengemudi mengiklankan grup pertukaran kunci hibrida pasca-kuantum di TLS 1.3. ClientHello Ketika grup pasca-kuantum ditawarkan dan server juga mendukungnya, server memilih satu. Jika tidak, jabat tangan jatuh kembali ke pertukaran kunci klasik secara transparan.
Parameter ini bersifat opsional. Ini tersedia dalam versi driver 2.2.8 dan yang lebih baru.
- true
-
Pengemudi mengiklankan grup pertukaran kunci TLS hibrida pasca-kuantum saat didukung oleh runtime.
- false
-
Pengemudi tidak mengiklankan grup pasca-kuantum. Gunakan pengaturan ini jika middlebox jaringan memblokir jabat tangan TLS karena tidak mengenali grup pertukaran kunci pasca-kuantum yang ditawarkan driver.
Preferred_Role
-
Nilai Default - Tidak ada
-
Tipe Data - String
Peran IAM yang ingin Anda ambil 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.
Grup kueri
-
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.
Baca Saja
-
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 tempat cluster berada. Jika Anda menentukan StsEndPoint opsi, opsi Wilayah diabaikan. Operasi Redshift GetClusterCredentials API juga menggunakan opsi Region.
Parameter ini bersifat opsional.
kembali WriteBatchedInserts
-
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.
kembali WriteBatchedInsertsSize
-
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 pangkat 2.
Parameter ini bersifat opsional.
Pelajari
-
Nilai Default - Tidak ada
-
Tipe Data - String
Nama Sumber Daya Amazon (ARN) dari peran. Pastikan untuk menentukan parameter ini ketika Anda menentukan BasicJwtCredentialsProvider untuk Plugin_Name opsi. Anda menentukan ARN dalam format berikut:
arn:partition:service:region:account-id:resource-id
Parameter ini diperlukan jika Anda menentukan BasicJwtCredentialsProvider Plugin_Name opsi.
peran SessionName
-
Nilai default - jwt_redshift_session
-
Tipe Data - String
Sebuah pengenal untuk sesi peran yang diambil. Biasanya, Anda meneruskan nama atau pengenal yang terkait dengan pengguna aplikasi Anda. KredenSIAL keamanan sementara yang digunakan aplikasi Anda dikaitkan dengan pengguna tersebut. Anda dapat menentukan parameter ini ketika Anda menentukan BasicJwtCredentialsProvider untuk Plugin_Name opsi.
Parameter ini bersifat opsional.
cakupan
-
Nilai Default - Tidak ada
-
Tipe Data - String
Daftar cakupan yang dipisahkan spasi yang dapat disetujui pengguna. Anda menentukan parameter ini sehingga aplikasi Microsoft Azure Anda bisa mendapatkan persetujuan untuk API yang ingin Anda panggil. Anda dapat menentukan parameter ini ketika Anda menentukan BrowserAzureOAuth2CredentialsProvider untuk Plugin_Name opsi.
Parameter ini diperlukan untuk BrowserAzureOAuth2CredentialsProvider 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, URL SecretAccessKey harus dikodekan.
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 mengotentikasi. Jika diteruskan dalam URL JDBC, token sesi IAM sementara harus dikodekan URL.
Parameter ini bersifat opsional.
tanpa server AcctId
-
Nilai Default - null
-
Tipe Data - String
ID akun Tanpa Server Amazon Redshift. Driver 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.
tanpa server WorkGroup
-
Nilai Default - null
-
Tipe Data - String
Nama grup kerja Amazon Redshift Serverless. Driver 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 Soket
-
Nilai Default - null
-
Tipe Data - String
Opsi ini menentukan pabrik soket untuk pembuatan soket.
Parameter ini bersifat opsional.
SocketMeOut
-
Nilai Default — 0
-
Tipe Data — Integer
Jumlah detik yang harus 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 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 mengonfigurasi AuthMech properti.
SSL_tidak aman
-
Nilai Default — true
-
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
-
Driver tidak memeriksa keaslian sertifikat server IDP.
- false
-
Driver 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.
Pabrik SSL
-
Nilai Default - Tidak ada
-
Tipe Data - String
Pabrik SSL untuk digunakan saat menghubungkan ke server melalui TLS/SSL tanpa menggunakan sertifikat server.
Kunci SSL
-
Nilai Default - Tidak ada
-
Tipe Data - String
Jalur lengkap file.der yang berisi file kunci PKCS8 untuk memverifikasi sertifikat yang ditentukan dalam SSLCert.
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
-
Driver memverifikasi bahwa sertifikat berasal dari otoritas sertifikat tepercaya (CA).
- verify-full
-
Driver 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.
SSLRootCert
-
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.
tcp KeepAlive
-
Nilai Default - BENAR
-
Tipe Data - String
Gunakan properti ini untuk menghidupkan atau mematikan keepalives TCP.
Parameter ini bersifat opsional.
Anda dapat menentukan salah satu nilai berikut:
- BETUL
-
Driver menggunakan keepalives TCP untuk mencegah koneksi habis waktu.
- SALAH
-
Driver tidak menggunakan keepalives TCP.
token
-
Nilai Default - Tidak ada
-
Tipe Data - String
AWS IAM Identity Center menyediakan token akses atau OpenID Connect (OIDC) JSON Web Token (JWT) yang disediakan oleh penyedia identitas web yang terhubung dengan AWS Pusat Identitas IAM. Aplikasi Anda harus menghasilkan token ini dengan mengotentikasi pengguna aplikasi Anda dengan Pusat Identitas AWS IAM atau penyedia identitas yang ditautkan dengan Pusat Identitas AWS IAM.
Parameter ini bekerja denganIdpTokenAuthPlugin.
Token_Tipe
-
Nilai Default - Tidak ada
-
Tipe Data - String
Jenis token yang digunakan diIdpTokenAuthPlugin.
Anda dapat menentukan salah satu nilai berikut:
- AKSES_TOKEN
-
Masukkan ini jika Anda menggunakan token akses yang disediakan Pusat Identitas AWS IAM.
- EXT_JWT
-
Masukkan ini jika Anda menggunakan OpenID Connect (OIDC) JSON Web Token (JWT) yang disediakan oleh penyedia identitas berbasis web yang terintegrasi dengan Pusat Identitas AWS IAM.
Parameter ini bekerja denganIdpTokenAuthPlugin.
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_host. Saat menggunakan otentikasi standar, ini dapat digunakan untuk nama pengguna database Amazon Redshift.
Parameter ini bersifat opsional.
web IdentityToken
-
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 mengotentikasi pengguna aplikasi Anda dengan penyedia identitas web. Pastikan untuk menentukan parameter ini ketika Anda menentukan BasicJwtCredentialsProvider untuk Plugin_Name opsi.
Parameter ini diperlukan jika Anda menentukan BasicJwtCredentialsProvider Plugin_Name opsi.
