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 AWS KMS Schlüssel muss angegeben werden, wenn SSE_KMS oder EncryptionOption istCSE_KMS.

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

Verschlüsselungsoption

Die Art der Verschlüsselung, die für Abfrageergebnisse verwendet werden soll, wenn sie in Amazon S3 gespeichert werden. Informationen zur Verschlüsselung von Abfrageergebnissen finden Sie EncryptionConfigurationin der Amazon Athena API-Referenz.

Parametername	Alias	Parametertyp	Standardwert	Mögliche Werte
EncryptionOption	S3 OutputEncOption (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 EncryptionConfigurationin der Amazon Athena API-Referenz.

Parametername	Alias	Parametertyp	Standardwert
KmsKey	S3 OutputEnc KMSKey (veraltet)	Optional	Keine

Parameter zum Abrufen von Ergebnissen

Ergebnis-Fetcher

Der Fetcher, der zum Herunterladen von Abfrageergebnissen verwendet wird.

Der standardmäßige Ergebnis-Fetcher, S3, lädt Abfrageergebnisse direkt von Amazon S3 herunter, ohne die Athena-APIs zu verwenden. Dies ist in den meisten Fällen die schnellste Option. Diese Option ist nicht verfügbar, wenn Ihre Abfrageergebnisse mit CSE_KMS verschlüsselt sind oder wenn die Richtlinie, die dem Benutzer den Zugriff auf Abfrageergebnisse ermöglicht, nur Anrufe von Athena mit s3:CalledVia erlaubt.

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

Anmerkung

Im JDBC 2.x-Treiber konfiguriert die UseResultsetStreaming = 1 Einstellung den Treiber so, dass er die Result Set-Streaming-API verwendet. Im JDBC 3.x-Treiber lautet die entsprechende Einstellung. ResultFetcher=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.

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 zur maximalen Wiederverwendung von Ergebnissen 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

LakeFormation Endpunkt überschreiben

Der Endpunkt, den der Treiber für den Lake Formation Formation-Dienst 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	None	Optional	Keine

Überschreibung von STS-Endpunkten

Der Endpunkt, den der Treiber für den AWS STS Dienst 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 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
StsEndpoint	StsEndpointOverride(veraltet)	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