Erweiterte Optionen

Abrufgröße

Die maximale Anzahl der Ergebnisse (Reihen), die bei dieser Anfrage zurückzugeben sind. Informationen zu Parametern finden Sie unter GetQuery MaxResults. Für die Streaming-API ist der Höchstwert 10 000 000.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
RowsToFetchPerBlock	Optional	1000 für Nicht-Streaming 20000 für Streaming	RowsToFetchPerBlock=20000;

Wiederverwendung von Ergebnissen aktivieren

Gibt an, ob frühere Abfrageergebnisse wiederverwendet werden können, wenn die Abfrage ausgeführt wird. Informationen zu Parametern finden Sie unter ResultReuseByAgeConfiguration.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
EnableResultReuse	Optional	0	EnableResultReuse=1;

Höchstalter für die Wiederverwendung von Ergebnissen

Gibt in Minuten das maximale Alter eines vorherigen Abfrageergebnisses an, das Athena bei der Wiederverwendung berücksichtigen sollte. Informationen zu Parametern finden Sie unter ResultReuseByAgeConfiguration.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
ReusedResultMaxAgeInMinutes	Optional	60	ReusedResultMaxAgeInMinutes=90;

AP-Streaming aktivieren

Wählt aus, ob die Athena-Streaming-API zum Abrufen der Ergebnismenge verwendet werden soll.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
UseResultsetStreaming	Optional	0	UseResultsetStreaming=1;

S3-Fetcher aktivieren

Ruft das von Athena generierte Ergebnis aus dem Amazon-S3-Bucket ab, indem es direkt mit Amazon S3 interagiert.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
EnableS3Fetcher	Optional	1	EnableS3Fetcher=1;

Mehrere S3-Threads verwenden

Ruft Daten mithilfe mehrerer Threads von Amazon S3 ab. Wenn diese Option aktiviert ist, wird die im Amazon-S3-Bucket gespeicherte Ergebnisdatei parallel über mehrere Threads abgerufen.

Aktivieren Sie diese Option nur, wenn Sie über eine gute Netzwerkbandbreite verfügen. In unseren Messungen auf einer c5.2xlarge-Instance in EC2 erreichte beispielsweise ein Single-Thread-S3-Client 1 Gbit/s, während S3-Clients mit mehreren Threads einen Netzwerkdurchsatz von 4 Gbit/s erreichten.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
UseMultipleS3-Threads	Optional	0	UseMultipleS3Threads=1;

Einen einzigen Katalog und ein Schema verwenden

Standardmäßig fragt der ODBC-Treiber Athena ab, um die Liste der verfügbaren Kataloge und Schemas abzurufen. Diese Option zwingt den Treiber, den Katalog und das Schema zu verwenden, welche im Konfigurationsdialogfeld des ODBC-Datenquellenadministrators oder in den Verbindungsparametern angegeben sind.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
UseSingleCatalogAndSchema	Optional	0	UseSingleCatalogAndSchema=1;

Verwenden Sie query, um Tabellen aufzulisten

Ermöglicht es dem ODBC-Treiber bei LAMBDA Katalogtypen, eine SHOW TABLES Abfrage zu senden, um eine Liste verfügbarer Tabellen abzurufen. Dies ist die Standardeinstellung. Wenn dieser Parameter auf 0 gesetzt ist, verwendet der ODBC-Treiber die ListTableMetadataAthena-API, um eine Liste der verfügbaren Tabellen abzurufen. Beachten Sie, dass die Verwendung von LAMBDA Katalogtypen zu ListTableMetadata Leistungseinbußen führt.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
UseQueryToListTables	Optional	1	UseQueryToListTables=1;

Verwenden Sie WCHAR für Zeichenfolgentypen

Standardmäßig verwendet der ODBC-Treiber SQL_CHAR und SQL_VARCHAR für Athena die Zeichenkettendatentypenchar,varchar,string, array map<>struct<>, und. row Wenn Sie diesen Parameter auf setzen, wird der Treiber 1 gezwungen, Zeichenkettendatentypen zu verwendenSQL_WCHAR. SQL_WVARCHAR Die Zeichentypen „Breite Zeichen“ und „Breite Variable“ werden verwendet, um sicherzustellen, dass Zeichen aus verschiedenen Sprachen korrekt gespeichert und abgerufen werden können.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
Verwenden Sie W CharForStringTypes	Optional	0	UseWCharForStringTypes=1;

Externe Kataloge abfragen

Gibt an, ob der Treiber externe Kataloge von Athena abfragen muss. Weitere Informationen finden Sie unter Migrieren Sie zum ODBC 2.x-Treiber.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
QueryExternalCatalogs	Optional	0	QueryExternalCatalogs=1;

SSL verifizieren

Steuert, ob SSL-Zertifikate verifiziert werden sollen, wenn Sie das AWS SDK verwenden. Dieser Wert wird an den ClientConfiguration.verifySSL-Parameter übergeben. Weitere Informationen finden Sie unter AWS -Client-Konfiguration im Entwicklerhandbuch für AWS SDK for C++ .

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
VerifySSL	Optional	1	VerifySSL=0;

