Opzioni avanzate

Dimensioni di recupero

Numero massimo di risultati (righe) da restituire in questa richiesta. Per informazioni sui parametri, vedere GetQuery MaxResults. Per l'API di streaming, il valore massimo è pari a 10000000.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
RowsToFetchPerBlock	Facoltativo	1000 per il non streaming 20000 per lo streaming	RowsToFetchPerBlock=20000;

Come abilitare il riutilizzo dei risultati

Specifica se i risultati della query precedente possono essere riutilizzati quando la query viene eseguita. Per informazioni sui parametri, vedere ResultReuseByAgeConfiguration.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
EnableResultReuse	Facoltativo	0	EnableResultReuse=1;

Età massima per il riutilizzo di risultati

Specifica, in minuti, l'età massima dei risultati di una query precedente che Athena debba considerare per il riutilizzo. Per informazioni sui parametri, vedere ResultReuseByAgeConfiguration.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
ReusedResultMaxAgeInMinutes	Facoltativo	60	ReusedResultMaxAgeInMinutes=90;

Come abilitare l'API di streaming

Sceglie se utilizzare l'API di streaming Athena per recuperare il set di risultati.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
UseResultsetStreaming	Facoltativo	0	UseResultsetStreaming=1;

Come abilitare il fetcher S3

Recupera il set di risultati generato da Athena dal bucket Amazon S3 interagendo direttamente con Amazon S3.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
EnableS3Fetcher	Facoltativo	1	EnableS3Fetcher=1;

Utilizzo di più thread S3

Recupera i dati da Amazon S3 utilizzando più thread. Quando questa opzione è abilitata, il file di risultati archiviato nel bucket Amazon S3 viene recuperato in parallelo utilizzando più thread.

Abilita questa opzione solo se disponi di una buona larghezza di banda della rete. Ad esempio, nelle nostre misurazioni su un'istanza EC2 c5.2xlarge, un client S3 a thread singolo ha raggiunto 1 Gbps, mentre i client S3 a thread multiplo hanno raggiunto 4 Gbps di velocità di trasmissione effettiva di rete.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
UseMultipleThread S3	Facoltativo	0	UseMultipleS3Threads=1;

Utilizzo di schema e catalogo singolo

Per impostazione predefinita, il driver ODBC esegue query su Athena per ottenere l'elenco dei cataloghi e degli schemi disponibili. Questa opzione prevede che il driver utilizzi il catalogo e lo schema specificati dalla finestra di dialogo di configurazione di ODBC Data Source Administrator o dai parametri di connessione.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
UseSingleCatalogAndSchema	Facoltativo	0	UseSingleCatalogAndSchema=1;

Usa la query per elencare le tabelle

Per i tipi di LAMBDA catalogo, consente al driver ODBC di inviare una SHOW TABLES query per ottenere un elenco di tabelle disponibili. Questa è l'impostazione di default. Se questo parametro è impostato su 0, il driver ODBC utilizza l'API ListTableMetadataAthena per ottenere un elenco di tabelle disponibili. Tieni presente che, per i tipi di LAMBDA catalogo, l'utilizzo ListTableMetadata porta alla regressione delle prestazioni.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
UseQueryToListTables	Facoltativo	1	UseQueryToListTables=1;

Usa WCHAR per i tipi di stringhe

Per impostazione predefinita, il driver ODBC utilizza SQL_CHAR e SQL_VARCHAR per Athena i char tipi di dati stringavarchar,,string, array map<>struct<>, e. row L'impostazione di questo parametro per 1 forzare l'utilizzo da parte del driver SQL_WCHAR e SQL_WVARCHAR per i tipi di dati a stringa. I tipi di caratteri wide e wide variable vengono utilizzati per garantire che i caratteri di diverse lingue possano essere memorizzati e recuperati correttamente.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
Usa W CharForStringTypes	Facoltativo	0	UseWCharForStringTypes=1;

Esecuzione di query su cataloghi esterni

Specifica se il driver deve eseguire query sui cataloghi esterni ad Athena. Per ulteriori informazioni, consulta Migrazione al driver ODBC 2.x.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
QueryExternalCatalogs	Facoltativo	0	QueryExternalCatalogs=1;

Verifica di SSL

Controlla se verificare i certificati SSL quando utilizzi l' AWS SDK. Questo valore viene passato al parametro ClientConfiguration.verifySSL. Per ulteriori informazioni, consulta Configurazione client AWS nella Guida per gli sviluppatori di AWS SDK for C++ .

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
VerifySSL	Facoltativo	1	VerifySSL=0;

