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.

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.

Ergebnis-Fetcher

Der Standard-Ergebnisabrufer lädt Abfrageergebnisse direkt von Amazon S3 herunter, ohne die Athena-API-Operationen zu durchlaufen. Wenn er Situationen erkennt, in denen ein direkter S3-Download nicht möglich ist, greift er automatisch auf den GetQueryResultsStream API-Vorgang zurück. Dies passiert beispielsweise, wenn Abfrageergebnisse mit der CSE_KMS Option verschlüsselt werden.

Die Verwendung des auto Fetchers wird in den meisten Situationen empfohlen. Wenn Ihre IAM-Richtlinien oder S3-Bucket-Richtlinien jedoch die s3:CalledVia Bedingung verwenden, um den Zugriff auf S3-Objekte auf Anfragen von Athena zu beschränken, versucht der auto Abrufer zunächst, die Ergebnisse von S3 herunterzuladen, und verwendet dann wieder die. GetQueryResultsStream In diesem Fall sollten Sie den Wert auf setzen, um einen zusätzlichen GetQueryResultsStream API-Aufruf zu vermeiden. ResultFetcher

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.

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.

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 EC2 c5.2xlarge-Instance erreichte beispielsweise ein Single-Thread-S3-Client 1 Gbit/s, während S3-Clients mit mehreren Threads einen Netzwerkdurchsatz von 4 Gbit/s erreichten.

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.

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.

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.

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.

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 für C++ .

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).

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.

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.

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 für C++ .

Minimaler Abfragezeitraum

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

Maximaler Abfragezeitraum

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

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.

Max. Abfragedauer

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

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 für Java -Entwicklerhandbuch.

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 für Java .