Erweiterte Verbindungsparameter - Amazon Athena
ErgebnisverschlüsselungsparameterParameter zum Abrufen von ErgebnissenKonfigurationsparameter für das ErgebnisParameter für die Wiederverwendung von AbfrageergebnissenAbfrageparameter für die AbfrageausführungParameter für EndpunktüberschreibungProxy-KonfigurationsparameterProtokollieren von ParameternAnwendungsnameVerbindungstestAnzahl der WiederholungenNetzwerk-Timeout

Erweiterte Verbindungsparameter

In den folgenden Abschnitten werden die erweiterten Verbindungsparameter für den JDBC-3.x-Treiber beschrieben.

Ergebnisverschlüsselungsparameter

Beachten Sie folgende Punkte:

  • Der Schlüssel AWS KMS muss angegeben werden, wenn EncryptionOption SSE_KMS oder CSE_KMS ist.

  • Der Schlüssel AWS KMS kann nicht angegeben werden, wenn EncryptionOption nicht angegeben oder wenn EncryptionOption SSE_S3 ist.

Verschlüsselungsoption

Die Art der Verschlüsselung, die für Abfrageergebnisse verwendet werden soll, wenn sie in Amazon S3 gespeichert werden. Weitere Informationen zur Abfrageergebnisverschlüsselung finden Sie unter EncryptionConfiguration in der API-Referenz zu Amazon Athena.

Parametername Alias Parametertyp Standardwert Mögliche Werte
EncryptionOption S3OutputEncOption (veraltet) Optional Keine SSE_S3, SSE_KMS, CSE_KMS

KMS-Schlüssel

Der KMS-Schlüssel-ARN oder die -ID, falls SSE_KMS oder CSE_KMS, wird als Verschlüsselungsoption ausgewählt. Weitere Informationen finden Sie unter EncryptionConfiguration in der API-Referenz zu Amazon Athena.

Parametername Alias Parametertyp Standardwert
KmsKey S3OutputEncKMSKey (veraltet) Optional Keine

Parameter zum Abrufen von Ergebnissen

Ergebnis-Fetcher

Der Fetcher, der zum Herunterladen von Abfrageergebnissen verwendet wird.

Der standardmäßige Ergebnis-Fetcher, auto, lädt Abfrageergebnisse direkt von Amazon S3 herunter, ohne die Athena-APIs zu verwenden. Wenn ein direkter S3-Download nicht möglich ist, z. B. wenn Abfrageergebnisse mit der CSE_KMS-Option verschlüsselt werden, wird automatisch auf die Verwendung der GetQueryResultsStream-API zurückgegriffen.

Die Verwendung des auto-Fetchers wird in den meisten Situationen empfohlen. Wenn Ihre IAM-Richtlinien oder S3-Bucket-Richtlinien die Bedingung s3:CalledVia verwenden, um den Zugriff auf S3-Objektanforderungen von Athena zu beschränken, versucht der auto-Fetcher zunächst, die Ergebnisse von S3 herunterzuladen, und greift dann auf die GetQueryResultsStream-API zurück. In diesem Fall können Sie den ResultFetcher auf GetQueryResultsStream einstellen, um einen zusätzlichen API-Aufruf zu vermeiden.

Parametername Alias Parametertyp Standardwert Mögliche Werte
ResultFetcher Keine Optional auto auto, S3, GetQueryResults, GetQueryResultsStream

Abrufgröße

Der Wert dieses Parameters wird als Minimum für interne Puffer und als Zielseitengröße beim Abrufen von Ergebnissen verwendet. Der Wert 0 (Null) bedeutet, dass der Treiber seine Standardwerte wie unten beschrieben verwenden soll. Der maximale Wert beträgt 1 000 000.

Parametername Alias Parametertyp Standardwert
FetchSize RowsToFetchPerBlock (veraltet) Optional 0

  • Der GetQueryResults-Fetcher verwendet immer eine Seitengröße von 1 000. Dies ist der maximale Wert, der vom API-Aufruf unterstützt wird. Wenn die Abrufgröße höher als 1 000 ist, werden mehrere aufeinanderfolgende API-Aufrufe ausgeführt, um den Puffer über dem Mindestwert zu füllen.

  • Der GetQueryResultsStream-Fetcher verwendet die konfigurierte Abrufgröße als Seitengröße oder standardmäßig 10 000.

  • Der S3-Fetcher verwendet die konfigurierte Abrufgröße als Seitengröße oder standardmäßig 10 000.

Konfigurationsparameter für das Ergebnis