Dimensione del blocco dei risultati S3

Speciifica, in byte, la dimensione del blocco da scaricare per una singola richiesta API Amazon GetObjectS3. Il valore predefinito è pari a 67108864 (64 MB). I valori minimo e massimo consentiti sono 10485760 (10 MB) e 2146435072 (circa 2 GB).

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
S3 ResultBlockSize	Facoltativo	67108864	S3ResultBlockSize=268435456;

Lunghezza della colonna di stringhe

Speciifica la lunghezza delle colonne con il tipo di string dati. Poiché Athena utilizza il tipo di dati stringa Apache Hive, che non ha una precisione definita, la lunghezza predefinita riportata da Athena è 2147483647 (). INT_MAX Poiché gli strumenti di BI di solito preallocano la memoria per le colonne, ciò può comportare un elevato consumo di memoria. Per evitare ciò, il driver ODBC Athena limita la precisione riportata per le colonne del tipo di string dati ed espone il parametro di StringColumnLength connessione in modo che il valore predefinito possa essere modificato.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
StringColumnLength	Facoltativo	255	StringColumnLength=65535;

Lunghezza delle colonne di tipo complesso

Speciifica la lunghezza delle colonne con tipi di dati complessi come mapstruct, earray. Ad esempio StringColumnLength, Athena riporta una precisione pari a 0 per le colonne con tipi di dati complessi. Il driver ODBC Athena imposta la precisione predefinita per le colonne con tipi di dati complessi ed espone il parametro di ComplexTypeColumnLength connessione in modo che il valore predefinito possa essere modificato.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
ComplexTypeColumnLength	Facoltativo	65535	ComplexTypeColumnLength=123456;

Certificato CA attendibile

Indica al client HTTP dove trovare l'archivio attendibile con i certificati SSL. Questo valore viene passato al parametro ClientConfiguration.caFile. Per ulteriori informazioni, consulta Configurazione client AWS nella Guida per gli sviluppatori di AWS SDK for C++ .

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
TrustedCerts	Facoltativo	%INSTALL_PATH%/bin	TrustedCerts=C:\\Program Files\\Amazon Athena ODBC Driver\\bin\\cacert.pem;

Periodo minimo del polling

Specifica in millisecondi il valore minimo di attesa prima di eseguire il polling di Athena per verificare lo stato di esecuzione della query.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
MinQueryExecutionPollingInterval	Facoltativo	100	MinQueryExecutionPollingInterval=200;

Periodo massimo del polling

Specifica in millisecondi il valore massimo di attesa prima di eseguire il polling di Athena per verificare lo stato di esecuzione della query.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
MaxQueryExecutionPollingInterval	Facoltativo	60000	MaxQueryExecutionPollingInterval=1000;

Moltiplicatore polling

Specifica il fattore di incremento del periodo del polling. Per impostazione predefinita, il polling inizia con il valore del periodo minimo del polling e raddoppia con ogni polling fino a raggiungere il valore del periodo massimo di polling.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
QueryExecutionPollingIntervalMultiplier	Facoltativo	2	QueryExecutionPollingIntervalMultiplier=2;

Durata massima del polling

Specifica il valore massimo in millisecondi entro cui un driver può eseguire il polling su Athena per verificare lo stato di esecuzione delle query.

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
MaxPollDuration	Facoltativo	1800000	MaxPollDuration=1800000;

Timeout di connessione

La quantità di tempo (in millisecondi) di attesa prima che venga stabilita una connessione HTTP. Questo valore è impostato per il client Athena ClientConfiguration.connectTimeoutMs. Se non è specificato, viene utilizzato il valore predefinito curl. Per informazioni sui parametri di connessione, consulta Configurazione client nella Guida per gli sviluppatori di AWS SDK for Java .

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
ConnectionTimeout	Facoltativo	0	ConnectionTimeout=2000;

Timeout richiesta

Specifica il timeout di lettura dei socket per i client HTTP. Questo valore è impostato per il parametro ClientConfiguration.requestTimeoutMs del client Athena. Per informazioni, consulta Configurazione client nella Guida per gli sviluppatori di AWS SDK for Java .

Nome stringa connessione	Tipo parametro	Valore predefinito	Esempio stringa connessione
RequestTimeout	Facoltativo	10000	RequestTimeout=30000;