View a markdown version of this page

Opsi konfigurasi untuk konektor Amazon Redshift Python - Amazon Redshift

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 yang diterbitkan pada 30 Juni 2025.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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.

akses_key_id

  • 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_db_user_override

  • Nilai default - Salah

  • Tipe data — Boolean

True

Menentukan bahwa konektor menggunakan DbUser nilai dari pernyataan Security Assertion Markup Language (SAML).

False

Menentukan bahwa nilai dalam parameter DbUser koneksi digunakan.

Parameter ini bersifat opsional.

nama_aplikasi

  • Nilai default - Tidak ada

  • Tipe data — String

Nama aplikasi penyedia identitas (IdP) yang digunakan untuk otentikasi.

Parameter ini bersifat opsional.

application_name

  • Nilai default - Tidak ada

  • Tipe data — String

Nama aplikasi klien yang akan diteruskan ke Amazon Redshift untuk tujuan audit. Nama aplikasi yang Anda berikan muncul di kolom 'application_name' pada tabel SYS_CONNECTION_LOG. 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_profile

  • 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. Kel RedshiftProperty as menyimpan parameter koneksi yang disediakan oleh pengguna akhir dan, jika berlaku, dihasilkan selama proses otentikasi IAM (misalnya, kredentif IAM sementara). Untuk informasi lebih lanjut, lihat RedshiftProperty kelas.

Parameter ini bersifat opsional.

auto_buat

  • Nilai default - Salah

  • Tipe data — Boolean

Nilai yang menunjukkan apakah akan membuat pengguna jika pengguna tidak ada.

Parameter ini bersifat opsional.

client_id

  • Nilai default - Tidak ada

  • Tipe data — String

ID klien dari Azure IdP.

Parameter ini bersifat opsional.

client_secret

  • Nilai default - Tidak ada

  • Tipe data — String

Rahasia klien dari Azure IdP.

Parameter ini bersifat opsional.

pengidentifikasi_cluster

  • Nilai default - Tidak ada

  • Tipe data — String

Pengidentifikasi cluster dari cluster Amazon Redshift.

Parameter ini bersifat opsional.

kredensials-penyedia

  • 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 Pusat Identi AWS tas IAM.

  • BrowserSamlCredentialsProvider

  • 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 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_metadata_current_db_only

  • Nilai default - Benar

  • Tipe data — Boolean

Nilai yang menunjukkan apakah aplikasi mendukung katalog multidatabase datashare. Nilai default True menunjukkan bahwa aplikasi tidak mendukung katalog multidatabase datashare untuk kompatibilitas mundur.

Parameter ini bersifat opsional.

db_group

  • Nilai default - Tidak ada

  • Tipe data — String

Daftar nama grup database yang ada yang dipisahkan koma yang ditunjukkan pengguna dengan DbUser bergabung untuk sesi saat ini.

Parameter ini bersifat opsional.

db_pengguna

  • Nilai default - Tidak ada

  • Tipe data — String

ID pengguna yang akan digunakan dengan Amazon Redshift.

Parameter ini bersifat opsional.

mengaktifkan_tipe_tabel

  • Nilai default - Benar

  • Tipe data — Boolean

Menentukan apakah konektor mengenali informasi tipe tabel terperinci dari sumber data dalam hasil metode get_tables dan get_table_types metadata. Secara default, konektor mengenali tipe tabel terperinci.

  • Benar: Konektor mengenali jenis tabel berikut: TABEL, TAMPILAN, TABEL SISTEM, TAMPILAN SISTEM, TABEL EKSTERNAL, dan TEMPORER LOKAL.

  • Salah: Konektor menormalkan informasi tipe tabel terperinci ke dalam tipe tabel generik dan VIEW tabel.

Parameter ini bersifat opsional. Ini tersedia dalam versi konektor 2.1.16 dan yang lebih baru.

endpoint_url

  • Nilai default - Tidak ada

  • Tipe data — String

URL titik akhir Amazon Redshift. Opsi ini hanya untuk penggunaan AWS internal.