Erwarteter Bucket-Eigentümer

Die Konto-ID des erwarteten S3-Bucket-Eigentümers. Wenn die von Ihnen angegebene Konto-ID nicht mit dem tatsächlichen Besitzer des Buckets übereinstimmt, schlägt die Anfrage fehl. Weitere Informationen zur Überprüfung des Besitzers eines S3-Buckets finden Sie unter Überprüfen der Bucket-Eigentümerschaft..

Parametername Alias Parametertyp Standardwert
ErwarteterBucketBesitzer Keine Optional Keine

Acl-Option

Zeigt an, dass eine in Amazon S3 gespeicherte ACL eingerichtet werden sollte, um den Besitz der gespeicherten Abfrageergebnisse zu kontrollieren. Weitere Informationen zu AclOption finden Sie unter AclConfiguration.

Parametername Alias Parametertyp Standardwert Mögliche Werte
AclOption Keine Optional Keine BUCKET_OWNER_FULL_CONTROL

Parameter für die Wiederverwendung von Abfrageergebnissen

Wiederverwendung von Ergebnissen aktivieren

Gibt an, ob frühere Ergebnisse für dieselbe Abfrage wiederverwendet werden können, wenn eine Abfrage ausgeführt wird. Hinweise zur Wiederverwendung von Abfrageergebnissen finden Sie unter ResultReuseByAgeConfiguration.

Parametername Alias Parametertyp Standardwert
EnableResultReuseByAge Keine Optional FALSE

Höchstalter für die Wiederverwendung von Ergebnissen

Das maximale Alter eines früheren Abfrageergebnisses in Minuten, das Athena für die Wiederverwendung berücksichtigen soll. Hinweise zum Höchstalter bei der Wiederverwendung von Abfrageergebnissen finden Sie unter ResultReuseByAgeConfiguration.

Parametername Alias Parametertyp Standardwert
MaxResultReuseAgeInMinutes Keine Optional 60

Abfrageparameter für die Abfrageausführung

Minimales Abfrageintervall für die Ausführung von Abfragen

Die minimale Zeit in Millisekunden, die gewartet werden muss, bevor Athena nach dem Status der Abfrageausführung gefragt wird.

Parametername Alias Parametertyp Standardwert
MinQueryExecutionPollingIntervalMillis MinQueryExecutionPollingInterval (veraltet) Optional 100

Maximales Abfrageintervall für die Ausführung von Abfragen

Die maximale Zeit in Millisekunden, die gewartet werden muss, bevor Athena nach dem Status der Abfrageausführung gefragt wird.

Parametername Alias Parametertyp Standardwert
MaxQueryExecutionPollingIntervalMillis MaxQueryExecutionPollingInterval (veraltet) Optional 5000

Multiplikator für das Abfrageintervall bei der Ausführung von Abfragen

Der Faktor für die Verlängerung des Abfragezeitraums. Standardmäßig beginnt die Abfrage mit dem Wert für MinQueryExecutionPollingIntervalMillis und verdoppelt sich bei jeder Abfrage, bis der Wert für MaxQueryExecutionPollingIntervalMillis erreicht ist.

Parametername Alias Parametertyp Standardwert
QueryExecutionPollingIntervalMultiplier Keine Optional 2

Parameter für Endpunktüberschreibung

Athena-Endpunktüberschreibung

Der Endpunkt, den der Treiber für API-Aufrufe an Athena verwendet.

Beachten Sie folgende Punkte:

  • Wenn die Protokolle https:// oder http:// in der angegebenen URL nicht angegeben sind, fügt der Treiber das Präfix https:// ein.

  • Wenn dieser Parameter nicht angegeben ist, verwendet der Treiber einen Standardendpunkt.

Parametername Alias Parametertyp Standardwert
AthenaEndpoint EndpointOverride (veraltet) Optional Keine

Athena-Streaming-Service-Endpunktüberschreibung

Der Endpunkt, den der Treiber zum Herunterladen von Abfrageergebnissen verwendet, wenn er den Athene-Streaming-Service verwendet. Der Athena-Streaming-Service ist über Port 444 verfügbar.

Beachten Sie folgende Punkte:

  • Wenn die Protokolle https:// oder http:// in der angegebenen URL nicht angegeben sind, fügt der Treiber das Präfix https:// ein.

  • Wenn in der angegebenen URL kein Port angegeben ist, fügt der Treiber den Streaming-Service-Port 444 ein.

  • Wenn der AthenaStreamingEndpoint-Parameter nicht angegeben ist, verwendet der Treiber die AthenaEndpoint-Überschreibung. Wenn weder die Überschreibung AthenaStreamingEndpoint noch AthenaEndpoint angegeben sind, verwendet der Treiber einen Standard-Streaming-Endpunkt.

