Amazon Redshift wird UDFs ab dem 1. November 2025 die Erstellung von neuem Python nicht mehr unterstützen. Wenn Sie Python verwenden möchten UDFs, erstellen Sie das UDFs vor diesem Datum liegende. Bestehendes Python UDFs wird weiterhin wie gewohnt funktionieren. Weitere Informationen finden Sie im Blog-Posting.

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 den Amazon-Redshift-Python-Konnektor

Im Folgenden finden Sie Beschreibungen für die Optionen, die Sie für den Amazon-Redshift-Python-Konnektor angeben können. Die folgenden Optionen gelten für die neueste verfügbare Connector-Version, sofern nicht anders angegeben.

access_key_id

Der Zugriffsschlüssel der IAM-Rolle bzw. des IAM-Benutzers, die/der für die IAM-Datenbankauthentifizierung konfiguriert wurde.

Dieser Parameter ist optional.

allow_db_user_override

Dieser Parameter ist optional.

app_name

Der Name der Identitätsanbieter-Anwendung (IdP), die für die Authentifizierung verwendet wird.

Dieser Parameter ist optional.

application_name

Der Name der Client-Anwendung, die zu Prüfungszwecken an Amazon Redshift übergeben wird. Der von Ihnen angegebene Anwendungsname wird in der Spalte „application_name“ der Tabelle SYS_CONNECTION_LOG angezeigt. Auf diese Weise können Verbindungsquellen beim Debuggen von Problemen nachverfolgt und Fehler behoben werden.

Dieser Parameter ist optional.

auth_profile

Der Name eines Amazon-Redshift-Authentifizierungsprofils mit Verbindungseigenschaften als JSON. Weitere Informationen zur Benennung von Verbindungsparametern finden Sie in der RedshiftProperty-Klasse. DieRedshiftProperty-Klasse speichert vom Endbenutzer bereitgestellte und ggf. während des IAM-Authentifizierungsprozesses generierte Verbindungsparameter (z. B. temporäre IAM-Anmeldeinformationen). Weitere Informationen finden Sie in der RedShiftProperty-Klasse.

Dieser Parameter ist optional.

auto_create

Ein Wert, der angibt, ob der Benutzer erstellt werden soll, wenn der Benutzer nicht existiert.

Dieser Parameter ist optional.

Client-ID

Die Client-ID von Azure IdP.

Dieser Parameter ist optional.

client_secret

Das Client-Geheimnis von Azure IdP.

Dieser Parameter ist optional.

cluster_identifier

Die Cluster-Kennung des Amazon-Redshift-Clusters.

Dieser Parameter ist optional.

credentials_provider

Der IdP, der zur Authentifizierung bei Amazon Redshift verwendet wird. Die folgenden Werte sind gültig:

Dieser Parameter ist optional.

Datenbank

Der Name der Datenbank, mit der Sie sich verbinden möchten.

Dieser Parameter muss angegeben werden.

database_metadata_current_db_only

Ein Wert, der angibt, ob eine Anwendung Datashare-Kataloge mit mehreren Datenbanken unterstützt. Der Standardwert True gibt an, dass die Anwendung aus Gründen der Abwärtskompatibilität keine Datashare-Kataloge mit mehreren Datenbanken unterstützt.

Dieser Parameter ist optional.

db_groups

Eine durch Kommata getrennte Liste bestehender Datenbankgruppennamen, denen der durch DbUser angegebene Benutzer in der aktuellen Sitzung beitritt.

Dieser Parameter ist optional.

db_user

Die Benutzer-ID, die mit Amazon Redshift verwendet werden soll.

Dieser Parameter ist optional.

endpoint_url

Die Amazon-Redshift-Endpunkt-URL Diese Option ist nur für AWS interne Verwendung.

Dieser Parameter ist optional.

group_federation

Diese Option gibt an, ob Amazon-Redshift-IDP-Gruppen verwendet werden sollen.

Dieser Parameter ist optional.

Host

Der Hostname des Amazon-Redshift-Clusters.

Dieser Parameter ist optional.

iam

Die IAM-Authentifizierung ist aktiviert.

Dieser Parameter muss angegeben werden.

iam_disable_cache

Diese Option gibt an, ob die IAM-Anmeldeinformationen zwischengespeichert werden. Die IAM-Anmeldeinformationen werden standardmäßig zwischengespeichert. Dies verbessert die Leistung, wenn Anfragen an das API-Gateway gedrosselt werden.