Parameter ini bersifat opsional.

federasi grup

  • 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 API STS dan GetClusterCredentials untuk federasi pengguna dan tentukan db_groups untuk koneksi.

host

  • Nilai default - Tidak ada

  • Tipe data — String

Nama host cluster Amazon Redshift.

Parameter ini bersifat opsional.

iam

  • Nilai default - Salah

  • Tipe data — Boolean

Otentikasi IAM diaktifkan.

Parameter ini diperlukan.

iam_menonaktifkan_cache

  • Nilai default - Salah

  • Tipe data — Boolean

Opsi ini menentukan apakah kredenSIAL IAM di-cache. Secara default, kredenSIAL IAM di-cache. Ini meningkatkan kinerja saat permintaan ke gateway API dibatasi.

Parameter ini bersifat opsional.

idc_client_tampilan_nama_

  • Nilai Default - Konektor Amazon Redshift Python

  • 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 AWS IAM berada.

Parameter ini hanya diperlukan saat mengotentikasi menggunakan opsi konfigurasi BrowserIdcAuthPlugin kredensialsi-penyedia.

idp_partisi

  • 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.

IDPport

  • Nilai default - 7890

  • Tipe data — Integer

Port listen tempat IdP mengirimkan pernyataan SAML.

Parameter ini diperlukan.

idp_response_timeout

  • Nilai default - 120

  • Tipe data — Integer

Batas waktu untuk mengambil pernyataan SAML dari IdP.

Parameter ini diperlukan.

idp_tenant

  • Nilai default - Tidak ada

  • Tipe data — String

Penyewa IdP.

Parameter ini bersifat opsional.

penerbit_url

  • Nilai Default - Tidak ada

  • Tipe Data - String

Menunjuk ke titik akhir instans server AWS IAM Identity Center.

Parameter ini hanya diperlukan saat mengotentikasi menggunakan opsi konfigurasi BrowserIdcAuthPlugin kredensialsi-penyedia.

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 IAM Identity Center melalui plugin browser.

Parameter ini bersifat opsional.

login_url

  • Nilai default - Tidak ada

  • Tipe data — String

Url masuk tunggal untuk IdP.

Parameter ini bersifat opsional.

Pernyataan Max_Prepared_

  • Nilai default - 1000

  • Tipe data — Integer

Jumlah maksimum pernyataan yang disiapkan yang akan di-cache per koneksi. Menyetel parameter ini ke 0 menonaktifkan mekanisme caching. Memasukkan angka negatif untuk parameter ini menyetelnya ke nilai default.

Parameter ini bersifat opsional.

numeric_to_float

  • Nilai default - Salah

  • Tipe data — Boolean

Opsi ini menentukan apakah konektor mengubah nilai tipe data numerik dari Decimal.decimal ke float. Secara default, konektor menerima nilai tipe data numerik sebagai desimal.decimal dan tidak mengubahnya.

Kami tidak menyarankan untuk mengaktifkan numeric_to_float untuk kasus penggunaan yang membutuhkan presisi, karena hasilnya dapat dibulatkan.

Untuk informasi lebih lanjut tentang desimal.decimal dan pertukaran antara itu dan float, lihat decimal — Titik tetap desimal dan aritmatika titik mengambang di situs web Python.

Parameter ini bersifat opsional.

partner_sp_id

  • Nilai default - Tidak ada

  • Tipe data — String

Partner SP ID 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.

peran yang disukai

  • Nilai default - Tidak ada

  • Tipe data — String

Peran IAM lebih disukai untuk koneksi saat ini.

Parameter ini bersifat opsional.

principal_arn

  • Nilai default - Tidak ada

  • Tipe data — String

Nama Sumber Daya Amazon (ARN) dari pengguna atau peran IAM yang Anda buat kebijakan. Disarankan agar Anda 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 AWS kredenSIAL yang berisi kre AWS denSIAL.

Parameter ini bersifat opsional.

nama penyedia

  • 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.