Parametername Alias Parametertyp Standardwert
AthenaStreamingEndpoint StreamingEndpointOverride (veraltet) Optional Keine

Überschreiben von Endpunkten in Lake Formation

Der Endpunkt, den der Treiber für den Lake-Formation-Service verwendet, wenn er die AWS Lake Formation-AssumeDecoratedRoleWithSAML-API zum Abrufen temporärer Anmeldeinformationen verwendet. Wenn dieser Parameter nicht angegeben ist, verwendet der Treiber einen Lake-Formation-Standardendpunkt.

Beachten Sie folgende Punkte:

  • Wenn die Protokolle https:// oder http:// in der angegebenen URL nicht angegeben sind, fügt der Treiber das Präfix https:// ein.

Parametername Alias Parametertyp Standardwert
LakeFormationEndpoint

LfEndpointOverride (veraltet)

 Optional Keine

Überschreibung von S3-Endpunkten

Der Endpunkt, den der Treiber zum Herunterladen von Abfrageergebnissen verwendet, wenn er den Amazon-S3-Fetcher verwendet. Wenn dieser Parameter nicht angegeben ist, verwendet der Treiber einen standardmäßigen Amazon-S3-Endpunkt.

Beachten Sie folgende Punkte:

  • Wenn die Protokolle https:// oder http:// in der angegebenen URL nicht angegeben sind, fügt der Treiber das Präfix https:// ein.

Parametername Alias Parametertyp Standardwert
S3Endpoint Keine Optional Keine

Überschreibung von STS-Endpunkten

Der Endpunkt, den der Treiber für den AWS STS-Service verwendet, wenn er die AWS STS-AssumeRoleWithSAML-API zum Abrufen temporärer Anmeldeinformationen verwendet. Wenn dieser Parameter nicht angegeben ist, verwendet der Treiber einen AWS STS-Endpunkt.

Beachten Sie folgende Punkte:

  • Wenn die Protokolle https:// oder http:// in der angegebenen URL nicht angegeben sind, fügt der Treiber das Präfix https:// ein.

Parametername Alias Parametertyp Standardwert
StsEndpoint StsEndpointOverride (veraltet) Optional Keine

Überschreibung von SSO-OIDC-Endpunkten

Der Endpunkt, den der Treiber verwendet wenn er ClientConfiguration.endpointOverride verwendet, um den Standard-HTTP-Endpunkt für den SSO-OIDC-Client zu überschreiben. Weitere Informationen finden Sie unter ClientConfiguration.

Parametername Alias Parametertyp Standardwert
SSOOIDCEndpointOverride Optional Keine

Überschreibung von SSO-Admin-Endpunkten

Der Endpunkt, den der Treiber verwendet wenn er ClientConfiguration.endpointOverride verwendet, um den Standard-HTTP-Endpunkt für den SSO-Admin-Client zu überschreiben. Weitere Informationen finden Sie unter ClientConfiguration.

Parametername Alias Parametertyp Standardwert
SSOAdminEndpointOverride Optional Keine

Proxy-Konfigurationsparameter

Proxy-Host

Die URL des Proxy-Hosts. Verwenden Sie diesen Parameter, wenn Athena-Anfragen über einen Proxy laufen sollen.

Anmerkung

Stellen Sie sicher, dass Sie das Protokoll https:// oder http:// am Anfang der URL für ProxyHost angeben.

Parametername Alias Parametertyp Standardwert
ProxyHost Keine Optional Keine

Proxy-Port

Der Port, der auf dem Proxy-Host verwendet werden soll. Verwenden Sie diesen Parameter, wenn Athena-Anfragen über einen Proxy laufen sollen.

Parametername Alias Parametertyp Standardwert
ProxyPort Keine Optional Keine

Proxy-Benutzername

Der Benutzername für die Authentifizierung mit dem Proxy-Server. Verwenden Sie diesen Parameter, wenn Athena-Anfragen über einen Proxy laufen sollen.

Parametername Alias Parametertyp Standardwert
ProxyUsername ProxyUID (veraltet) Optional Keine

Proxy-Passwort

Das Passwort für die Authentifizierung mit dem Proxy-Server. Verwenden Sie diesen Parameter, wenn Athena-Anfragen über einen Proxy laufen sollen.

