Options avancées

Taille d'extraction

Nombre maximal de résultats (lignes) à renvoyer dans cette demande. Pour plus d'informations sur les paramètres, consultez GetQuery MaxResults. Pour l'API de streaming, la valeur maximale est 10000000.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
RowsToFetchPerBlock	Facultatif	1000 pour les applications autres que le streaming 20000 pour le streaming	RowsToFetchPerBlock=20000;

Activer la réutilisation des résultats

Spécifie si les résultats de requête précédents peuvent être réutilisés lors de l'exécution de la requête. Pour plus d'informations sur les paramètres, consultez ResultReuseByAgeConfiguration.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
EnableResultReuse	Facultatif	0	EnableResultReuse=1;

Âge maximum de réutilisation des résultats

Spécifie, en minutes, l'âge maximum d'un résultat de requête précédent qu'Athena doit envisager de réutiliser. Pour plus d'informations sur les paramètres, consultez ResultReuseByAgeConfiguration.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
ReusedResultMaxAgeInMinutes	Facultatif	60	ReusedResultMaxAgeInMinutes=90;

Activer l'API de streaming

Détermine s'il faut utiliser l'API de streaming Athena pour extraire le jeu de résultats.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
UseResultsetStreaming	Facultatif	0	UseResultsetStreaming=1;

Activer le récupérateur S3

Récupère l'ensemble de résultats généré par Athena depuis le compartiment Amazon S3 en interagissant directement avec Amazon S3.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
EnableS3Fetcher	Facultatif	1	EnableS3Fetcher=1;

Utiliser plusieurs threads S3

Récupère les données depuis Amazon S3 à l'aide de plusieurs threads. Lorsque cette option est activée, le fichier de résultat stocké dans le compartiment Amazon S3 est extrait en parallèle à l'aide de plusieurs threads.

Activez cette option uniquement si vous disposez d'une bonne bande passante réseau. Par exemple, lors de nos mesures sur une instance EC2 c5.2xlarge, un client S3 à thread unique a atteint 1 Gbit/s, tandis que les clients S3 à plusieurs threads ont atteint 4 Gbit/s de débit réseau.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
UseMultipleFils S3	Facultatif	0	UseMultipleS3Threads=1;

Utiliser un catalogue et un schéma uniques

Par défaut, le pilote ODBC interroge Athena pour obtenir la liste des catalogues et schémas disponibles. Cette option oblige le pilote à utiliser le catalogue et le schéma spécifiés par la boîte de dialogue de configuration de l'administrateur de sources de données ODBC ou par les paramètres de connexion.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
UseSingleCatalogAndSchema	Facultatif	0	UseSingleCatalogAndSchema=1;

Utiliser la requête pour répertorier les tables

Pour les types de LAMBDA catalogue, permet au pilote ODBC de soumettre une SHOW TABLES requête pour obtenir la liste des tables disponibles. Il s'agit de la valeur par défaut. Si ce paramètre est défini sur 0, le pilote ODBC utilise l'API ListTableMetadataAthena pour obtenir la liste des tables disponibles. Notez que, pour les types de LAMBDA catalogue, l'utilisation ListTableMetadata entraîne une régression des performances.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
UseQueryToListTables	Facultatif	1	UseQueryToListTables=1;

Utiliser WCHAR pour les types de chaînes

Par défaut, le pilote ODBC utilise SQL_CHAR et SQL_VARCHAR pour Athena les char types de données de chaînevarchar,,,string, array map<>struct<>, et. row La définition de ce paramètre 1 force le pilote à utiliser SQL_WCHAR et SQL_WVARCHAR pour les types de données de chaîne. Les types de caractères larges et de caractères variables larges sont utilisés pour garantir que les caractères de différentes langues peuvent être stockés et récupérés correctement.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
Utiliser W CharForStringTypes	Facultatif	0	UseWCharForStringTypes=1;

Interroger des catalogues externes

Spécifie si le pilote doit interroger des catalogues externes à partir d'Athena. Pour plus d’informations, consultez Migrer vers le ODBC pilote 2.x.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
QueryExternalCatalogs	Facultatif	0	QueryExternalCatalogs=1;

Vérifier le certificat SSL

Contrôle s'il convient de vérifier les certificats SSL lorsque vous utilisez le AWS SDK. Cette valeur est transmise au paramètre ClientConfiguration.verifySSL. Pour plus d'informations, consultez Configuration client AWS du Guide du développeur AWS SDK for C++ .

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
VerifySSL	Facultatif	1	VerifySSL=0;