Größe des S3-Ergebnisblocks

Gibt die Größe des Blocks in Byte an, der für eine einzelne Amazon S3 GetObjectS3-API-Anfrage heruntergeladen werden soll. Der Standardwert ist 67 108 864 (64 MB). Die zulässigen Mindest- und Höchstwerte sind 10 485 760 (10 MB) und 2 146 435 072 (etwa 2 GB).

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
S3 ResultBlockSize	Optional	67108864	S3ResultBlockSize=268435456;

Länge der Zeichenkettenspalte

Gibt die Spaltenlänge für Spalten mit dem string Datentyp an. Da Athena den Apache Hive-Zeichenkettendatentyp verwendet, für den es keine definierte Genauigkeit gibt, ist die von Athena gemeldete Standardlänge 2147483647 (). INT_MAX Da BI-Tools normalerweise Speicher für Spalten vorab zuweisen, kann dies zu einem hohen Speicherverbrauch führen. Um dies zu vermeiden, begrenzt der Athena ODBC-Treiber die angegebene Genauigkeit für Spalten des string Datentyps und macht den StringColumnLength Verbindungsparameter verfügbar, sodass der Standardwert geändert werden kann.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
StringColumnLength	Optional	255	StringColumnLength=65535;

Spaltenlänge eines komplexen Typs

Gibt die Spaltenlänge für Spalten mit komplexen Datentypen wie mapstruct, und anarray. Zum Beispiel StringColumnLengthmeldet Athena eine Genauigkeit von 0 für Spalten mit komplexen Datentypen. Der Athena ODBC-Treiber legt die Standardgenauigkeit für Spalten mit komplexen Datentypen fest und macht den ComplexTypeColumnLength Verbindungsparameter verfügbar, sodass der Standardwert geändert werden kann.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
ComplexTypeColumnLength	Optional	65535	ComplexTypeColumnLength=123456;

Vertrauenswürdiges CA-Zertifikat

Weist den HTTP-Client an, wo er den Vertrauensspeicher für Ihr SSL-Zertifikat findet. Dieser Wert wird an den ClientConfiguration.caFile-Parameter übergeben. Weitere Informationen finden Sie unter AWS -Client-Konfiguration im Entwicklerhandbuch für AWS SDK for C++ .

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
TrustedCerts	Optional	%INSTALL_PATH%/bin	TrustedCerts=C:\\Program Files\\Amazon Athena ODBC Driver\\bin\\cacert.pem;

Minimaler Abfragezeitraum

Gibt den Mindestwert in Millisekunden an, der gewartet werden muss, bevor Athena den Status der Abfrageausführung abfragt.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
MinQueryExecutionPollingInterval	Optional	100	MinQueryExecutionPollingInterval=200;

Maximaler Abfragezeitraum

Gibt den Höchstwert in Millisekunden an, der gewartet werden muss, bevor Athena den Status der Abfrageausführung abfragt.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
MaxQueryExecutionPollingInterval	Optional	60000	MaxQueryExecutionPollingInterval=1000;

Multiplikator für Abfragen

Gibt den Faktor für die Verlängerung des Abfragezeitraums an. Standardmäßig beginnt die Abfrage mit dem Wert für den minimalen Abfragezeitraum und verdoppelt sich bei jeder Abfrage, bis der Wert für den maximalen Abfragezeitraum erreicht ist.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
QueryExecutionPollingIntervalMultiplier	Optional	2	QueryExecutionPollingIntervalMultiplier=2;

Max. Abfragedauer

Gibt den Höchstwert in Millisekunden an, den ein Treiber bei Athena für den Abfrageausführungsstatus abfragen kann.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
MaxPollDuration	Optional	1800000	MaxPollDuration=1800000;

Verbindungstimeout

Die Zeit (in Millisekunden), die die HTTP-Verbindung wartet, um eine Verbindung herzustellen. Dieser Wert ist für den ClientConfiguration.connectTimeoutMs-Athena-Client festgelegt. Wenn nichts angegeben ist, wird der Standardwert verwendet. Weitere Informationen zu Verbindungsparametern finden Sie unter Client-Konfiguration im AWS SDK for Java -Entwicklerhandbuch.

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
ConnectionTimeout	Optional	0	ConnectionTimeout=2000;

Anforderungs-Timeout

Gibt das Socket-Lese-Timeout für HTTP-Clients an. Dieser Wert ist für den ClientConfiguration.requestTimeoutMs-Parameter des Athena-Clients festgelegt. Weitere Informationen finden Sie unter Client-Konfiguration im Entwicklerhandbuch für AWS SDK for Java .

Name der Verbindungszeichenfolge	Parametertyp	Standardwert	Beispiel für Verbindungszeichenfolgen
RequestTimeout	Optional	10000	RequestTimeout=30000;