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 driver ODBC
Anda dapat menggunakan opsi konfigurasi driver untuk mengontrol perilaku driver ODBC Amazon Redshift. Opsi driver tidak peka huruf besar/kecil.
Di Microsoft Windows, Anda biasanya mengatur opsi driver ketika Anda mengkonfigurasi 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 di. 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 ditetapkan dalam amazon.redshiftodbc.ini file berlaku untuk semua koneksi. Sebaliknya, opsi konfigurasi yang ditetapkan dalam odbc.ini file khusus untuk koneksi. Opsi konfigurasi yang ditetapkan 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:
Topik
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_id
-
Nilai Default - Tidak ada
-
Tipe Data - String
ID Okta-provided unik yang terkait dengan aplikasi Amazon Redshift Anda.
Parameter ini bersifat opsional.
ApplicationName
-
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.
nama_aplikasi
-
Nilai Default - Tidak ada
-
Tipe Data - String
Nama aplikasi Okta yang Anda gunakan untuk mengotentikasi 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 AccessKey ID 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 Pengaturan DSN Driver ODBC Amazon Redshift:
-
Standar: Otentikasi standar menggunakan nama pengguna dan kata sandi Amazon Redshift Anda.
-
AWS Profil: Otentikasi IAM menggunakan profil.
-
AWS KredenSIAL IAM: Otentikasi IAM menggunakan kredenSIAL IAM.
-
Penyedia Identitas: AD FS: Otentikasi IAM menggunakan Layanan Federasi Direktori Aktif (AD FS).
-
Penyedia Identitas: Plugin Auth: Plugin otorisasi yang menerima token Pusat Identitas AWS IAM atau token identitas OpenID Connect (OIDC) (JWT) dari penyedia JSON-based identitas web mana pun yang ditautkan ke Pusat Identitas IAM. AWS
-
Penyedia Identitas: Azure AD: Otentikasi IAM menggunakan portal Azure AD.
-
Penyedia Identitas: JWT: Otentikasi IAM menggunakan Token Web JSON (JWT).
-
Penyedia Identitas: Okta: Otentikasi IAM menggunakan Okta.
-
Penyedia Identitas: PingFederate: Otentikasi IAM menggunakan PingFederate.
Opsi ini hanya tersedia saat Anda mengonfigurasi DSN menggunakan kotak dialog Pengaturan DSN Driver ODBC Amazon Redshift 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 kredenSIAL yang Anda tentukan. Untuk menggunakan penyedia identitas, Anda harus mengatur properti plugin_name.
Parameter ini diperlukan.
AutoCreate
-
Nilai Default — 0
-
Tipe Data — Boolean
Sebuah boolean menentukan apakah driver membuat pengguna baru ketika pengguna yang ditentukan tidak ada.
-
1 | BENAR: Jika pengguna yang ditentukan oleh UID tidak ada, driver membuat pengguna baru.
-
0 | SALAH: Driver tidak membuat pengguna baru. Jika pengguna yang ditentukan tidak ada, otentikasi gagal.
Parameter ini bersifat opsional.
BoolsAsChar
-
Nilai Default — 0
-
Tipe Data — Boolean
Menentukan apakah driver melaporkan kolom BOOLEAN sebagai tipe karakter, bukan tipe bit.
-
1 | BENAR: Driver melaporkan kolom BOOLEAN sebagai SQL_VARCHAR dengan ukuran kolom 1. Driver mengembalikan nilai Boolean sebagai string karakter “0" dan “1".
-
0 | SALAH: Driver melaporkan kolom BOOLEAN sebagai SQL_BIT. Ini adalah perilaku default.
Gunakan opsi ini jika aplikasi Anda bergantung pada kolom BOOLEAN yang dikembalikan sebagai data karakter.
Parameter ini bersifat opsional. Opsi ini tersedia di versi driver 2.2.1 dan yang lebih baru.
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_id
-
Nilai Default - Tidak ada
-
Tipe Data - String
ID klien yang terkait dengan aplikasi Amazon Redshift Anda di Azure AD.
Parameter ini diperlukan jika mengotentikasi melalui layanan Azure AD.
klien_ rahasia
-
Nilai Default - Tidak ada
-
Tipe Data - String
Kunci rahasia yang terkait dengan aplikasi Amazon Redshift Anda di Azure AD.
Parameter ini diperlukan jika mengotentikasi 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 — nonaktif
-
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: Menetapkan metode kompresi yang digunakan untuk komunikasi protokol kawat dengan Amazon Redshift ke.
lz4 -
zstd: Menetapkan 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
Sebuah boolean menentukan apakah driver mengembalikan metadata dari beberapa database dan cluster.
-
1 | BENAR: Driver hanya mengembalikan metadata dari database saat ini.
-
0 | SALAH. Driver mengembalikan metadata di beberapa database dan cluster Amazon Redshift.
Parameter ini bersifat opsional.
dbgroups_filter
-
Nilai Default - Tidak ada
-
Tipe Data - String
Ekspresi reguler yang dapat Anda tentukan untuk DbGroups memfilter yang diterima dari respons SAML ke Amazon Redshift saat menggunakan jenis otentikasi Azure, Browser Azure, dan Browser SAML.
Parameter ini bersifat opsional.
Driver
-
Nilai Default - Driver ODBC Amazon Redshift (x64)
-
Tipe Data - String
Nama pengemudi. 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 SQLDriverConnect API.
Parameter ini diperlukan jika Anda tidak mengatur Driver. .
EnableTableTypes
-
Nilai Default - 1
-
Tipe Data — Boolean
Menentukan apakah driver mengenali informasi tipe tabel terperinci dari sumber data ketika aplikasi memanggil fungsi katalog SQLTables. Secara default, driver mengenali tipe tabel terperinci.
-
1 | BENAR: Pengemudi mengenali jenis tabel berikut: TABEL, TAMPILAN, TABEL SISTEM, TAMPILAN SISTEM, TABEL EKSTERNAL, dan TEMPORER LOKAL.
-
0 | SALAH: Driver menormalkan informasi tipe tabel terperinci ke dalam tipe tabel generik dan VIEW tabel.
Parameter ini bersifat opsional. Ini tersedia dalam versi driver 2.2.1 dan yang lebih baru.
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
Sebuah boolean yang menentukan apakah driver semua huruf kecil DbGroups dikirim dari penyedia identitas ke Amazon Redshift saat menggunakan otentikasi masuk tunggal.
-
1 | BENAR: Pengemudi menggunakan huruf kecil semua DbGroups yang dikirim dari penyedia identitas.
-
0 | SALAH: Pengemudi tidak berubah DbGroups.
Parameter ini bersifat opsional.
federasi grup
-
Nilai Default — 0
-
Tipe Data — Boolean
Sebuah boolean yang menentukan apakah getClusterCredentialsWithIAM API digunakan untuk mendapatkan kredentif cluster sementara di cluster 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 Serverless.
-
1 | BENAR: Driver menggunakan
getClusterCredentialsWithIAMAPI untuk mendapatkan kredenSIAL cluster sementara di cluster yang disediakan. -
0 | SALAH: Driver menggunakan
getClusterCredentialsAPI default untuk mendapatkan kredenSIAL cluster sementara di cluster yang disediakan.
Parameter ini bersifat opsional.
https_proxy_host
-
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.
https_proxy_password
-
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.
https_proxy_port
-
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.
https_proxy_nama 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
Sebuah boolean menentukan apakah driver menggunakan metode otentikasi IAM untuk mengotentikasi koneksi.
-
1 | BENAR: Pengemudi menggunakan salah satu metode otentikasi IAM (menggunakan kunci akses dan pasangan kunci rahasia, atau profil, atau layanan kredenSIAL).
-
0 | SALAH. Driver menggunakan otentikasi standar (menggunakan nama pengguna dan kata sandi database Anda).
Parameter ini bersifat opsional.
idc_client_tampilan_nama_
-
Nilai Default - Driver ODBC Amazon Redshift
-
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 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.
Parameter ini bersifat opsional.
idp_port
-
Nilai Default - Tidak ada
-
Tipe Data — Integer
Port untuk IdP (penyedia identitas) yang Anda gunakan untuk mengotentikasi ke Amazon Redshift. Bergantung pada port yang Anda pilih saat membuat, memodifikasi, atau memigrasikan cluster, izinkan akses ke port yang dipilih.
Parameter ini bersifat opsional.
idp_response_timeout
-
Nilai Default - 120
-
Tipe Data — Integer
Jumlah detik pengemudi menunggu respons SAML dari penyedia identitas saat menggunakan layanan SAML atau Azure AD melalui plugin browser.
Parameter ini bersifat opsional.
idp_tenant
-
Nilai Default - Tidak ada
-
Tipe Data - String
ID penyewa Azure AD yang terkait dengan aplikasi Amazon Redshift Anda.
Parameter ini diperlukan jika mengotentikasi melalui layanan Azure AD.
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.
idp_menggunakan_https_proxy
-
Nilai Default — 0
-
Tipe Data — Boolean
Sebuah boolean menentukan apakah driver melewati proses otentikasi untuk penyedia identitas (IdP) melalui server proxy.
-
1 | BENAR: Driver melewati proses otentikasi IdP melalui server proxy.
-
0 | SALAH. Driver tidak melewati proses otentikasi IdP melalui server proxy.
Parameter ini bersifat opsional.
InstanceProfile
-
Nilai Default — 0
-
Tipe Data — Boolean
Sebuah boolean yang menentukan apakah driver menggunakan profil instans Amazon EC2, saat dikonfigurasi untuk menggunakan profil untuk otentikasi.
-
1 | BENAR: Driver menggunakan profil instans Amazon EC2.
-
0 | SALAH. Pengemudi menggunakan profil peran beraneka yang ditentukan oleh opsi Nama Profil (Profil) sebagai gantinya.
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 diperlukan hanya saat mengotentikasi menggunakan BrowserIdcAuthPlugin opsi konfigurasi plugin_name.
KeepAlive
-
Nilai Default - 1
-
Tipe Data — Boolean
Sebuah boolean yang menentukan apakah driver menggunakan keepalives TCP untuk mencegah koneksi dari waktu habis.
-
1 | BENAR: Driver menggunakan keepalives TCP untuk mencegah koneksi habis waktu.
-
0 | SALAH. Driver 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 disetel 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 disetel ke 0, driver menggunakan sistem default untuk pengaturan ini.
Parameter ini bersifat opsional.
KeepAliveIdle
-
Nilai Default — 0
-
Tipe Data — Integer
Jumlah detik tidak aktif sebelum driver mengirim paket TCP keepalive. Ketika parameter ini disetel ke 0, driver menggunakan sistem default untuk pengaturan ini.
Parameter ini bersifat opsional.
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 untuk sumber daya di situs web penyedia identitas saat menggunakan plugin SAML Browser generik.
Parameter ini diperlukan jika melakukan otentikasi dengan layanan SAML atau Azure AD melalui plugin browser.
Masuk ToRp
-
Nilai Default — urn:amazon:webservices
-
Tipe Data - String
Kepercayaan pihak yang bergantung yang ingin Anda gunakan untuk jenis otentikasi AD FS.
String ini opsional.
LogLevel
-
Nilai Default — 0
-
Tipe Data — Integer
catatan
LogLeveldan LogPath merupakan pengaturan global. Pengemudi membacanya dalam urutan prioritas berikut:
-
Connection string (
LogLevel=6;LogPath=/path;) — prioritas tertinggi, mengesampingkan semua pengaturan lainnya pada waktu koneksi. -
Pada Windows: Dialog Pengaturan DSN (tab Lanjutan).
Di Linux dan macOS:
[ODBC]bagian dalamodbc.inifile Anda. -
[DRIVER]bagian dalamamazon.redshiftodbc.inifile — digunakan sebagai fallback jika logging tidak diaktifkan dari sumber di atas.
Pengaturan LogLevel atau LogPath di bagian DSN individu (misalnya,[MyDSN]) tidak berpengaruh. Opsi ini tidak dibaca dari bagian per-DSN.
Gunakan properti ini untuk mengaktifkan atau menonaktifkan logging di driver dan untuk menentukan jumlah detail yang disertakan dalam file log. Sebaiknya Anda hanya mengaktifkan logging cukup lama untuk menangkap masalah, karena pencatatan menurunkan kinerja dan dapat menghabiskan banyak ruang disk.
Atur properti ke salah satu nilai berikut:
-
0: MATI. Nonaktifkan semua logging.
-
1: FATAL. Dicadangkan untuk kesalahan fatal.
-
2: KESALAHAN. Mencatat peristiwa kesalahan seperti kegagalan koneksi dan kesalahan otentikasi.
-
3: MEMPERINGATKAN. Catatan peringatan dan kondisi tak terduga selain kesalahan.
-
4: INFO. Mencatat informasi kemajuan umum seperti status koneksi dan parameter server.
-
5: MEN-DEBUG. Mencatat semua aktivitas driver termasuk panggilan fungsi API ODBC dengan argumen dan nilai pengembalian.
-
6: JEJAK. Mencatat semua aktivitas pengemudi termasuk protokol tingkat rendah tambahan dan detail status internal.
penting
Log level 5 (DEBUG) atau lebih tinggi menangkap semua aktivitas driver, yang mungkin mencakup informasi sensitif seperti kredentif koneksi dan data kueri. Hanya aktifkan level log ini sementara untuk menangkap masalah, dan pastikan semua informasi sensitif disunting sebelum berbagi log dengan dukungan atau pihak ketiga mana pun.
Saat logging diaktifkan, driver menghasilkan file log berikut di lokasi yang Anda tentukan di LogPath properti:
-
redshift_odbc.log.1File yang mencatat aktivitas driver yang terjadi selama jabat tangan koneksi. -
redshift_odbc.logFile untuk semua aktivitas driver setelah koneksi dibuat ke database.
Parameter ini bersifat opsional.
LogPath
-
Nilai Default - Direktori OS-specific TEMP
-
Tipe Data - String
catatan
LogLeveldan LogPath merupakan pengaturan global. Pengemudi membacanya dalam urutan prioritas berikut:
-
Connection string (
LogLevel=6;LogPath=/path;) — prioritas tertinggi, mengesampingkan semua pengaturan lainnya pada waktu koneksi. -
Pada Windows: Dialog Pengaturan DSN (tab Lanjutan).
Di Linux dan macOS:
[ODBC]bagian dalamodbc.inifile Anda. -
[DRIVER]bagian dalamamazon.redshiftodbc.inifile — digunakan sebagai fallback jika logging tidak diaktifkan dari sumber di atas.
Pengaturan LogLevel atau LogPath di bagian DSN individu (misalnya,[MyDSN]) tidak berpengaruh. Opsi ini tidak dibaca dari bagian per-DSN.
Jalur lengkap ke folder tempat driver menyimpan file log ketika LogLevel lebih tinggi dari 0.
Parameter ini bersifat opsional.
LoginTimeout
-
Nilai Default — 0
-
Tipe Data — Integer
Jumlah detik pengemudi menunggu koneksi ke server dibuat sebelum waktu habis. Nilai 0 berarti tidak ada batas waktu (pengemudi menunggu tanpa batas waktu).
Anda dapat mengatur opsi ini di string koneksi (menggunakan LoginTimeout atau alias pendekLT), dalam konfigurasi DSN, atau secara terprogram menggunakan dengan. SQLSetConnectAttr SQL_ATTR_LOGIN_TIMEOUT Pada Windows, opsi ini juga tersedia di dialog Setup DSN (tab Advanced).
Parameter ini bersifat opsional.
MaxLongVarcharSize
-
Nilai Default - 65535
-
Tipe Data — Integer
Ukuran kolom yang dilaporkan pengemudi untuk kolom yang direklasifikasi sebagai teks besar () SQL_LONGVARCHAR oleh. MaxVarcharSize Nilai ini menggantikan ukuran sebenarnya yang dideklarasikan kolom dalam respons metadata.
Default 65.535 direkomendasikan karena beberapa lapisan middleware, seperti MSDASQL, menolak kolom teks besar yang ukuran dilaporkan berada di antara 8.001 dan 32.768 byte. Dengan melaporkan 65.535, pengemudi memastikan bahwa kolom yang direklasifikasi diterima tanpa kesalahan. Sebagian besar pengguna tidak perlu mengubah nilai ini.
Parameter ini tidak berpengaruh ketika MaxVarcharSize disetel ke 0 (reklasifikasi dinonaktifkan).
Parameter ini bersifat opsional. Ini tersedia dalam versi driver 2.1.16 dan yang lebih baru.
MaxVarcharSize
-
Nilai Default - 255
-
Tipe Data — Integer
Ukuran kolom maksimum yang dilaporkan pengemudi sebagai kolom teks biasa (SQL_VARCHAR). Driver mengklasifikasi ulang VARCHAR kolom CHAR dan kolom yang lebih besar dari nilai ini sebagai teks besar (SQL_LONGVARCHARatau SQL_WLONGVARCHAR ketika UseUnicode diaktifkan).
Reklasifikasi ini mencegah kesalahan dalam aplikasi atau lapisan middleware yang tidak dapat memproses kolom teks biasa di luar ukuran tertentu. Misalnya, server tertaut SQL Server yang mengakses Amazon Redshift melalui MSDASQL (OLE DB) tidak dapat memproses SQL_VARCHAR kolom yang lebih besar dari sekitar 8.000 byte, sehingga mengklasifikasi ulang kolom besar sebagai teks besar menghindari kegagalan konversi.
-
255(default): Kolom yang lebih besar dari 255 karakter dilaporkan sebagaiSQL_LONGVARCHAR. -
0: Menonaktifkan reklasifikasi. Semua kolom dilaporkanSQL_VARCHARterlepas dari ukurannya. -
Nilai kustom: Setiap bilangan bulat positif. Kolom yang lebih besar dari nilai yang ditentukan dilaporkan sebagai
SQL_LONGVARCHAR.
Ketika kolom direklasifikasi, pengemudi melaporkan ukurannya menggunakan nilai yang ditentukan dalam. MaxLongVarcharSize
Parameter ini bersifat opsional. Ini tersedia dalam versi driver 2.1.16 dan yang lebih baru.
Min_TLS
-
Nilai Default - 1.2
-
Tipe Data - String
Versi minimum driver memungkinkan penyimpanan data digunakan untuk mengenkripsi koneksi. TLS/SSL Misalnya, jika TLS 1.2 ditentukan, TLS 1.1 tidak dapat digunakan untuk mengenkripsi koneksi.
Min_TLS 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_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 | PWD
-
Nilai Default - Tidak ada
-
Tipe Data - String
Kata sandi yang sesuai dengan nama pengguna database yang Anda berikan di bidang Pengguna (UID | Pengguna | Logon ID).
Parameter ini bersifat opsional.
nama plugin
-
Nilai Default - Tidak ada
-
Tipe Data - String
Nama plugin penyedia kredensional 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 Pusat Identi AWS tas IAM. -
BrowserSAML: Gunakan plugin browser untuk layanan SAML seperti Okta atau Ping untuk otentikasi. -
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. -
JWT: Gunakan Token Web JSON (JWT) untuk otentikasi. -
Ping: Gunakan PingFederate layanan untuk otentikasi. -
Okta: Gunakan layanan Okta untuk otentikasi.
Parameter ini bersifat opsional.
Pelabuhan | PortNumber
-
Nilai Default - 5439
-
Tipe Data — Integer
Jumlah port TCP yang digunakan server Amazon Redshift untuk mendengarkan koneksi klien.
Parameter ini bersifat opsional.
Prefer_PQ
-
Nilai Default - 1
-
Tipe Data — Boolean
Menentukan apakah driver 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.
-
1 | BENAR: Pengemudi mengiklankan grup pertukaran kunci TLS hibrida pasca-kuantum.
-
0 | SALAH: 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.
Parameter ini bersifat opsional. Ini tersedia dalam versi driver 2.2.1 dan yang lebih baru.
peran yang disukai
-
Nilai Default - Tidak ada
-
Tipe Data - String
Peran yang ingin Anda ambil 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 mengotentikasi ke Amazon Redshift.
-
Jika parameter Use Instance Profile (InstanceProfileproperti) disetel ke 1 | TRUE, pengaturan tersebut diutamakan dan driver menggunakan profil instans Amazon EC2 sebagai gantinya.
-
Lokasi default untuk file kredenSIAL yang berisi profil adalah
~/.aws/Credentials. VariAWS_SHARED_CREDENTIALS_FILEabel lingkungan dapat digunakan untuk menunjuk ke file kredenSIAL yang berbeda.
Parameter ini bersifat opsional.
nama penyedia
-
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 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
-
Nilai 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
Sebuah boolean menentukan apakah driver dalam mode read-only.
-
1 | BENAR: Koneksi dalam mode read-only, dan tidak dapat menulis ke penyimpanan data.
-
0 | SALAH: Koneksi tidak dalam mode baca-saja, dan dapat menulis ke penyimpanan data.
Parameter ini bersifat opsional.
region
-
Nilai Default - Tidak ada
-
Tipe Data - String
Wil AWS ayah 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 AccessKey ID.
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.
Parameter ini bersifat opsional.
Server | HostName | Tuan rumah
-
Nilai Default - Tidak ada
-
Tipe Data - String
Server titik akhir untuk dihubungkan.
Parameter ini diperlukan.
ssl_tidak aman
-
Nilai Default — 0
-
Tipe Data — Boolean
Sebuah boolean menentukan apakah driver memeriksa keaslian sertifikat server IdP.
-
1 | BENAR: Driver tidak memeriksa keaslian sertifikat server IdP.
-
0 | SALAH: Driver memeriksa keaslian sertifikat server IdP
Parameter ini bersifat opsional.
Mode SSL
-
Nilai Default -
verify-ca -
Tipe Data - String
Mode verifikasi sertifikat SSL untuk digunakan saat menghubungkan ke Amazon Redshift. Nilai-nilai berikut dimungkinkan:
-
verify-full: Hubungkan hanya menggunakan SSL, otoritas sertifikat tepercaya, dan nama server yang cocok dengan sertifikat. -
verify-ca: Hubungkan hanya menggunakan SSL dan otoritas sertifikat tepercaya. -
require: Hubungkan hanya menggunakan SSL. -
prefer: Hubungkan 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: Hubungkan tanpa menggunakan SSL.
Parameter ini bersifat opsional.
StreamingCursorRows
-
Nilai Default — 0
-
Tipe Data — Integer
Jumlah baris yang diambil driver per batch saat menggunakan mode kursor streaming. Ketika disetel ke bilangan bulat positif dan jenis kursor hanya maju, driver membaca baris dari server dalam batch dengan ukuran yang ditentukan alih-alih memuat seluruh hasil yang ditetapkan ke dalam memori.
Atur properti ke salah satu nilai berikut:
-
0: Dinonaktifkan. Driver memuat seluruh hasil yang ditetapkan ke dalam memori (default).
-
Integer positif: Jumlah baris per batch streaming.
Mode kursor streaming memerlukan kursor maju saja. Jika opsi Client Side Cursor (CSC) diaktifkan, itu mengambil prioritas dan mode kursor streaming dinonaktifkan.
catatan
Opsi ini menggantikan opsi UseDeclareFetch dan Fetch (Ukuran Cache) dari driver ODBC versi 1.x. Tidak seperti pendekatan kursor sisi server sebelumnya, mode kursor streaming tidak memerlukan pembungkus transaksi atau beberapa perjalanan pulang pergi server.
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, pengemudi menunggu 60 detik untuk setiap AWS STS panggilan.
Parameter ini bersifat opsional.
StsEndpointUrl
-
Nilai Default - Tidak ada
-
Tipe Data - String
Opsi ini menentukan titik akhir penggantian yang digunakan untuk berkomunikasi dengan AWS Security Token Service (AWS STS).
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.
UID | Pengguna | 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
Sebuah boolean menentukan apakah driver mengembalikan data Redshift sebagai Unicode atau tipe SQL biasa.
-
1 | BENAR: Driver mengembalikan tipe SQL lebar untuk tipe data karakter.
-
SQL_WCHAR dikembalikan alih-alih SQL_CHAR.
-
SQL_WVARCHAR dikembalikan alih-alih SQL_VARCHAR.
-
SQL_WLONGVARCHAR dikembalikan alih-alih SQL_LONGVARCHAR.
-
-
0 | SALAH: Driver mengembalikan tipe SQL normal untuk tipe data karakter.
-
SQL_CHAR dikembalikan alih-alih SQL_WCHAR.
-
SQL_VARCHAR dikembalikan alih-alih SQL_WVARCHAR.
-
SQL_LONGVARCHAR dikembalikan alih-alih SQL_WLONGVARCHAR.
-
Parameter ini bersifat opsional. Ini tersedia dalam versi driver 2.1.15 dan yang lebih baru.
token identitas web
-
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_name ke. BasicJwtCredentialsProvider