Taille du bloc de résultats S3

Spécifie, en octets, la taille du bloc à télécharger pour une seule demande d'GetObjectAPI Amazon S3. La valeur par défaut est de 67108864 (64 Mo). Les valeurs minimale et maximale autorisées sont 10485760 (10 Mo) et 2146435072 (environ 2 Go).

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
S3 ResultBlockSize	Facultatif	67108864	S3ResultBlockSize=268435456;

Longueur de colonne de chaîne

Spécifie la longueur des colonnes contenant le type de string données. Comme Athena utilise le type de données de chaîne Apache Hive, dont la précision n'est pas définie, la longueur par défaut signalée par Athena est 2147483647 (). INT_MAX Comme les outils de BI préallouent généralement de la mémoire aux colonnes, cela peut entraîner une consommation de mémoire élevée. Pour éviter cela, le pilote ODBC Athena limite la précision signalée pour les colonnes du type de string données et expose le paramètre de StringColumnLength connexion afin que la valeur par défaut puisse être modifiée.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
StringColumnLength	Facultatif	255	StringColumnLength=65535;

Longueur de colonne de type complexe

Spécifie la longueur des colonnes contenant des types de données complexes tels que mapstruct, etarray. Par exemple StringColumnLength, Athena indique une précision nulle pour les colonnes contenant des types de données complexes. Le pilote ODBC Athena définit la précision par défaut pour les colonnes contenant des types de données complexes et expose le paramètre de ComplexTypeColumnLength connexion afin que la valeur par défaut puisse être modifiée.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
ComplexTypeColumnLength	Facultatif	65535	ComplexTypeColumnLength=123456;

Certificat de l'autorité de certification approuvée

Indique au client HTTP où trouver le magasin d'approbation de vos certificats SSL. Ce paramètre est transmis au paramètre ClientConfiguration.caFile. Pour plus d'informations, consultez Configuration client AWS du Guide du développeur AWS SDK for C++ .

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
TrustedCerts	Facultatif	%INSTALL_PATH%/bin	TrustedCerts=C:\\Program Files\\Amazon Athena ODBC Driver\\bin\\cacert.pem;

Période de sondage minimale

Spécifie la valeur minimale en millisecondes à attendre avant d'interroger Athena sur l'état d'exécution de la requête.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
MinQueryExecutionPollingInterval	Facultatif	100	MinQueryExecutionPollingInterval=200;

Période de sondage maximale

Spécifie la valeur maximale en millisecondes à attendre avant d'interroger Athena sur l'état d'exécution de la requête.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
MaxQueryExecutionPollingInterval	Facultatif	60000	MaxQueryExecutionPollingInterval=1000;

Multiplicateur de sondages

Spécifie le facteur d'augmentation de la période de sondage. Par défaut, le sondage commence par la valeur de la période de sondage minimale et double à chaque sondage jusqu'à atteindre la valeur de la période de sondage maximale.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
QueryExecutionPollingIntervalMultiplier	Facultatif	2	QueryExecutionPollingIntervalMultiplier=2;

Durée maximale du sondage

Spécifie la valeur maximale en millisecondes pendant laquelle un pilote peut interroger Athena pour connaître l'état d'exécution de la requête.

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
MaxPollDuration	Facultatif	1800000	MaxPollDuration=1800000;

Délai de connexion

La durée (en millisecondes) pendant laquelle la connexion HTTP attend pour établir une connexion. Cette valeur est définie pour le client Athena ClientConfiguration.connectTimeoutMs. Si elle n'est pas spécifiée, la valeur par défaut de curl est utilisée. Pour plus d'informations sur les paramètres de connexion, consultez Configuration client dans le Guide du développeur AWS SDK for Java .

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
ConnectionTimeout	Facultatif	0	ConnectionTimeout=2000;

Expiration de la demande

Spécifie l'expiration de la lecture du socket pour les clients HTTP. Cette valeur est définie pour le paramètre ClientConfiguration.requestTimeoutMs du client Athena. Pour plus d'informations sur les paramètres, consultez Configuration client dans le Guide du développeur AWS SDK for Java .

Nom de chaîne de connexion	Type de paramètre	Valeur par défaut	Exemple de chaîne de connexion
RequestTimeout	Facultatif	10000	RequestTimeout=30000;