Dieser Parameter ist optional.

idc_client_display_name

Der Anzeigename, der für den Client verwendet werden soll, der BrowserIdcAuthPlugin verwendet.

Dieser Parameter ist optional.

idc_region

Die AWS-Region, in der sich die Instance von AWS IAM Identity Center befindet.

Dieser Parameter ist nur erforderlich, wenn eine Authentifizierung mit BrowserIdcAuthPlugin in der Konfigurationsoption credentials_provider erfolgt.

idp_partition

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:

Dieser Parameter ist optional.

idpPort

Der Listen Port, an den der IdP die SAML-Assertion sendet.

Dieser Parameter muss angegeben werden.

idp_response_timeout

Das Timeout für das Abrufen der SAML-Assertion vom IdP.

Dieser Parameter muss angegeben werden.

idp_tenant

Der IdP-Tenant.

Dieser Parameter ist optional.

issuer_url

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 credentials_provider erfolgt.

listen_port

Der Port, den der Treiber verwendet, um die SAML-Antwort vom Identitätsanbieter zu empfangen, wenn Services von SAML, Azure AD oder AWS IAM Identity Server über ein Browser-Plugin verwendet werden.

Dieser Parameter ist optional.

login_url

Die Single-Sign-On-URL für den IdP.

Dieser Parameter ist optional.

max_prepared_statements

Die maximale Anzahl vorbereiteter Anweisungen, die pro Verbindung zwischengespeichert werden. Wenn für diesen Parameter 0 festgelegt wird, ist der Cache-Mechanismus deaktiviert. Wenn Sie für diesen Parameter eine negative Zahl eingeben, wird er auf den Standardwert gesetzt.

Dieser Parameter ist optional.

numeric_to_float

Diese Option gibt an, ob der Konnektor numerische Datentypwerte von decimal.Decimal in Float konvertiert. Standardmäßig erhält der Konnektor numerische Datentypwerte als decimal.Decimal und konvertiert sie nicht.

Wir empfehlen nicht, numeric_to_float für Anwendungsfälle zu aktivieren, die Genauigkeit erfordern, da die Ergebnisse ggf. gerundet werden.

Weitere Informationen zu decimal.Decimal und den Kompromissen im Hinblick auf decimal.Decimal und Float finden Sie unter decimal – Dezimale Festpunkt- und Gleitkomma-Arithmetik auf der Python-Website.

Dieser Parameter ist optional.

partner_sp_id

Die Partner-SP-ID, die für die Authentifizierung mit Ping verwendet wird.

Dieser Parameter ist optional.

password

Das Passwort, das für die Authentifizierung verwendet werden soll.

Dieser Parameter ist optional.

port

Die Portnummer für den Amazon-Redshift-Cluster.

Dieser Parameter muss angegeben werden.

preferred_role

Die für die aktuelle Verbindung bevorzugte IAM-Rolle.

Dieser Parameter ist optional.

principal_arn

Der Amazon-Ressourcenname (ARN) des Benutzers oder der IAM-Rolle, für die Sie eine Richtlinie erstellen. Es wird empfohlen, eine Richtlinie an eine Rolle anzufügen und die Rolle Ihrem Benutzer für den Zugriff zuzuweisen.

Dieser Parameter ist optional.

profile

Der Name eines Profils in einer AWS-Datei mit den AWS-Anmeldeinformationen.

Dieser Parameter ist optional.

provider_name

Der Name des Anbieters für die systemeigene Authentifizierung von Redshift.

Dieser Parameter ist optional.

region

Die AWS-Region, in der sich der Cluster befindet.

Dieser Parameter ist optional.

role_arn

Den Amazon-Ressourcennamen (ARN) der Rolle, die der Anrufer übernehmen soll. Dieser Parameter wird von dem Anbieter verwendet, der mit angegeben ist JwtCredentialsProvider.

Für den JwtCredentialsProvider-Anbieter ist dieser Parameter obligatorisch. Andernfalls ist dieser Parameter optional.

role_session_name

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. Dieser Parameter wird von dem Anbieter verwendet, der mit angegeben ist JwtCredentialsProvider.

Dieser Parameter ist optional.

scope

Eine durch Leerzeichen getrennte Liste von Bereichen, denen der Benutzer zustimmen kann. Sie geben diesen Parameter an, damit Ihre 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 credentials_provider angeben.

Dieser Parameter ist für das Plug-in BrowserAzureOAuth2CredentialsProvider erforderlich.

