Paramètres de connexion avancés - Amazon Athena

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Paramètres de connexion avancés

Les sections suivantes décrivent les paramètres de connexion avancés pour le pilote JDBC 3.x.

Paramètres de chiffrement du résultat

Notez les points suivants :

  • La AWS KMS clé doit être spécifiée quand EncryptionOption est SSE_KMS ouCSE_KMS.

  • La AWS KMS clé ne peut pas être spécifiée lorsqu'elle ne l'EncryptionOptionest pas ou quand elle l'EncryptionOptionestSSE_S3.

Options de chiffrement

Le type de chiffrement à utiliser pour les résultats des requêtes lorsqu'ils sont stockés dans Amazon S3. Pour plus d'informations sur le chiffrement des résultats des requêtes, consultez EncryptionConfigurationle manuel Amazon Athena API Reference.

Nom du paramètre Alias Type de paramètre Valeur par défaut Valeurs possibles
EncryptionOption S3 OutputEncOption (obsolète) Facultatif none SSE_S3, SSE _KMS, CSE _ KMS

KMSClé

La KMS clé ARN ou l'identifiant, si SSE_KMS ou CSE_KMS est choisi comme option de chiffrement. Pour plus d'informations, consultez EncryptionConfigurationle manuel Amazon Athena API Reference.

Nom du paramètre Alias Type de paramètre Valeur par défaut
KmsKey S3 OutputEnc KMSKey (obsolète) Facultatif none

Paramètres de récupération des résultats

Récupérateur de résultats

Le récupérateur qui sera utilisé pour télécharger les résultats de la requête.

Les récupérateurs disponibles sont identiques dans la mesure où ils renvoient tous des résultats depuis Amazon S3, mais ils diffèrent en termes de performances et de mise en œuvre. L'extracteur de résultats par défaut télécharge S3 les résultats des requêtes directement depuis Amazon S3 sans utiliser l'AthenaAPIs. C'est l'option la plus rapide dans la S3 plupart des cas, mais elle n'est pas disponible si 1) les résultats de votre requête sont chiffrés CSE_KMS ou 2) si la politique qui permet à l'utilisateur d'accéder aux résultats des requêtes autorise uniquement les appels d'Athéna en utilisant. s3:CalledVia L'ResultFetcher=GetQueryResultsStreamoption utilise le streaming du jeu de résultats API et est l'équivalent du UseResultsetStreaming = 1 paramètre du pilote JDBC 2.x.

Nom du paramètre Alias Type de paramètre Valeur par défaut Valeurs possibles
ResultFetcher none Facultatif S3 S3 GetQueryResults, GetQueryResultsStream

Taille d'extraction

La valeur de ce paramètre est utilisée comme valeur minimale pour les tampons internes et comme taille de page cible lors de la récupération des résultats. La valeur 0 (zéro) signifie que le pilote doit utiliser ses valeurs par défaut, comme décrit ci-dessous. La valeur maximale est 1 000 000.

Nom du paramètre Alias Type de paramètre Valeur par défaut
FetchSize RowsToFetchPerBlock (obsolète) Facultatif 0
  • Le GetQueryResults récupérateur utilisera toujours une taille de page de 1 000, qui est la valeur maximale prise en charge par l'APIappel. Lorsque la taille d'extraction est supérieure à 1 000, plusieurs API appels successifs sont effectués pour remplir la mémoire tampon au-dessus du minimum.

  • Le récupérateur GetQueryResultsStream utilisera la taille de lecture configurée comme taille de page, soit 10 000 par défaut.

  • Le récupérateur S3 utilisera la taille de lecture configurée comme taille de page, soit 10 000 par défaut.

Paramètres de réutilisation des résultats des requêtes

Activer la réutilisation des résultats

Indique si les résultats précédents de la même requête peuvent être réutilisés lors de l'exécution d'une requête. Pour plus d'informations sur la réutilisation des résultats de requête, consultez ResultReuseByAgeConfiguration.

Nom du paramètre Alias Type de paramètre Valeur par défaut
EnableResultReuseByAge none Facultatif FALSE

Âge maximum de réutilisation des résultats

L'âge maximum, en minutes, d'un résultat de requête précédent qu'Athena doit envisager de réutiliser. Pour plus d'informations sur l'âge maximal de réutilisation des résultats, voir ResultReuseByAgeConfiguration.

Nom du paramètre Alias Type de paramètre Valeur par défaut
MaxResultReuseAgeInMinutes none Facultatif 60

Paramètres d'interrogation pour l'exécution des requêtes

Intervalle d'interrogation minimal pour l'exécution des requêtes

La durée minimale, en millisecondes, à attendre avant d'interroger Athena sur l'état d'exécution de la requête.

Nom du paramètre Alias Type de paramètre Valeur par défaut
MinQueryExecutionPollingIntervalMillis MinQueryExecutionPollingInterval (obsolète) Facultatif 100

