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.

Récupérateur de résultats

Le récupérateur de résultats par défaut télécharge les résultats des requêtes directement depuis Amazon S3 sans utiliser les opérations d’API Athena. Lorsqu’il détecte des situations dans lesquelles le téléchargement direct de S3 n’est pas possible, il utilise automatiquement l’opération d’API GetQueryResultsStream. Cela se produit par exemple lorsque les résultats des requêtes sont chiffrés avec l’option CSE_KMS.

En règle générale, il est recommandé d’utiliser le récupérateur auto. Toutefois, si vos politiques IAM ou vos stratégies de compartiment S3 utilisent la condition s3:CalledVia pour limiter l’accès aux demandes d’objets S3 en provenance d’Athena, le récupérateur automatique tente de télécharger les résultats depuis S3, avant d’utiliser l’API GetQueryResultsStream. Dans ce cas, vous pouvez définir ResultFetcher sur GetQueryResultsStream pour éviter un appel d’API supplémentaire.

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.

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

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.

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.

Utilisation d’une requête pour répertorier les tables

Pour les types de catalogues LAMBDA, ce paramètre permet au pilote ODBC de soumettre une requête SHOW TABLES 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 Athena ListTableMetadata pour obtenir la liste des tables disponibles. Notez que pour les types de catalogues LAMBDA, l’utilisation de ListTableMetadata entraîne une dégradation des performances.

Utilisation de WCHAR pour les types de chaînes

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

Interroger des catalogues externes

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

Vérifier le certificat SSL

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

Taille du bloc de résultats S3

Spécifie, en octets, la taille du bloc à télécharger pour une seule demande d'API GetObject 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).

Longueur de colonne de chaîne

Spécifie la longueur des colonnes pour le type de données string. Puisqu’Athena utilise le type de données de chaîne Apache Hive, dont la précision n’est pas définie, Athena indique la longueur par défaut 2147483647 (INT_MAX). Les outils de BI préallouent généralement de la mémoire aux colonnes, ce qui peut entraîner une consommation de mémoire élevée. Pour éviter ce problème, le pilote ODBC Athena limite la précision indiquée pour les colonnes de données de type string et expose le paramètre de connexion StringColumnLength pour permettre la modification de la valeur par défaut.

Longueur de colonne de type complexe

Spécifie la longueur des colonnes contenant des types de données complexes, comme map, struct et array. Comme pour StringColumnLength, Athena indique une précision nulle pour les colonnes contenant des types de données complexes. Le pilote ODBC Athena limite la précision par défaut pour les colonnes de données complexes et expose le paramètre de connexion ComplexTypeColumnLength pour permettre la modification de la valeur par défaut.

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 pour C++.

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.

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.

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.

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.

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 pour Java.

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 pour Java.