Parametername Alias Parametertyp Standardwert
ProxyPassword ProxyPWD (veraltet) Optional Keine

Hosts ohne Proxy

Eine Gruppe von Hostnamen, zu denen der Treiber eine Verbindung herstellt, ohne einen Proxy zu verwenden, wenn die Proxyfunktion aktiviert ist (d. h. wenn die Verbindungsparameter ProxyHost und ProxyPort festgelegt sind). Die Hosts sollten durch das Pipe-Zeichen (|) getrennt werden (z. B. host1.com|host2.com).

Parametername Alias Parametertyp Standardwert
ProxyExemptHosts NonProxyHosts Optional Keine

Proxy für Identitätsanbieter aktiviert

Gibt an, ob ein Proxy verwendet werden soll, wenn der Treiber eine Verbindung zu einem Identitätsanbieter herstellt.

Parametername Alias Parametertyp Standardwert
ProxyEnabledForIdP UseProxyForIdP Optional FALSE

Protokollieren von Parametern

In diesem Abschnitt werden Parameter im Zusammenhang mit der Protokollierung beschrieben.

Protokollebene

Gibt die Ebene für die Treiberprotokollierung an. Es wird nichts protokolliert, es sei denn, der Parameter LogPath ist ebenfalls festgelegt.

Anmerkung

Wir empfehlen, nur den Parameter LogPath festzulegen, sofern Sie keine besonderen Anforderungen haben. Wenn Sie nur den Parameter LogPath festlegen, wird die Protokollierung aktiviert und die TRACE-Standardprotokollebene verwendet. Die Protokollebene TRACE bietet die detaillierteste Protokollierung.

Parametername Alias Parametertyp Standardwert Mögliche Werte
LogLevel Keine Optional TRACE OFF, ERROR, WARN, INFO, DEBUG, TRACE

Protokollpfad

Der Pfad zu einem Verzeichnis auf dem Computer, auf dem der Treiber ausgeführt wird, in dem Treiberprotokolle gespeichert werden. Eine Protokolldatei mit einem eindeutigen Namen wird im angegebenen Verzeichnis erstellt. Wenn diese Option festgelegt ist, wird die Treiberprotokollierung aktiviert.

Parametername Alias Parametertyp Standardwert
LogPath Keine Optional Keine

Anwendungsname

Der Name der Anwendung, die den Treiber verwendet. Wenn ein Wert für diesen Parameter angegeben wird, ist der Wert in der User-Agent-Zeichenfolge der API-Aufrufe enthalten, die der Treiber an Athena sendet.

Anmerkung

Sie können den Namen der Anwendung auch festlegen, indem Sie setApplicationName im Objekt DataSource aufrufen.

Parametername Alias Parametertyp Standardwert
ApplicationName Keine Optional Keine

Verbindungstest

Wenn auf TRUE festgelegt, führt der Treiber jedes Mal, wenn eine JDBC-Verbindung hergestellt wird, einen Verbindungstest durch, auch wenn keine Abfrage für die Verbindung ausgeführt wird.

Parametername Alias Parametertyp Standardwert
ConnectionTest Keine Optional TRUE
Anmerkung

Ein Verbindungstest sendet eine SELECT 1-Anfrage an Athena, um zu überprüfen, ob die Verbindung korrekt konfiguriert wurde. Das bedeutet, dass zwei Dateien (der Ergebnissatz und die Metadaten) in Amazon S3 gespeichert werden und zusätzliche Gebühren gemäß der Amazon-Athena-Preisrichtlinie anfallen können.

Anzahl der Wiederholungen

Gibt an, wie oft der Treiber maximal eine wiederholbare Anforderung an Athena senden sollte.

Parametername Alias Parametertyp Standardwert
NumRetries MaxErrorRetry (veraltet) Optional Keine

Netzwerk-Timeout

Das Netzwerk-Timeout steuert, wie lange der Treiber auf den Aufbau einer Netzwerkverbindung wartet. Dies beinhaltet die Zeit, die zum Senden von API-Anfragen benötigt wird. In seltenen Fällen kann es nützlich sein, das Netzwerk-Timeout zu ändern. Beispielsweise können Sie den Timeout für lange Garbage-Collection-Pausen erhöhen. Das Setzen dieses Verbindungsparameters entspricht der Verwendung der setNetworkTimeout-Methode für ein Connection-Objekt.

Parametername Alias Parametertyp Standardwert

NetworkTimeoutMillis

 Keine Optional Keine