Amazon Redshift unterstützt die Verwendung von Python-UDFs nach dem 30. Juni 2026 nicht mehr. Wir werden damit beginnen, es schrittweise durchzusetzen. Weitere Informationen zu den Details zum Ende der Lebensdauer von Python und zu den Migrationsoptionen finden Sie auf der Blogbeitrag
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Konfigurationsoptionen für die JDBC-Treiberversion 2.x
Im Folgenden finden Sie Beschreibungen der Optionen, die Sie für Version 2.x 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: Wenn die JDBC-URL übergeben wurde, AccessKeyDie ID muss URL-kodiert sein.
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 – Kein
-
Datentyp – Zeichenfolge
Die Okta-provided eindeutige ID, die Ihrer Amazon Redshift-Anwendung zugeordnet ist.
Dieser Parameter ist erforderlich, wenn die Authentifizierung über den Okta-Service erfolgt.
App_Name
-
Standardwert – Kein
-
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 – None
-
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 – Kein
-
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 [...];
DatenbankMetadataCurrentDbOnly
-
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 – None
-
Datentyp – Zeichenfolge
Die Benutzer-ID, die mit Ihrem Amazon-Redshift-Konto verwendet werden soll. Sie können eine ID verwenden, die derzeit nicht existiert, wenn Sie die aktiviert haben AutoCreate Eigentum.
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.
StandardRowFetchSize
-
Standardwert – 0
-
Datentyp – Ganzzahl
Diese Option gibt einen Standardwert für get anFetchSize.
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 Abruf-Iteration von aus der Datenbank abgerufen werden sollen ResultSet.
DisableIsValidQuery
-
Standardwert – False
-
Datentyp – boolesch
Diese Option gibt an, ob der Treiber eine neue Datenbankabfrage sendet, wenn er den Connection.isValid() -Methode, um festzustellen, ob die Datenbankverbindung aktiv ist.
Dieser Parameter ist optional.
- true
-
Der Treiber sendet bei der Verwendung keine Abfrage Connection.isValid(), um festzustellen, 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 Connection.isValid(), um festzustellen, ob die Datenbankverbindung aktiv ist.
ermöglichenFetchRingBuffer
-
Standardwert – true
-
Datentyp – boolesch
Diese Option gibt an, dass der Treiber Zeilen mit einem Ringpuffer in einem separaten Thread abruft. Das AbrufenRingBufferSize Der Parameter gibt die Größe des Ringpuffers an.
Der Ringpuffer implementiert die automatische Speicherverwaltung in JDBC, um OOM-Fehler (Out-of-Memory) bei Datenabrufvorgängen zu verhindern. Der Ringpuffer überwacht die tatsächliche Größe der gepufferten Daten in Echtzeit und stellt so sicher, dass die gesamte Speicherauslastung durch den Treiber innerhalb definierter Grenzen bleibt. Wenn die Pufferkapazität erreicht ist, unterbricht der Treiber den Datenabruf und verhindert so einen Speicherüberlauf, ohne dass ein manuelles Eingreifen erforderlich ist. Dieser integrierte Schutz verhindert OOM-Fehler automatisch, ohne dass der Benutzer eine Konfiguration vornehmen muss.
Wenn eine Transaktion eine Anweisung erkennt, die mehrere durch Semikolons getrennte SQL-Befehle enthält, wird der Abruf-Ringpuffer für diese Transaktion auf False gesetzt. enableFetchRingBufferDer Wert ändert sich nicht.
Dieser Parameter ist optional.
Wenn der Ringpuffer deaktiviert ist und die Abrufgröße nicht richtig konfiguriert ist, können Probleme mit zu wenig Arbeitsspeicher (OOM) auftreten. Weitere Hinweise zur Konfiguration der Abrufgröße finden Sie unter hier.
ermöglichenMultiSqlSupport
-
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.
EnableTableTypes
-
Standardwert – true
-
Datentyp – boolesch
Diese Option gibt an, ob der Treiber detaillierte Tabellentypinformationen aus der Datenquelle in den Ergebnissen von erkennt getTables und getTableTypes DatabaseMetaData Methoden. Standardmäßig erkennt der Treiber detaillierte Tabellentypen.
Dieser Parameter ist optional. Es ist in den Treiberversionen 2.2.8 und höher verfügbar.
- true
-
Der Treiber erkennt die folgenden Tabellentypen: TABLE, VIEW, SYSTEM TABLE, SYSTEM VIEW, EXTERNAL TABLE und LOCAL TEMPORARY.
- false
-
Der Treiber normalisiert die detaillierten Informationen zum Tabellentyp in die generischen TABLE- und VIEW-Tabellentypen.
abrufenRingBufferSize
-
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 in Kleinbuchstaben schreibt (DbGroups), das vom Identitätsanbieter an Amazon Redshift gesendet wird, wenn die Single-Sign-On-Authentifizierung verwendet wird.
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 unterstützt von GetClusterCredentialsV2 API.
Dieser Parameter ist optional.
- true
-
Verwenden Sie Amazon Redshift-Identity-Provider (IDP)-Gruppen.
- false
-
Verwenden Sie die STS-API und GetClusterCredentials für den Benutzerverbund und explizit angeben DbGroups für die Verbindung.
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 ihn verwendet BrowserIdcAuthPlugin.
Dieser Parameter ist optional.
Idc_Region
-
Standardwert – None
-
Datentyp – Zeichenfolge
Das AWS Region, in der sich die IAM Identity Center-Instanz 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
Gibt die Cloud-Partition an, in der Ihr Identitätsanbieter (IdP) konfiguriert ist. Dies bestimmt, mit welchem IdP-Authentifizierungsendpunkt der Treiber eine Verbindung herstellt.
Wenn dieser Parameter leer gelassen wird, verwendet der Treiber standardmäßig die kommerzielle Partition. Die möglichen Werte sind:
us-gov: Verwenden Sie diesen Wert, wenn Ihr IdP in Azure Government konfiguriert ist. Azure AD Government verwendet beispielsweise den Endpunktlogin.microsoftonline.us.cn: Verwenden Sie diesen Wert, wenn Ihr IdP in der chinesischen Cloud-Partition konfiguriert ist. Azure AD China verwendet beispielsweise den Endpunktlogin.chinacloudapi.cn.
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.
Binnenvertrieben_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 – None
-
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 – None
-
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
Zeigt auf die AWS Der Instanzendpunkt des IAM Identity Center-Servers.
Dieser Parameter ist nur erforderlich, wenn eine Authentifizierung mit BrowserIdcAuthPlugin in der Konfigurationsoption plugin_name erfolgt.
Listen_Port
-
Standardwert – 7 890
-
Datentyp – Ganzzahl
Der Port, den der Treiber verwendet, um die SAML-Antwort vom Identitätsanbieter oder den Autorisierungscode zu empfangen, wenn SAML, Azure AD oder AWS Identity Center-Dienste über ein Browser-Plugin.
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.
AnmeldungToRp
-
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 ist der Wert ungültig, sendet der Treiber die protokollierten Informationen an den Standardausgabestrom, System.out.
LogPath
-
Standardwert – Das aktuelle Arbeitsverzeichnis.
-
Datentyp – Zeichenfolge
Der vollständige Pfad zu dem Ordner, in dem der Treiber Protokolldateien speichert, wenn DSILogLevel Die Eigenschaft ist aktiviert.
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 Partner-SPID-Wert (Service Provider ID), der bei der Authentifizierung der Verbindung mit dem verwendet werden soll PingFederate Dienst.
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 mit AWS IAM Identity Center. -
BrowserSamlCredentialsProvider– Browser-SAML für SAML-Services wie Okta, Ping oder ADFS. -
IdpTokenAuthPlugin— Ein Autorisierungs-Plugin, das eine akzeptiert AWS IAM Identity Center-Token oder OpenID Connect (OIDC) JSON-based Identitätstoken (JWT) von jedem Web-Identitätsanbieter, der mit verlinkt ist AWS IAM Identity Center. -
OktaCredentialsProvider– Okta-Service -
PingCredentialsProvider— PingFederate Bedienung.
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.
Bevorzugen Sie PQ
-
Standardwert – true
-
Datentyp – boolesch
Diese Option steuert, ob der Treiber Post-Quantum-Hybrid-Schlüsselaustauschgruppen in TLS 1.3 ankündigt ClientHello. Wenn Post-Quantum-Gruppen angeboten werden und der Server sie auch unterstützt, wählt der Server eine aus. Andernfalls greift der Handshake transparent auf den klassischen Schlüsselaustausch zurück.
Dieser Parameter ist optional. Es ist in den Treiberversionen 2.2.8 und höher verfügbar.
- true
-
Der Treiber kündigt hybride TLS-Schlüsselaustauschgruppen für die Zeit nach der Quantenphase an, sofern dies von der Runtime unterstützt wird.
- false
-
Der Treiber kündigt keine Post-Quantum-Gruppen an. Verwenden Sie diese Einstellung, wenn eine Netzwerk-Middlebox TLS-Handshakes blockiert, weil sie die vom Treiber angebotenen Post-Quantum-Schlüsselaustauschgruppen nicht erkennt.
Preferred_Role
-
Standardwert – Kein
-
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 spezifiziert AWS Region, in der sich der Cluster befindet. Wenn Sie den angeben StsEndPoint Option, die Option Region wird ignoriert. Die Redshift-API-Operation GetClusterCredentials verwendet auch die Option „Region“.
Dieser Parameter ist optional.
awWriteBatchedInserts
-
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.
awWriteBatchedInsertsSize
-
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 angeben BasicJwtCredentialsProvider für den Plugin_Name Option. Sie geben den ARN im folgenden Format an:
arn:partition:service:region:account-id:resource-id
Dieser Parameter ist erforderlich, wenn Sie Folgendes angeben BasicJwtCredentialsProvider für den Plugin_Name Option.
RolleSessionName
-
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 Folgendes angeben BasicJwtCredentialsProvider für den Plugin_Name Option.
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 Folgendes angeben BrowserAzureOAuth2CredentialsProvider für den Plugin_Name Option.
Dieser Parameter ist erforderlich für BrowserAzureOAuth2CredentialsProvider Plug-In.
SecretAccessKey
-
Standardwert – Kein
-
Datentyp – Zeichenfolge
Der IAM-Zugriffsschlüssel für den Benutzer oder die Rolle. Wenn dies angegeben ist, dann AccessKeyDie ID muss ebenfalls angegeben werden. Wenn die JDBC-URL übergeben wurde, SecretAccessKey muss URL-kodiert sein.
Dieser Parameter ist optional.
SessionToken
-
Standardwert – None
-
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.
serverlosAcctId
-
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.
serverlosWorkGroup
-
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 das konfigurieren AuthMech Eigentum.
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 zum Server hergestellt wird TLS/SSL ohne ein Serverzertifikat zu verwenden.
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
-
Vorgabewert — Vollständig verifizieren
-
Datentyp – Zeichenfolge
Verwenden Sie diese Eigenschaft, um anzugeben, wie der Treiber Zertifikate in folgenden Fällen validiert TLS/SSL ist aktiviert.
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.
Wir empfehlen die Verwendung verify-full für SSL-Verbindungen, wann immer möglich.
In den Treiberversionen 2.3.0 und höher ist die Standardeinstellung verify-full. In früheren Versionen war die Standardeinstellung verify-ca. Wenn du nicht einstellst SSLMode und das Serverzertifikat nicht mit dem Hostnamen übereinstimmt, protokolliert der Treiber eine Warnung und stellt eine Verbindung her. Wenn du einstellst SSLModeerzwingt der Treiber den von Ihnen eingestellten Modus.
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 – None
-
Datentyp – Zeichenfolge
Der vollständige Pfad einer .pem- oder .crt-Datei, die das Stamm-CA-Zertifikat für die Verifizierung der Amazon-Redshift-Serverinstanz bei Verwendung von SSL enthält.
StsEndpointUrl
-
Standardwert – Null
-
Datentyp – Zeichenfolge
Sie können eine angeben AWS -Security-Token-Service (AWS STS) Endpunkt. 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 AWS Vom IAM Identity Center bereitgestelltes Zugriffstoken oder ein OpenID Connect (OIDC) JSON Web Token (JWT), das von einem Web-Identitätsanbieter bereitgestellt wird und verknüpft ist mit AWS IAM Identity Center. Ihre Anwendung muss dieses Token generieren, indem sie den Benutzer Ihrer Anwendung authentifiziert mit AWS IAM Identity Center oder ein Identitätsanbieter, der mit verknüpft ist AWS IAM Identity Center.
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 eine verwenden AWS Das IAM Identity Center hat das Zugriffstoken bereitgestellt.
- 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.
NetzIdentityToken
-
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 angeben BasicJwtCredentialsProvider für den Plugin_Name Option.
Dieser Parameter ist erforderlich, wenn Sie Folgendes angeben BasicJwtCredentialsProvider für den Plugin_Name Option.