Amazon Redshift unterstützt ab dem 1. November 2025 nicht mehr die Erstellung neuer Python-UDFs. Wenn Sie Python-UDFs verwenden möchten, erstellen Sie die UDFs vor diesem Datum. Bestehende Python-UDFs funktionieren weiterhin wie gewohnt. Weitere Informationen finden Sie im Blog-Posting
Konfigurationsoptionen für die JDBC-Treiberversion 2.x
Im Folgenden finden Sie Beschreibungen für die Optionen, die Sie für Version 2.2 des Amazon-Redshift-JDBC-Treibers angeben können. Bei den Konfigurationsoptionen wird die Groß-/Kleinschreibung nicht beachtet.
Sie können Konfigurationseigenschaften mithilfe der Verbindungs-URL festlegen. Weitere Informationen finden Sie unter Erstellen der Verbindungs-URL.
Themen
AccessKeyID
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Sie können diesen Parameter angeben, um den IAM-Zugriffsschlüssel für den Benutzer oder die Rolle einzugeben. Sie finden den Schlüssel normalerweise in einer vorhandenen Zeichenfolge oder einem vorhandenen Benutzerprofil. Wenn Sie diesen Parameter angeben, müssen Sie auch den Parameter SecretAccessKey angeben: Der Wert AccessKeyID muss URL-codiert sein, wenn er in der JDBC-URL übergeben wird.
Dieser Parameter ist optional.
AllowDBUserOverride
-
Standardwert – 0
-
Datentyp – Zeichenfolge
Diese Option gibt an, ob der Treiber den Wert von DbUser aus der SAML-Assertion verwendet oder den Wert, der in der Verbindungseigenschaft DbUser in der Verbindungs-URL angegeben ist.
Dieser Parameter ist optional.
- 1
-
Der Treiber verwendet den Wert
DbUseraus der SAML-Assertion.Wenn die SAML-Assertion keinen Wert für
DBUserangibt, verwendet der Treiber den Wert, der in derDBUser-Verbindungseigenschaft angegeben ist. Wenn die Verbindungseigenschaft auch keinen Wert angibt, verwendet der Treiber den Wert, der im Verbindungsprofil angegeben ist. - 0
-
Der Treiber verwendet den
DBUser-Wert, der in derDBUser-Verbindungseigenschaft angegeben ist.Wenn die
DBUser-Verbindungseigenschaft keinen Wert angibt, verwendet der Treiber den Wert, der im Verbindungsprofil angegeben ist. Wenn das Verbindungsprofil auch keinen Wert angibt, verwendet der Treiber den Wert aus der SAML-Assertion.
App_ID
-
Standardwert – None
-
Datentyp – Zeichenfolge
Die von Okta bereitgestellte eindeutige ID, die mit Ihrer Amazon-Redshift-Anwendung verknüpft ist.
Dieser Parameter ist erforderlich, wenn die Authentifizierung über den Okta-Service erfolgt.
App_Name
-
Standardwert – None
-
Datentyp – Zeichenfolge
Der Name der Okta-Anwendung, mit der Sie die Verbindung zu Amazon Redshift authentifizieren.
Dieser Parameter ist optional.
ApplicationName
-
Standardwert – Null
-
Datentyp – Zeichenfolge
Der Name der Anwendung, die zu Prüfungszwecken an Amazon Redshift übergeben wird.
Dieser Parameter ist optional.
AuthProfile
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Der Name des Authentifizierungsprofils, das für die Verbindung mit Amazon Redshift verwendet werden soll.
Dieser Parameter ist optional.
AutoCreate
-
Standardwert – false
-
Datentyp – boolesch
Diese Option gibt an, ob der Treiber dazu führt, dass ein neuer Benutzer erstellt wird, wenn der angegebene Benutzer nicht existiert.
Dieser Parameter ist optional.
- true
-
Wenn der Benutzer, der durch
DBUseroder eine eindeutige ID (UID) angegeben wird, nicht vorhanden ist, wird ein neuer Benutzer mit diesem Namen erstellt. - false
-
Der Treiber führt nicht dazu, dass neue Benutzer erstellt werden. Wenn der angegebene Benutzer nicht vorhanden ist, schlägt die Authentifizierung fehl.
Client_ID
-
Standardwert – None
-
Datentyp – Zeichenfolge
Die Client-ID, die beim Authentifizieren der Verbindung mit dem Azure-AD-Dienst verwendet werden soll.
Dieser Parameter ist erforderlich, wenn die Authentifizierung über den Azure-AD-Service erfolgt.
Client_Secret
-
Standardwert – None
-
Datentyp – Zeichenfolge
Das Client-Secret, das beim Authentifizieren der Verbindung mit dem Azure-AD-Dienst verwendet werden soll.
Dieser Parameter ist erforderlich, wenn die Authentifizierung über den Azure-AD-Service erfolgt.
ClusterID
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Der Name des Amazon-Redshift-Clusters, mit dem Sie eine Verbindung herstellen möchten. Der Treiber versucht, diesen Parameter vom angegebenen Host zu erkennen. Wenn Sie einen Network Load Balancer (NLB) verwenden und über IAM eine Verbindung herstellen, wird der Treiber ihn nicht erkennen, daher können Sie ihn unter Verwendung dieser Verbindungsoption einstellen.
Dieser Parameter ist optional.
Komprimierung
-
Standardwert – aus
-
Datentyp – Zeichenfolge
Die Komprimierungsmethode, die für die Wire-Protokollkommunikation zwischen dem Amazon-Redshift-Server und dem Client oder Treiber verwendet wird.
Dieser Parameter ist optional.
Sie können die folgenden Werte angeben:
-
lz4
Legt für die Komprimierungsmethode, die für die Wire-Protokollkommunikation mit Amazon Redshift verwendet wird, lz4 fest.
-
aus
Für die Wire-Protokollkommunikation mit Amazon Redshift wird keine Komprimierungsmethode verwendet.
ConnectTimeout
-
Standardwert – 10
-
Datentyp – Ganzzahl
Der Timeout-Wert, der für Socket-Connect-Vorgänge verwendet werden soll. Wenn die zum Herstellen einer Amazon-Redshift-Verbindung erforderliche Zeit diesen Wert überschreitet, gilt die Verbindung als nicht verfügbar. Das Timeout wird in Sekunden angegeben. Ein Wert von 0 bedeutet, dass kein Timeout angegeben wird.
Dieser Parameter ist optional.
connectionTimezone
-
Standardwert – LOKAL
-
Datentyp – Zeichenfolge
Die Zeitzone auf Sitzungsebene.
Dieser Parameter ist optional.
Sie können die folgenden Werte angeben:
- LOCAL
-
Konfiguriert für die Zeitzone auf Sitzungsebene die Zeitzone LOCAL JVM.
- SERVER
-
Konfiguriert für die Zeitzone auf Sitzungsebene die Zeitzone, die für den Benutzer auf dem Amazon-Redshift-Server festgelegt wurde. Mit dem folgenden Befehl können Sie Zeitzonen auf Sitzungsebene für Benutzer konfigurieren:
ALTER USER [...] SET TIMEZONE TO [...];
DatabaseMetadataCurrentDbOnly
-
Standardwert – true
-
Datentyp – boolesch
Diese Option gibt an, ob die Metadaten-API Daten aus allen zugänglichen Datenbanken oder nur aus der verbundenen Datenbank abruft.
Dieser Parameter ist optional.
Sie können die folgenden Werte angeben:
- true
-
Die Anwendung ruft Metadaten aus einer einzelnen Datenbank ab.
- false
-
Die Anwendung ruft Metadaten aus allen zugänglichen Datenbanken ab.
DbUser
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Die Benutzer-ID, die mit Ihrem Amazon-Redshift-Konto verwendet werden soll. Sie können eine ID verwenden, die derzeit nicht vorhanden ist, wenn Sie die AutoCreate-Eigenschaft aktiviert haben.
Dieser Parameter ist optional.
DbGroups
-
Standardwert – PUBLIC
-
Datentyp – Zeichenfolge
Eine durch Komma getrennte Liste vorhandener Datenbankgruppennamen, die DBUser für die aktuelle Sitzung verbindet.
Dieser Parameter ist optional.
DBNAME
-
Standardwert – Null
-
Datentyp – Zeichenfolge
Der Name der Datenbank, mit der eine Verbindung hergestellt werden soll. Mit dieser Option können Sie den Datenbanknamen in der JDBC-Verbindungs-URL angeben.
Dieser Parameter muss angegeben werden. Sie müssen den Datenbanknamen entweder in der Verbindungs-URL oder in den Verbindungseigenschaften der Clientanwendung angeben.
defaultRowFetchSize
-
Standardwert – 0
-
Datentyp – Ganzzahl
Diese Option gibt einen Standardwert für getFetchSize an.
Dieser Parameter ist optional.
Sie können die folgenden Werte angeben:
- 0
-
Ruft alle Zeilen in einer einzigen Operation ab.
- Positive Ganzzahl
-
Anzahl der Zeilen, die für jede Abrufiteration des ResultSet aus der Datenbank abgerufen werden sollen.
DisableIsValidQuery
-
Standardwert – False
-
Datentyp – boolesch
Diese Option gibt an, ob der Treiber eine neue Datenbankabfrage sendet, wenn die Methode Connection.isValid() verwendet wird, um zu bestimmen, ob die Datenbankverbindung aktiv ist.
Dieser Parameter ist optional.
- true
-
Der Treiber sendet keine Abfrage, wenn mit .Connection.isValid() bestimmt wird, ob die Datenbankverbindung aktiv ist. Dies kann dazu führen, dass der Treiber die Datenbankverbindung fälschlicherweise als aktiv identifiziert, wenn der Datenbankserver unerwartet heruntergefahren wurde.
- false
-
Der Treiber sendet eine Abfrage, wenn mit .Connection.isValid() bestimmt wird, ob die Datenbankverbindung aktiv ist.
enableFetchRingBuffer
-
Standardwert – true
-
Datentyp – boolesch
Diese Option gibt an, dass der Treiber Zeilen mit einem Ringpuffer in einem separaten Thread abruft. Der Parameter fetchRingBufferSize gibt die Größe des Ringpuffers an.
Wenn eine Transaktion eine Anweisung erkennt, die mehrere durch Semikolon getrennte SQL-Befehle enthält, wird der Abrufringpuffer für diese Transaktion auf „false“ festgelegt. Der Wert von enableFetchRingBuffer ändert sich nicht.
Dieser Parameter ist optional.
enableMultiSqlSupport
-
Standardwert – true
-
Datentyp – boolesch
Diese Option gibt an, ob mehrere SQL-Befehle in einer Anweisung durch Semikolons getrennt verarbeitet werden sollen.
Dieser Parameter ist optional.
Sie können die folgenden Werte angeben:
- true
-
Der Treiber verarbeitet mehrere SQL-Befehle, getrennt durch Semikolon, in einem Anweisungsobjekt.
- false
-
Der Treiber gibt einen Fehler für mehrere SQL-Befehle in einer einzelnen Anweisung zurück.
fetchRingBufferSize
-
Standardwert – 1G
-
Datentyp – Zeichenfolge
Diese Option gibt die Größe des Ringpuffers an, der beim Abrufen der Ergebnismenge verwendet wird. Sie können eine Größe in Byte angeben, z. B. 1K für 1 KB, 5000 für 5 000 Byte, 1M für 1 MB, 1G für 1 GB usw. Sie können auch einen Prozentsatz des Heap-Arbeitsspeichers angeben. Der Treiber stoppt das Abrufen von Zeilen, wenn das Limit erreicht ist. Der Abruf wird fortgesetzt, wenn die Anwendung Zeilen liest und Speicherplatz im Ringpuffer freigibt.
Dieser Parameter ist optional.
ForceLowercase
-
Standardwert – false
-
Datentyp – boolesch
Diese Option gibt an, ob der Treiber alle Datenbankgruppen (DbGroups), die vom Identitätsanbieter an Amazon Redshift gesendet werden, bei Verwendung der Single-Sign-On-Authentifizierung in Kleinbuchstaben schreibt.
Dieser Parameter ist optional.
- true
-
Der Treiber schreibt alle Datenbankgruppen in Kleinbuchstaben, die vom Identitätsanbieter gesendet werden.
- false
-
Der Treiber ändert Datenbankgruppen nicht.
groupFederation
-
Standardwert – false
-
Datentyp – boolesch
Diese Option gibt an, ob Amazon-Redshift-IDP-Gruppen verwendet werden sollen. Dies wird von der GetClusterCredentialSv2-API unterstützt.
Dieser Parameter ist optional.
- true
-
Verwenden Sie Amazon Redshift-Identity-Provider (IDP)-Gruppen.
- false
-
Verwenden Sie STS-API und GetClusterCredentials für den Benutzerverbund und geben Sie explizit DbGroups für die Verbindung an.
HOST
-
Standardwert – Null
-
Datentyp – Zeichenfolge
Der Hostname des Amazon-Redshift-Servers, mit dem eine Verbindung hergestellt werden soll. Mit dieser Option können Sie den Hostnamen in der JDBC-Verbindungs-URL angeben.
Dieser Parameter muss angegeben werden. Sie müssen den Hostnamen entweder in der Verbindungs-URL oder in den Verbindungseigenschaften der Clientanwendung angeben.
IAMDisableCache
-
Standardwert – false
-
Datentyp – boolesch
Diese Option gibt an, ob die IAM-Anmeldeinformationen zwischengespeichert werden.
Dieser Parameter ist optional.
- true
-
Die IAM-Anmeldeinformationen werden nicht zwischengespeichert.
- false
-
Die IAM-Anmeldeinformationen werden zwischengespeichert. Dies verbessert die Leistung, wenn beispielsweise Anfragen an das API-Gateway gedrosselt werden.
IAMDuration
-
Standardwert – 900
-
Datentyp – Ganzzahl
Die Zeitdauer in Sekunden, bis die temporären IAM-Anmeldeinformationen ablaufen.
-
Mindestwert – 900
-
Maximaler Wert – 3,600
Dieser Parameter ist optional.
Idc_Client_Display_Name
-
Standardwert – JDBC-Treiber von Amazon Redshift
-
Datentyp – Zeichenfolge
Der Anzeigename, der für den Client verwendet werden soll, der BrowserIdcAuthPlugin verwendet.
Dieser Parameter ist optional.
Idc_Region
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Die AWS-Region, in der sich die IAM-Identity-Center-Instance befindet.
Dieser Parameter ist nur erforderlich, wenn eine Authentifizierung mit BrowserIdcAuthPlugin in der Konfigurationsoption plugin_name erfolgt.
IdP_Host
-
Standardwert – None
-
Datentyp – Zeichenfolge
Der IdP-Host (Identitätsanbieter), den Sie zur Authentifizierung bei Amazon Redshift verwenden. Kann entweder in der Verbindungszeichenfolge oder in einem Profil angegeben werden.
Dieser Parameter ist optional.
IdP_Partition
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Die Partition, in der Ihr Idp (Identitätsanbieter) eingerichtet ist. Eine Partition ist eine Gruppe von AWS-Regionen. Weitere Informationen zu Partitionen finden Sie unter Partitionierung im AWS-Glossar.
Wenn dieser Parameter leer gelassen wird, verwendet Amazon Redshift routinemäßig die AWS-Standardpartition, die alle kommerziellen AWS-Regionen enthält. Die möglichen Werte lauten wie folgt:
us-gov– Der IdP ist in den AWS GovCloud (US) Regions eingerichtet.cn– Der IdP ist in den Regionen Chinas eingerichtet.
Dieser Parameter ist optional.
IdP_Port
-
Standardwert – None
-
Datentyp – Zeichenfolge
Der vom IdP (Identitätsanbieter) verwendete Port. Sie können den Port entweder in der Verbindungszeichenfolge oder in einem Profil angeben. Der Standard-Port ist 5439. Erlauben Sie den Zugriff auf den ausgewählten Port, je nachdem, welchen Port Sie beim Erstellen, Ändern oder Migrieren des Clusters ausgewählt haben.
Dieser Parameter ist optional.
IdP_Tenant
-
Standardwert – None
-
Datentyp – Zeichenfolge
Die Azure-AD-Mandanten-ID für Ihre Amazon-Redshift-Anwendung.
Dieser Parameter ist erforderlich, wenn die Authentifizierung über den Azure-AD-Service erfolgt.
IdP_Response_Timeout
-
Standardwert – 120
-
Datentyp – Ganzzahl
Die Zeitspanne in Sekunden, die der Treiber auf die SAML-Antwort vom Identitätsanbieter wartet, wenn die SAML- oder Azure AD-Services über ein Browser-Plug-In verwendet werden.
Dieser Parameter ist optional.
IniFile
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Der vollständige Dateipfad der .ini-Datei einschließlich des Dateinamens. Zum Beispiel:
IniFile="C:\tools\rsjdbc.ini"
Informationen zur .ini-Datei finden Sie unter Erstellen von Initialisierungsdateien (.ini) für die JDBC-Treiberversion 2.x.
Dieser Parameter ist optional.
IniSection
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Der Name eines Abschnitts in der .ini-Datei, der die Konfigurationsoptionen enthält. Informationen zur .ini-Datei finden Sie unter Erstellen von Initialisierungsdateien (.ini) für die JDBC-Treiberversion 2.x.
Im folgenden Beispiel wird der Abschnitt [Prod] der .ini-Datei angegeben:
IniSection="Prod"
Dieser Parameter ist optional.
isServerless
-
Standardwert – false
-
Datentyp – boolesch
Diese Option gibt an, ob der Amazon-Redshift-Endpunkthost eine Serverless-Instance ist. Der Treiber versucht, diesen Parameter vom angegebenen Host zu erkennen. Wenn Sie einen Network Load Balancer (NLB) verwenden, wird der Treiber ihn nicht erkennen, also können Sie ihn hier einstellen.
Dieser Parameter ist optional.
- true
-
Der Amazon-Redshift-Endpunkthost ist eine Serverless-Instance.
- false
-
Der Amazon-Redshift-Endpunkthost ist ein bereitgestellter Cluster.
Issuer_Url
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Verweist auf den Instance-Endpunkt des Servers von AWS IAM Identity Center.
Dieser Parameter ist nur erforderlich, wenn eine Authentifizierung mit BrowserIdcAuthPlugin in der Konfigurationsoption plugin_name erfolgt.
Listen_Port
-
Standardwert – 7890
-
Datentyp – Ganzzahl
Der Port, den der Treiber verwendet, um die SAML-Antwort vom Identitätsanbieter zu empfangen, wenn Services von SAML, Azure AD oder AWS Identity Center über ein Browser-Plugin verwendet werden.
Dieser Parameter ist optional.
Login_URL
-
Standardwert – None
-
Datentyp – Zeichenfolge
Die URL für die Ressource auf der Website des Identitätsanbieters, wenn die SAML- oder Azure-AD-Services über ein Browser-Plug-In verwendet werden.
Dieser Parameter ist erforderlich, wenn die Authentifizierung über die SAML- oder Azure-AD-Services über ein Browser-Plug-In erfolgt.
loginTimeout
-
Standardwert – 0
-
Datentyp – Ganzzahl
Die Anzahl der Sekunden, die gewartet werden soll, bevor eine Zeitüberschreitung für einen Verbindungs- und Authentifizierungsversuch mit dem Server eintritt. Wenn es länger dauert, eine Verbindung mit dem Server herzustellen, als durch diesen Schwellenwert angegeben, wird die Verbindung abgebrochen.
Wenn diese Eigenschaft auf 0 festgelegt ist, treten keine Zeitüberschreitungen für Verbindungen ein.
Dieser Parameter ist optional.
loginToRp
-
Standardwert –
urn:amazon:webservices -
Datentyp – Zeichenfolge
Die Vertrauensstellung die Sie für den AD-FS-Authentifizierungstyp verwenden möchten.
Dieser Parameter ist optional.
LogLevel
-
Standardwert – 0
-
Datentyp – Ganzzahl
Verwenden Sie diese Eigenschaft, um die Protokollierung im Treiber zu aktivieren oder zu deaktivieren und den Grad an Details anzugeben, die in den Protokolldateien enthalten sein sollen.
Aktivieren Sie die Protokollierung nur lange genug, um ein Problem zu erfassen. Die Protokollierung reduziert die Leistung und kann eine große Menge an Datenträgerplatz verbrauchen.
Dieser Parameter ist optional.
Legen Sie den Parameter auf einen der folgenden Werte fest:
- 0
-
Deaktiviert die gesamte Protokollierung.
- 1
-
Aktiviert die Protokollierung auf der Ebene FATAL, die sehr schwerwiegende Fehlerereignisse protokolliert, die zu einem Absturz des Treibers führen.
- 2
-
Aktiviert die Protokollierung auf der Ebene ERROR, die Fehlerereignisse protokolliert, bei denen der Treiber weiter ausgeführt werden kann.
- 3
-
Aktivieren Sie die Protokollierung auf der Ebene WARNING, die Ereignisse protokolliert, die möglicherweise zu einem Fehler führen, wenn nicht unternommen wird.
- 4
-
Aktivieren Sie die Protokollierung auf der Ebene INFO, die allgemeine Informationen protokolliert, die den Fortschritt des Treibers beschreiben.
- 5
-
Aktivieren Sie die Protokollierung auf der Ebene DEBUG, die detaillierte Informationen protokolliert, die für das Debuggen des Treibers nützlich sind.
- 6
-
Aktivieren Sie die Protokollierung auf der Ebene TRACE, die alle Treiberaktivitäten protokolliert.
Wenn die Protokollierung aktiviert ist, erstellt der Treiber die folgenden Protokolldateien an dem Speicherort, der in der Eigenschaft LogPath angegeben ist.
-
redshift_jdbc.log– Diese Datei protokolliert Treiberaktivitäten, die nicht für die Verbindung spezifisch sind. -
redshift_jdbc_connection_[Number].log– Datei für jede Verbindung mit der Datenbank, wobei[Number]eine Nummer zur Unterscheidung der Protokolldateien ist. Diese Datei protokolliert Treiberaktivitäten, die für die Verbindung spezifisch sind.
Wenn der LogPath-Wert ungültig ist, sendet der Treiber die protokollierten Informationen an den Standardausgabestream, System.out.
LogPath
-
Standardwert – Das aktuelle Arbeitsverzeichnis.
-
Datentyp – Zeichenfolge
Der vollständige Pfad zu dem Ordner, in dem der Treiber Protokolldateien speichert, wenn die DSILogLevel-Eigenschaft aktiviert ist.
Um sicherzustellen, dass die Verbindungs-URL mit allen JDBC-Anwendungen kompatibel ist, empfehlen wir, die umgekehrten Schrägstriche (\) in Ihrem Dateipfad mit einem zusätzlichen umgekehrten Schrägstrich zu escapen.
Dieser Parameter ist optional.
OverrideSchemaPatternType
-
Standardwert – Null
-
Datentyp – Ganzzahl
Diese Option gibt an, ob der Abfragetyp, der in getTables-Aufrufen verwendet wird, überschrieben werden soll.
- 0
-
Keine universelle Schemaabfrage
- 1
-
Abfrage von lokalen Schemata
- 2
-
Abfrage von externen Schemata
Dieser Parameter ist optional.
Partner_SPID
-
Standardwert – None
-
Datentyp – Zeichenfolge
Der SPID-Wert des Partners (Service Provider ID), der bei der Authentifizierung der Verbindung mit dem PingFederate-Service verwendet werden soll.
Dieser Parameter ist optional.
Passwort
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Wenn Sie eine Verbindung mit IAM-Authentifizierung über einen IDP herstellen, ist dies das Kennwort für den IDP_Host-Server. Bei Verwendung der Standardauthentifizierung kann dies für das Amazon-Redshift-Datenbankkennwort anstelle von PWD verwendet werden.
Dieser Parameter ist optional.
Plugin_Name
-
Standardwert – None
-
Datentyp – Zeichenfolge
Der vollqualifizierte Klassenname zur Implementierung eines spezifischen Anmeldeinformationsanbieters.
Dieser Parameter ist optional.
Folgende Anbieteroptionen werden unterstützt:
-
AdfsCredentialsProvider– Active Directory Federation Service. -
AzureCredentialsProvider– Microsoft Azure Active Directory (AD) Service. -
BasicJwtCredentialsProvider– JSON Web Tokens (JWT) Service. -
BasicSamlCredentialsProvider– SAML-Anmeldeinformationen (Security Assertion Markup Language), die Sie mit vielen SAML-Dienstanbietern verwenden können. -
BrowserAzureCredentialsProvider– Browser Microsoft Azure Active Directory (AD) Service. -
BrowserAzureOAuth2CredentialsProvider– Microsoft Azure Active Directory (AD)-Browserservice für die systemeigene Authentifizierung -
BrowserIdcAuthPlugin– Ein Autorisierungs-Plugin, das AWS IAM Identity Center verwendet. -
BrowserSamlCredentialsProvider– Browser-SAML für SAML-Services wie Okta, Ping oder ADFS. -
IdpTokenAuthPlugin– Ein Autorisierungs-Plugin, das ein Token von AWS IAM Identity Center oder Identitätstoken auf Basis von OpenID Connect (OIDC) JSON (JWT) von jedem Web-Identitätsanbieter akzeptiert, der mit AWS IAM Identity Center verknüpft ist. -
OktaCredentialsProvider– Okta-Service -
PingCredentialsProvider– PingFederate-Service
PORT
-
Standardwert – Null
-
Datentyp – Ganzzahl
Der Port des Amazon-Redshift-Servers, zu dem eine Verbindung hergestellt werden soll. Mit dieser Option können Sie den Port in der JDBC-Verbindungs-URL angeben.
Dieser Parameter ist optional.
Preferred_Role
-
Standardwert – None
-
Datentyp – Zeichenfolge
IAM-Rolle, die Sie während der Verbindung mit Amazon Redshift übernehmen möchten.
Dieser Parameter ist optional.
Profil
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Der Name des Profils für die IAM-Authentifizierung. Dieses Profil enthält alle zusätzlichen Verbindungseigenschaften, die nicht in der Verbindungszeichenfolge angegeben sind.
Dieser Parameter ist optional.
PWD
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Das Passwort, das dem Amazon-Redshift-Benutzernamen entspricht, den Sie mithilfe der Eigenschaften-UID angegeben haben.
Dieser Parameter ist optional.
QueryGroup
-
Standardwert – Null
-
Datentyp – Zeichenfolge
Diese Option weist eine Abfrage zur Laufzeit einer Warteschlange zu, indem Sie die Abfrage der entsprechenden Abfragegruppe zuweisen. Die Abfragegruppe wird für die Sitzung festgelegt. Alle Abfragen, die für die Verbindung ausgeführt werden, gehören zu dieser Abfragegruppe.
Dieser Parameter ist optional.
readOnly
-
Standardwert – false
-
Datentyp – boolesch
Diese Eigenschaft gibt an, ob sich der Treiber im schreibgeschützten Modus befindet.
Dieser Parameter ist optional.
- true
-
Die Verbindung befindet sich im schreibgeschützten Modus und kann nicht in den Datenspeicher schreiben.
- false
-
Die Verbindung befindet sich nicht im schreibgeschützten Modus und kann in den Datenspeicher schreiben.
Region
-
Standardwert – Null
-
Datentyp – Zeichenfolge
Diese Option gibt die AWS-Region an, in der sich der Cluster befindet. Wenn Sie die Option StsEndPoint angeben, wird die Option „Region“ ignoriert. Die Redshift-API-Operation GetClusterCredentials verwendet auch die Option „Region“.
Dieser Parameter ist optional.
reWriteBatchedInserts
-
Standardwert – false
-
Datentyp – boolesch
Diese Option ermöglicht die Optimierung, um kompatible INSERT-Anweisungen neu zu schreiben und zu kombinieren, die als Batch ausgeführt werden.
Dieser Parameter ist optional.
reWriteBatchedInsertsSize
-
Standardwert – 128
-
Datentyp – Ganzzahl
Diese Option ermöglicht die Optimierung, um kompatible INSERT-Anweisungen neu zu schreiben und zu kombinieren, die als Batch ausgeführt werden. Dieser Wert muss exponentiell um die Potenz von 2 erhöht werden.
Dieser Parameter ist optional.
roleArn
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Der Amazon-Ressourcenname (ARN) der Rolle. Stellen Sie sicher, dass Sie diesen Parameter angeben, wenn Sie BasicJwtCredentialsProvider für die Option Plugin_Name angeben. Sie geben den ARN im folgenden Format an:
arn:partition:service:region:account-id:resource-id
Dieser Parameter ist erforderlich, wenn Sie BasicJwtCredentialsProvider für die Option Plugin_Name angeben.
roleSessionName
-
Standardwert – jwt_redshift_session
-
Datentyp – Zeichenfolge
Ein Bezeichner für die Sitzung der angenommenen Rolle. Normalerweise übergeben Sie den Namen oder den Bezeichner, der dem Benutzer Ihrer Anwendung zugeordnet ist. Die temporären Sicherheitsanmeldeinformationen, die Ihre Anwendung verwendet, sind diesem Benutzer zugeordnet. Sie können diesen Parameter angeben, wenn Sie BasicJwtCredentialsProvider für die Option Plugin_Name angeben.
Dieser Parameter ist optional.
scope
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Eine durch Leerzeichen getrennte Liste von Bereichen, denen der Benutzer zustimmen kann. Sie geben diesen Parameter an, damit Ihre Microsoft-Azure-Anwendung die Zustimmung zu APIs einholen kann, die Sie aufrufen möchten. Sie können diesen Parameter angeben, wenn Sie BrowserAzureOAuth2CredentialsProvider für die Option Plugin_Name angeben.
Dieser Parameter ist für das Plug-in BrowserAzureOAuth2CredentialsProvider erforderlich.
SecretAccessKey
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Der IAM-Zugriffsschlüssel für den Benutzer oder die Rolle. Wenn dies angegeben ist, muss AccessKeyID auch angegeben werden. Der Wert SecretAccessKey muss URL-codiert sein, wenn er in der JDBC-URL übergeben wird.
Dieser Parameter ist optional.
SessionToken
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Das temporäre IAM-Sitzungstoken, das der IAM-Rolle zugeordnet ist, die Sie zur Authentifizierung verwenden. Das temporäre IAM-Sitzungstoken muss URL-codiert sein, wenn es in der JDBC-URL übergeben wird.
Dieser Parameter ist optional.
serverlessAcctId
-
Standardwert – Null
-
Datentyp – Zeichenfolge
Die Konto-ID von Amazon Redshift Serverless. Der Treiber versucht, diesen Parameter vom angegebenen Host zu erkennen. Wenn Sie einen Network Load Balancer (NLB) verwenden, wird der Treiber ihn nicht erkennen, also können Sie ihn hier einstellen.
Dieser Parameter ist optional.
serverlessWorkGroup
-
Standardwert – Null
-
Datentyp – Zeichenfolge
Der Name der Amazon-Redshift-Serverless-Arbeitsgruppe. Der Treiber versucht, diesen Parameter vom angegebenen Host zu erkennen. Wenn Sie einen Network Load Balancer (NLB) verwenden, wird der Treiber ihn nicht erkennen, also können Sie ihn hier einstellen.
Dieser Parameter ist optional.
socketFactory
-
Standardwert – Null
-
Datentyp – Zeichenfolge
Diese Option gibt eine Socket-Factory für die Socket-Erstellung an.
Dieser Parameter ist optional.
socketTimeout
-
Standardwert – 0
-
Datentyp – Ganzzahl
Die Anzahl der Sekunden, die während Sockelleseoperationen gewartet werden soll, bevor eine Zeitüberschreitung eintritt. Wenn eine Operation länger dauert, als durch diesen Schwellenwert angegeben, wird die Verbindung geschlossen. Wenn diese Eigenschaft auf 0 festgelegt ist, treten keine Zeitüberschreitungen für die Verbindung ein.
Dieser Parameter ist optional.
SSL
-
Standardwert – TRUE
-
Datentyp – Zeichenfolge
Verwenden Sie diese Eigenschaft, um SSL für die Verbindung zu aktivieren oder zu deaktivieren.
Dieser Parameter ist optional.
Sie können die folgenden Werte angeben:
- TRUE
-
Der Treiber stellt über SSL eine Verbindung mit dem Server her.
- FALSE
-
Der Treiber stellt ohne SSL eine Verbindung mit dem Server her. Diese Option wird bei der IAM-Authentifizierung nicht unterstützt.
Alternativ können Sie die AuthMech-Eigenschaft konfigurieren.
SSL_Insecure
-
Standardwert – true
-
Datentyp – Zeichenfolge
Diese Eigenschaft gibt an, ob das Serverzertifikat für IDP-Hosts überprüft werden soll.
Dieser Parameter ist optional.
Sie können die folgenden Werte angeben:
- true
-
Der Treiber überprüft die Authentizität des IDP-Serverzertifikats nicht.
- false
-
Der Treiber überprüft die Authentizität des IDP-Serverzertifikats.
SSLCert
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Der vollständige Pfad einer .pem- oder .crt-Datei, die zusätzliche vertrauenswürdige CA-Zertifikate für die Verifizierung der Amazon-Redshift-Server-Instance bei Verwendung von SSL enthält.
Dieser Parameter ist erforderlich, wenn SSLKey festgelegt ist.
SSLFactory
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Die SSL-Factory, die verwendet werden soll, wenn eine Verbindung mit dem Server über TLS/SSL ohne Verwendung eines Serverzertifikats hergestellt wird.
SSLKey
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Der vollständige Pfad der .der-Datei, die die PKCS8-Schlüsseldatei zum Überprüfen der in SSLCert angegebenen Zertifikate enthält.
Dieser Parameter ist erforderlich, wenn SSLCert festgelegt ist.
SSLMode
-
Standardwert – verify-ca
-
Datentyp – Zeichenfolge
Verwenden Sie diese Eigenschaft, um anzugeben, wie der Treiber Zertifikate validiert, wenn TLS/SSL aktiviert ist.
Dieser Parameter ist optional.
Sie können die folgenden Werte angeben:
- verify-ca
-
Der Treiber stellt sicher, dass das Zertifikat von einer vertrauenswürdigen Zertifizierungsstelle (CA) stammt.
- verify-full
-
Der Treiber überprüft, ob das Zertifikat von einer vertrauenswürdigen Zertifizierungsstelle stammt und dass der Hostname im Zertifikat mit dem Hostnamen übereinstimmt, der in der Verbindungs-URL angegeben ist.
SSLPassword
-
Standardwert – 0
-
Datentyp – Zeichenfolge
Das Passwort für die verschlüsselte Schlüsseldatei, die in SSLKey angegeben wurde.
Dieser Parameter ist erforderlich, wenn SSLKey festgelegt ist und die Schlüsseldatei verschlüsselt ist.
SSLRootCert
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Der vollständige Pfad einer .pem- oder .crt-Datei, die das Stamm-CA-Zertifikat für die Verifizierung der Amazon-Redshift-Server-Instance bei Verwendung von SSL enthält.
StsEndpointUrl
-
Standardwert – Null
-
Datentyp – Zeichenfolge
Sie können einen AWS Security Token Service (AWS STS)-Endpunkt angeben. Wenn Sie diese Option angeben, wird die Option „Region“ ignoriert. Sie können nur ein sicheres Protokoll (HTTPS) für diesen Endpunkt angeben.
tcpKeepAlive
-
Standardwert – TRUE
-
Datentyp – Zeichenfolge
Verwenden Sie diese Eigenschaft, um TCP-Keepalives zu aktivieren oder zu deaktivieren.
Dieser Parameter ist optional.
Sie können die folgenden Werte angeben:
- TRUE
-
Der Treiber verwendet TCP-Keepalives, um ein Timeout für Verbindungen zu verhindern.
- FALSE
-
Der Treiber verwendet keine TCP-Keepalives.
Token
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Ein von AWS IAM Identity Center bereitgestelltes Zugriffstoken oder ein OpenID Connect (OIDC) JSON Web Token (JWT), das von einem Web-Identitätsanbieter bereitgestellt wird, der mit AWS IAM Identity Center verknüpft ist. Ihre Anwendung muss dieses Token generieren, indem sie den Benutzer Ihrer Anwendung bei AWS IAM Identity Center oder einem mit dem AWS IAM Identity Center verknüpften Identitätsanbieter authentifiziert.
Dieser Parameter funktioniert mit IdpTokenAuthPlugin.
token_type
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Der Tokentyp, der in IdpTokenAuthPlugin verwendet wird.
Sie können die folgenden Werte angeben:
- ACCESS_TOKEN
-
Geben Sie dies ein, wenn Sie ein von AWS IAM Identity Center bereitgestelltes Zugriffstoken verwenden.
- EXT_JWT
-
Geben Sie dies ein, wenn Sie ein OpenID Connect (OIDC) JSON Web Token (JWT) verwenden, das von einem webbasierten Identitätsanbieter bereitgestellt wird, der in AWS IAM Identity Center integriert ist.
Dieser Parameter funktioniert mit IdpTokenAuthPlugin.
Benutzerkennung (UID)
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Der Datenbankbenutzername, der für den Datenbankzugriff verwendet wird.
Dieser Parameter muss angegeben werden.
Benutzer
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Wenn Sie eine Verbindung mit IAM-Authentifizierung über einen IDP herstellen, ist dies der Benutzername für den idp_host-Server. Bei Verwendung der Standardauthentifizierung kann dies für den Amazon-Redshift-Datenbankbenutzernamen verwendet werden.
Dieser Parameter ist optional.
webIdentityToken
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Das OAuth-2.1-Zugriffstoken oder OpenID-Connect-ID-Token, das vom Identitätsanbieter bereitgestellt wird. Ihre Anwendung muss dieses Token abrufen, indem Sie den Benutzer Ihrer Anwendung bei einem Web-Identitätsanbieter authentifizieren. Stellen Sie sicher, dass Sie diesen Parameter angeben, wenn Sie BasicJwtCredentialsProvider für die Option Plugin_Name angeben.
Dieser Parameter ist erforderlich, wenn Sie BasicJwtCredentialsProvider für die Option Plugin_Name angeben.