Intervalle d'interrogation maximal pour l'exécution des requêtes

La durée maximale, en millisecondes, à attendre avant d'interroger Athena sur l'état d'exécution de la requête.

Nom du paramètre Alias Type de paramètre Valeur par défaut
MaxQueryExecutionPollingIntervalMillis MaxQueryExecutionPollingInterval (obsolète) Facultatif 5000

Multiplicateur d'intervalle d'interrogation pour l'exécution des requêtes

Le facteur d'augmentation de la période d'interrogation. Par défaut, l'interrogation commence par la valeur de MinQueryExecutionPollingIntervalMillis et double à chaque interrogation jusqu'à atteindre la valeur de MaxQueryExecutionPollingIntervalMillis.

Nom du paramètre Alias Type de paramètre Valeur par défaut
QueryExecutionPollingIntervalMultiplier none Facultatif 2

Paramètres de remplacement du point de terminaison

Remplacement du point de terminaison Athena

Le point de terminaison que le conducteur utilisera pour API passer des appels à Athéna.

Notez les points suivants :

  • Si les http:// protocoles https:// ou ne sont pas spécifiés dans le document fourniURL, le pilote insère le https:// préfixe.

  • Si ce paramètre n'est pas spécifié, le pilote utilise un point de terminaison par défaut.

Nom du paramètre Alias Type de paramètre Valeur par défaut
AthenaEndpoint EndpointOverride (obsolète) Facultatif none

Remplacement du point de terminaison du service de streaming Athena

Le point de terminaison que le pilote utilisera pour télécharger les résultats de la requête lorsqu'il utilisera le service de streaming Athena. Le service de streaming Athena est disponible sur le port 444.

Notez les points suivants :

  • Si les http:// protocoles https:// ou ne sont pas spécifiés dans le document fourniURL, le pilote insère le https:// préfixe.

  • Si aucun port n'est spécifié dans le document fourniURL, le pilote insère le port 444 du service de streaming.

  • Si le paramètre AthenaStreamingEndpoint n'est pas spécifié, le pilote utilise le remplacement AthenaEndpoint. Si ni le remplacement AthenaStreamingEndpoint ni le remplacement AthenaEndpoint ne sont spécifiés, le pilote utilise un point de terminaison de streaming par défaut.

Nom du paramètre Alias Type de paramètre Valeur par défaut
AthenaStreamingEndpoint StreamingEndpointOverride (obsolète) Facultatif none

LakeFormation remplacement du point de terminaison

Point de terminaison que le conducteur utilisera pour le service Lake Formation lorsqu'il utilisera le AWS Lake Formation AssumeDecoratedRoleWithSAMLAPIpour récupérer des informations d'identification temporaires. Si ce paramètre n'est pas spécifié, le pilote utilise un point de terminaison Lake Formation par défaut.

Notez les points suivants :

  • Si les http:// protocoles https:// ou ne sont pas spécifiés dans le document fourniURL, le pilote insère le https:// préfixe.

Nom du paramètre Alias Type de paramètre Valeur par défaut
LakeFormationEndpoint

LfEndpointOverride (obsolète)

Facultatif none

Remplacement du point de terminaison S3

Le point de terminaison que le pilote utilisera pour télécharger les résultats de la requête lorsqu'il utilise le récupérateur Amazon S3. Si ce paramètre n'est pas spécifié, le pilote utilise un point de terminaison Amazon S3 par défaut.

Notez les points suivants :

  • Si les http:// protocoles https:// ou ne sont pas spécifiés dans le document fourniURL, le pilote insère le https:// préfixe.

Nom du paramètre Alias Type de paramètre Valeur par défaut
S3Endpoint Aucun Facultatif none

Remplacement des points de terminaison STS

Le point de terminaison que le conducteur utilisera pour le AWS STS service lorsqu'il utilisera le AWS STS AssumeRoleWithSAMLAPIpour récupérer des informations d'identification temporaires. Si ce paramètre n'est pas spécifié, le pilote utilise un point de AWS STS terminaison par défaut.

Notez les points suivants :

  • Si les http:// protocoles https:// ou ne sont pas spécifiés dans le document fourniURL, le pilote insère le https:// préfixe.

Nom du paramètre Alias Type de paramètre Valeur par défaut
StsEndpoint StsEndpointOverride(obsolète) Facultatif none

Paramètres de configuration du proxy

Hôte proxy

Celui URL de l'hôte proxy. Utilisez ce paramètre si vous souhaitez que les requêtes Athena passent par un proxy.

Note

Assurez-vous d'inclure le protocole https:// ou http:// au début du URL formulaireProxyHost.

Nom du paramètre Alias Type de paramètre Valeur par défaut
ProxyHost none Facultatif none