secret_access_key_id

Der geheime Zugriffsschlüssel der IAM-Rolle bzw. des IAM-Benutzers, die/der für die IAM-Datenbankauthentifizierung konfiguriert wurde.

Dieser Parameter ist optional.

session_token

Der Zugriffsschlüssel der IAM-Rolle bzw. des IAM-Benutzers, die/der für die IAM-Datenbankauthentifizierung konfiguriert wurde. Dieser Parameter ist erforderlich, wenn temporäre AWS-Anmeldeinformationen verwendet werden.

Dieser Parameter ist optional.

serverless_acct_id

Die Konto-ID von Amazon Redshift Serverless.

Dieser Parameter ist optional.

serverless_work_group

Der Name der Amazon-Redshift-Serverless-Arbeitsgruppe.

Dieser Parameter ist optional.

ssl

Secure Sockets Layer (SSL) ist aktiviert.

Dieser Parameter muss angegeben werden.

ssl_insecure

Ein Wert, der angibt, ob die Prüfung des Serverzertifikats des IdP-Hosts überprüft werden soll. Wenn Sie diesen Parameter auf „true“ setzen, wird die Überprüfung des Server-SSL-Zertifikats des IdP-Hosts deaktiviert. Wir empfehlen, in Produktionsumgebungen den Standardwert „False“ beizubehalten.

Dieser Parameter ist optional.

sslmode

Die Sicherheit der Verbindung zu Amazon Redshift. Sie können einen der folgenden Werte angeben:

Dieser Parameter muss angegeben werden.

tcp_keepalive

Ob TCP-Keepalives verwendet werden sollen, um ein Timeout für Verbindungen zu verhindern. Sie können die folgenden Werte angeben:

Dieser Parameter ist optional.

tcp_keepalive_count

Die Anzahl der unbestätigten Tests, die gesendet werden sollen, bevor die Verbindung als inaktiv betrachtet wird. Wenn Sie den Wert beispielsweise auf 3 setzen, sendet der Treiber drei unbeantwortete Keepalive-Pakete, bevor er feststellt, dass die Verbindung nicht mehr aktiv ist.

Wenn dieser Parameter nicht angegeben ist, verwendet Amazon Redshift den Standardwert des Systems.

Dieser Parameter ist optional.

tcp_keepalive_interval

Das Intervall in Sekunden zwischen aufeinanderfolgenden Keepalive-Tests, falls der Treiber zuvor keine Bestätigung für den Test erhalten hat. Wenn Sie diesen Parameter angeben, muss es sich um eine positive ganze Zahl handeln.

Wenn dieser Parameter nicht angegeben ist, verwendet Amazon Redshift den Standardwert des Systems.

Dieser Parameter ist optional.

tcp_keepalive_idle

Die Dauer der Inaktivität in Sekunden, nach der der Treiber den ersten Keepalive-Test sendet. Wenn Sie den Wert beispielsweise auf 120 setzen, bedeutet dies, dass der Treiber 2 Minuten lang inaktiv ist, bevor er das erste Keepalive-Paket sendet. Wenn Sie diesen Parameter angeben, muss es sich um eine positive ganze Zahl handeln.

Wenn dieser Parameter nicht angegeben ist, verwendet Amazon Redshift den Standardwert des Systems.

Dieser Parameter ist optional.

timeout

Die Anzahl der Sekunden, die gewartet werden soll, bevor eine Zeitüberschreitung für einen Verbindungsversuch mit dem Server eintritt.

Dieser Parameter ist optional.

Token

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

Der Tokentyp, der in IdpTokenAuthPlugin verwendet wird.

Sie können die folgenden Werte angeben:

Dieser Parameter funktioniert mit IdpTokenAuthPlugin.

user

Der Benutzername für die Autorisierung.

Dieser Parameter ist optional.

web_identity_token

Das OAuth-2.0-Zugriffstoken oder OpenID-Connect-ID-Token, das vom Identitätsanbieter bereitgestellt wird. Stellen Sie sicher, dass Ihre Anwendung dieses Token abruft, indem Sie den Benutzer Ihrer Anwendung bei einem Web-Identitätsanbieter authentifizieren. Dieser Parameter wird von dem Anbieter verwendet, der mit JwtCredentialsProvider angegeben ist.

Für den JwtCredentialsProvider-Anbieter ist dieser Parameter obligatorisch. Andernfalls ist dieser Parameter optional.