rol_arn

  • Nilai default - Tidak ada

  • Tipe data — String

Nama Sumber Daya Amazon (ARN) dari peran yang diasumsikan oleh pemanggil. Parameter ini digunakan oleh penyedia yang ditunjukkan olehJwtCredentialsProvider.

Untuk JwtCredentialsProvider penyedia, parameter ini wajib. Jika tidak, parameter ini opsional.

nama_sesi peran

  • 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 yang menggunakan aplikasi Anda. KredenSIAL keamanan sementara yang digunakan aplikasi Anda dikaitkan dengan pengguna tersebut. Parameter ini digunakan oleh penyedia yang ditunjukkan olehJwtCredentialsProvider.

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 Anda bisa mendapatkan persetujuan untuk API yang ingin Anda panggil. Anda dapat menentukan parameter ini ketika Anda menentukan BrowserAzureOAuth2CredentialsProvider untuk opsi CREDENTIALS_provider.

Parameter ini diperlukan untuk BrowserAzureOAuth2CredentialsProvider plug-in.

id kunci akses rahasia

  • 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_token

  • 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 kredenSIAL sementara digunakan.

Parameter ini bersifat opsional.

serverless_acct_id

  • Nilai default - Tidak ada

  • Tipe data — String

ID akun Tanpa Server Amazon Redshift.

Parameter ini bersifat opsional.

grup_kerja tanpa server

  • Nilai default - Tidak ada

  • Tipe data — String

Nama grup kerja Amazon Redshift Serverless.

Parameter ini bersifat opsional.

ssl

  • Nilai default - Benar

  • Tipe data — Boolean

Secure Sockets Layer (SSL) diaktifkan.

Parameter ini diperlukan.

ssl_tidak aman

  • Nilai default - Salah

  • Tipe data — Boolean

Nilai yang menentukan apakah akan menonaktifkan verifikasi sertifikat SSL server host IdP. Menyetel parameter ini ke True akan menonaktifkan verifikasi sertifikat SSL server host IdP. Sebaiknya simpan 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_keepalive

  • Nilai default - Benar

  • Tipe data — Boolean

Apakah akan menggunakan keepalives TCP untuk mencegah koneksi habis waktu. Anda dapat menentukan salah satu nilai berikut:

  • Benar: Pengemudi akan menggunakan keepalives TCP untuk mencegah koneksi habis waktu.

  • Salah: Driver tidak akan menggunakan keepalives TCP.

Parameter ini bersifat opsional.

tcp_keepalive_count

  • Nilai default - Tidak ada

  • Tipe data — Integer

Jumlah probe yang tidak diakui untuk dikirim sebelum mempertimbangkan koneksi tidak aktif. Misalnya, menyetel nilai ke 3 berarti bahwa driver akan mengirim 3 paket keepalive yang belum terjawab sebelum menentukan bahwa koneksi tidak lagi aktif.

Jika parameter ini tidak ditentukan, Amazon Redshift menggunakan nilai default sistem.

Parameter ini bersifat opsional.

tcp_keepalive_interval

  • Nilai default - Tidak ada

  • Tipe data — Integer

Interval, dalam detik, antara probe keepalive berikutnya jika pengemudi tidak menerima pengakuan untuk probe sebelumnya. Jika Anda menentukan parameter ini, itu harus berupa bilangan bulat positif.

Jika parameter ini tidak ditentukan, Amazon Redshift menggunakan nilai default sistem.

Parameter ini bersifat opsional.

tcp_keepalive_idle

  • Nilai default - Tidak ada

  • Tipe data — Integer

Durasi ketidakaktifan, dalam hitungan detik, setelah itu pengemudi mengirimkan probe keepalive pertama. Misalnya, menyetel 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 berupa 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

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.

user

  • Nilai default - Tidak ada

  • Tipe data — String

Nama pengguna yang akan digunakan untuk otentikasi.

Parameter ini bersifat opsional.

token identitas web

  • 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 mengotentikasi 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.