Port proxy

Le port à utiliser sur l'hôte proxy. Utilisez ce paramètre si vous souhaitez que les requêtes Athena passent par un proxy.

Nom du paramètre Alias Type de paramètre Valeur par défaut
ProxyPort none Facultatif none

Nom d'utilisateur du proxy

Le nom d'utilisateur permettant de s'authentifier sur le serveur proxy. Utilisez ce paramètre si vous souhaitez que les requêtes Athena passent par un proxy.

Nom du paramètre Alias Type de paramètre Valeur par défaut
ProxyUsername Proxy UID (obsolète) Facultatif none

Mot de passe proxy

Le mot de passe permettant de s'authentifier sur le serveur proxy. Utilisez ce paramètre si vous souhaitez que les requêtes Athena passent par un proxy.

Nom du paramètre Alias Type de paramètre Valeur par défaut
ProxyPassword Proxy PWD (obsolète) Facultatif none

Les hôtes exempts de proxy

Un ensemble de noms d'hôtes auxquels le pilote se connecte sans utiliser de proxy lorsque le proxy est activé (c'est-à-dire lorsque les paramètres de connexion ProxyHost et ProxyPort sont définis). Les hôtes doivent être séparés par le caractère de barre verticale (|) (par exemple host1.com|host2.com).

Nom du paramètre Alias Type de paramètre Valeur par défaut
ProxyExemptHosts NonProxyHosts Facultatif none

Proxy activé pour les fournisseurs d'identité

Spécifie si un proxy doit être utilisé lorsque le pilote se connecte à un fournisseur d'identité.

Nom du paramètre Alias Type de paramètre Valeur par défaut
ProxyEnabledForIdP UseProxyForIdP Facultatif FALSE

Paramètres de journalisation

Cette section décrit les paramètres liés à la journalisation.

Niveau de journalisation

Spécifie le niveau de journalisation du pilote. Rien n'est journalisé, sauf si le paramètre LogPath est également défini.

Note

Nous vous recommandons de ne définir que le paramètre LogPath, sauf si vous avez des exigences particulières. La définition du seul paramètre LogPath permet d'activer la journalisation et d'utiliser le niveau de journalisation TRACE par défaut. Le niveau de journalisation TRACE fournit la journalisation la plus détaillée.

Nom du paramètre Alias Type de paramètre Valeur par défaut Valeurs possibles
LogLevel none Facultatif TRACE OFF, ERROR, WARN, INFO, DEBUG, TRACE

Chemin d'accès au journal

Le chemin d'accès à un répertoire de l'ordinateur qui exécute le pilote dans lequel les journaux du pilote seront stockés. Un fichier journal avec un nom unique sera créé dans le répertoire spécifié. Si cette option est définie, la journalisation du pilote est activée.

Nom du paramètre Alias Type de paramètre Valeur par défaut
LogPath none Facultatif none

Nom de l'application

Le nom de l'application qui utilise le pilote. Si une valeur est spécifiée pour ce paramètre, elle est incluse dans la chaîne de l'agent utilisateur des API appels que le pilote fait à Athena.

Note

Vous pouvez également définir le nom de l'application en appelant setApplicationName sur l'objet DataSource.

Nom du paramètre Alias Type de paramètre Valeur par défaut
ApplicationName none Facultatif none

Test de connexion

S'il est défini surTRUE, le pilote effectue un test de connexion chaque fois qu'une JDBC connexion est créée, même si aucune requête n'est exécutée sur la connexion.

Nom du paramètre Alias Type de paramètre Valeur par défaut
ConnectionTest none Facultatif TRUE
Note

Un test de connexion envoie une requête SELECT 1 à Athena pour vérifier que la connexion a été correctement configurée. Cela signifie que deux fichiers seront stockés dans Amazon S3 (le jeu de résultats et les métadonnées), et des frais supplémentaires peuvent s'appliquer conformément à la tarification d'Amazon Athena.

Nombre de nouvelles tentatives

Le nombre maximal de fois que le pilote doit renvoyer une requête réitérable à Athena.

Nom du paramètre Alias Type de paramètre Valeur par défaut
NumRetries MaxErrorRetry (obsolète) Facultatif none

Délai d'expiration du réseau

Le délai d'attente du réseau contrôle le temps pendant lequel le pilote attend qu'une connexion réseau soit établie. Cela inclut le temps nécessaire pour envoyer les API demandes. Dans de rares cas, il peut être utile de modifier le délai d'expiration du réseau. Par exemple, vous souhaiterez peut-être augmenter le délai d'expiration pour les longues pauses de collecte des ordures. La définition de ce paramètre de connexion revient à utiliser la setNetworkTimeout méthode sur un Connection objet.

Nom du paramètre Alias Type de paramètre Valeur par défaut

NetworkTimeoutMillis

none Facultatif none