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 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
DbUsernilai dari pernyataan Security Assertion Markup Language (SAML). - False
-
Menentukan bahwa nilai dalam parameter
DbUserkoneksi 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.