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
<a name="jdbc-v3-driver-advanced-connection-parameters"></a>

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

**Topics**
+ [Paramètres de chiffrement du résultat](#jdbc-v3-driver-result-encryption-parameters)
+ [Paramètres de récupération des résultats](#jdbc-v3-driver-result-fetching-parameters)
+ [Paramètres de configuration des résultats](#jdbc-v3-driver-result-config)
+ [Paramètres de réutilisation des résultats des requêtes](#jdbc-v3-driver-query-result-reuse-parameters)
+ [Paramètres d'interrogation pour l'exécution des requêtes](#jdbc-v3-driver-query-execution-polling-parameters)
+ [Paramètres de remplacement du point de terminaison](#jdbc-v3-driver-endpoint-override-parameters)
+ [Paramètres de configuration du proxy](#jdbc-v3-driver-proxy-configuration-parameters)
+ [Paramètres de journalisation](#jdbc-v3-driver-logging-parameters)
+ [Application name (Nom de l'application)](#jdbc-v3-driver-application-name)
+ [Test de connexion](#jdbc-v3-driver-connection-test)
+ [Nombre de nouvelles tentatives](#jdbc-v3-driver-number-of-retries)
+ [Délai d'expiration du réseau](#jdbc-v3-driver-networktimeoutmillis)

## Paramètres de chiffrement du résultat
<a name="jdbc-v3-driver-result-encryption-parameters"></a>

Notez les points suivants :
+ La AWS KMS clé doit être spécifiée quand `EncryptionOption` est `SSE_KMS` ou`CSE_KMS`.
+ La AWS KMS clé ne peut pas être spécifiée lorsqu'elle ne l'`EncryptionOption`est pas ou quand elle l'`EncryptionOption`est`SSE_S3`.

### Options de chiffrement
<a name="jdbc-v3-driver-encryption-option"></a>

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 [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html)le 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 | Aucune | SSE\$1S3, SSE\$1KMS, CSE\$1KMS | 

### Clé KMS
<a name="jdbc-v3-driver-kms-key"></a>

L'ARN ou l'ID de la clé KMS, si `SSE_KMS` ou `CSE_KMS` est choisi comme option de chiffrement. Pour plus d'informations, consultez [EncryptionConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_EncryptionConfiguration.html)le 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 | Aucune | 

## Paramètres de récupération des résultats
<a name="jdbc-v3-driver-result-fetching-parameters"></a>

### Récupérateur de résultats
<a name="jdbc-v3-driver-result-fetcher"></a>

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

L'extracteur de résultats par défaut télécharge `auto` les résultats des requêtes directement depuis Amazon S3 sans utiliser l'Athena APIs. Lorsque le téléchargement direct depuis S3 n’est pas possible, par exemple lorsque les résultats des requêtes sont chiffrés avec l’option `CSE_KMS`, l’API `GetQueryResultsStream` est automatiquement utilisée.

En règle générale, il est recommandé d’utiliser le récupérateur `auto`. Si vos politiques IAM ou vos politiques de compartiment S3 utilisent la CalledVia condition [s3 :](security-iam-athena-calledvia.md) pour limiter l'accès aux demandes d'objets S3 provenant d'Athena, `auto` le récupérateur tente d'abord de télécharger les résultats depuis S3, puis revient à utiliser l'API. `GetQueryResultsStream` Dans ce cas, vous pouvez définir le sur ResultFetcher `GetQueryResultsStream` pour éviter un appel d'API supplémentaire.


****  

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

### Taille d'extraction
<a name="jdbc-v3-driver-fetch-size"></a>

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 récupérateur `GetQueryResults` utilisera toujours une taille de page de 1 000, qui est la valeur maximale prise en charge par l'appel d'API. Lorsque la taille de récupération est supérieure à 1 000, plusieurs appels d'API 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 configuration des résultats
<a name="jdbc-v3-driver-result-config"></a>

### Propriétaire du compartiment attendu
<a name="jdbc-v3-driver-exp-bucket-owner"></a>

ID de compte du propriétaire attendu du compartiment s3. Si l’ID de compte fourni ne correspond pas au propriétaire réel du compartiment, la demande échoue. Pour plus d’informations sur la vérification du propriétaire du compartiment s3, consultez [Verifying bucket ownership](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-owner-condition.html#bucket-owner-condition-use).


****  

| Nom du paramètre | Alias | Type de paramètre | Valeur par défaut | 
| --- | --- | --- | --- | 
| ExpectedBucketOwner | Aucune | Facultatif | Aucune | 

### Option Acl
<a name="jdbc-v3-driver-acl"></a>

Indique qu’une ACL prédéfinie Amazon S3 est nécessaire pour contrôler la propriété des résultats de requêtes stockés. Pour plus d’informations sur `AclOption`, consultez [AclConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_AclConfiguration.html).


****  

| Nom du paramètre | Alias | Type de paramètre | Valeur par défaut | Valeurs possibles | 
| --- | --- | --- | --- | --- | 
| AclOption | Aucune | Facultatif | Aucune | BUCKET\$1OWNER\$1FULL\$1CONTROL | 

## Paramètres de réutilisation des résultats des requêtes
<a name="jdbc-v3-driver-query-result-reuse-parameters"></a>

### Activer la réutilisation des résultats
<a name="jdbc-v3-driver-enable-result-reuse"></a>

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](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html).


****  

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

### Âge maximum de réutilisation des résultats
<a name="jdbc-v3-driver-result-reuse-max-age"></a>

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](https://docs.aws.amazon.com/athena/latest/APIReference/API_ResultReuseByAgeConfiguration.html).


****  

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

## Paramètres d'interrogation pour l'exécution des requêtes
<a name="jdbc-v3-driver-query-execution-polling-parameters"></a>

### Intervalle d'interrogation minimal pour l'exécution des requêtes
<a name="jdbc-v3-driver-minimum-query-execution-polling-interval"></a>

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
<a name="jdbc-v3-driver-maximum-query-execution-polling-interval"></a>

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
<a name="jdbc-v3-driver-query-execution-polling-interval-multiplier"></a>

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 | Aucune | Facultatif | 2 | 

## Paramètres de remplacement du point de terminaison
<a name="jdbc-v3-driver-endpoint-override-parameters"></a>

### Remplacement du point de terminaison Athena
<a name="jdbc-v3-driver-athena-endpoint-override"></a>

Le point de terminaison que le pilote utilisera pour effectuer des appels d'API à Athena.

Notez les points suivants :
+ Si les protocoles `https://` ou `http://` ne sont pas spécifiés dans l'URL fournie, le pilote insère le préfixe `https://`.
+ 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 | Aucune | 

### Remplacement du point de terminaison du service de streaming Athena
<a name="jdbc-v3-driver-athena-streaming-service-endpoint-override"></a>

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 protocoles `https://` ou `http://` ne sont pas spécifiés dans l'URL fournie, le pilote insère le préfixe `https://`.
+ Si aucun port n'est spécifié dans l'URL fournie, 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 | Aucune | 

### LakeFormation remplacement du point de terminaison
<a name="jdbc-v3-driver-athena-lake-formation-endpoint-override"></a>

Point de terminaison que le pilote utilisera pour le service Lake Formation lorsqu'il utilisera l'API AWS Lake Formation [AssumeDecoratedRoleWithSAML](https://docs.aws.amazon.com/lake-formation/latest/APIReference/API_AssumeDecoratedRoleWithSAML.html) pour 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 protocoles `https://` ou `http://` ne sont pas spécifiés dans l'URL fournie, le pilote insère le préfixe `https://`.


****  

| Nom du paramètre | Alias | Type de paramètre | Valeur par défaut | 
| --- | --- | --- | --- | 
| LakeFormationEndpoint |  LfEndpointOverride (obsolète)  | Facultatif | Aucune | 

### Remplacement du point de terminaison S3
<a name="jdbc-v3-driver-athena-s3-endpoint-override"></a>

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 protocoles `https://` ou `http://` ne sont pas spécifiés dans l'URL fournie, le pilote insère le préfixe `https://`.


****  

| Nom du paramètre | Alias | Type de paramètre | Valeur par défaut | 
| --- | --- | --- | --- | 
| S3Endpoint | Aucune | Facultatif | Aucune | 

### Remplacement du point de terminaison STS
<a name="jdbc-v3-driver-athena-sts-endpoint-override"></a>

Point de terminaison que le pilote utilisera pour le AWS STS service lorsqu'il utilisera l'API AWS STS [AssumeRoleWithSAML](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html) pour 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 protocoles `https://` ou `http://` ne sont pas spécifiés dans l'URL fournie, le pilote insère le préfixe `https://`.


****  

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

### Remplacement du point de terminaison SSO OIDC
<a name="jdbc-v3-driver-athena-sso-oidc-endpoint-override"></a>

Point de terminaison que le pilote utilisera avec `ClientConfiguration.endpointOverride` pour remplacer le point de terminaison HTTP par défaut pour le client SSO OIDC. Pour de plus amples informations, veuillez consulter [ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html).


****  

| Nom du paramètre | Alias | Type de paramètre | Valeur par défaut | 
| --- | --- | --- | --- | 
| SSOOIDCEndpointRemplacer |  | Facultatif | Aucune | 

### Remplacement des points de terminaison d’administration SSO
<a name="jdbc-v3-driver-athena-sso-admin-endpoint-override"></a>

Point de terminaison que le pilote utilisera avec `ClientConfiguration.endpointOverride` pour remplacer le point de terminaison HTTP par défaut pour le client d’administration SSO. Pour de plus amples informations, veuillez consulter [ClientConfiguration](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/client-config.html).


****  

| Nom du paramètre | Alias | Type de paramètre | Valeur par défaut | 
| --- | --- | --- | --- | 
| SSOAdminEndpointOverride |  | Facultatif | Aucune | 

## Paramètres de configuration du proxy
<a name="jdbc-v3-driver-proxy-configuration-parameters"></a>

### Hôte proxy
<a name="jdbc-v3-driver-proxy-host"></a>

L'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 de l'URL de `ProxyHost`. 


****  

| Nom du paramètre | Alias | Type de paramètre | Valeur par défaut | 
| --- | --- | --- | --- | 
| ProxyHost | Aucune | Facultatif | Aucune | 

### Port proxy
<a name="jdbc-v3-driver-proxy-port"></a>

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 | Aucune | Facultatif | Aucune | 

### Nom d'utilisateur du proxy
<a name="jdbc-v3-driver-proxy-username"></a>

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 | ProxyUID (obsolète) | Facultatif | Aucune | 

### Mot de passe proxy
<a name="jdbc-v3-driver-proxy-password"></a>

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 | ProxyPWD (obsolète) | Facultatif | Aucune | 

### Les hôtes exempts de proxy
<a name="jdbc-v3-driver-proxy-exempt-hosts"></a>

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 | Aucune | 

### Proxy activé pour les fournisseurs d'identité
<a name="jdbc-v3-driver-proxy-enabled-for-identity-providers"></a>

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 | 
| --- | --- | --- | --- | 
| ProxyEnabledForId P | UseProxyForId P | Facultatif | FALSE | 

## Paramètres de journalisation
<a name="jdbc-v3-driver-logging-parameters"></a>

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

### Niveau du journal
<a name="jdbc-v3-driver-logging-parameters-log-level"></a>

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 | Aucune | Facultatif | TRACE | OFF, ERROR, WARN, INFO, DEBUG, TRACE | 

### Chemin d'accès au journal
<a name="jdbc-v3-driver-logging-parameters-log-path"></a>

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 | Aucune | Facultatif | Aucune | 

## Application name (Nom de l'application)
<a name="jdbc-v3-driver-application-name"></a>

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 d'agent utilisateur des appels d'API que le pilote effectue à 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 | Aucune | Facultatif | Aucune | 

## Test de connexion
<a name="jdbc-v3-driver-connection-test"></a>

S'il est défini sur `TRUE`, le pilote effectue un test de connexion chaque fois qu'une connexion JDBC 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 | Aucune | 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](https://aws.amazon.com/athena/pricing).

## Nombre de nouvelles tentatives
<a name="jdbc-v3-driver-number-of-retries"></a>

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 | Aucune | 

## Délai d'expiration du réseau
<a name="jdbc-v3-driver-networktimeoutmillis"></a>

Le délai d’expiration du réseau détermine combien de temps le pilote attend l’établissement d’une connexion réseau. Il inclut le temps d’envoi de demandes d’API. Dans de rares cas, il peut être utile de modifier le délai d’expiration du réseau. Par exemple, vous souhaiterez peut-être l’augmenter pour les longues pauses du récupérateur de mémoire. La définition de ce paramètre de connexion revient à utiliser la méthode `setNetworkTimeout` sur un objet `Connection`.


****  

| Nom du paramètre | Alias | Type de paramètre | Valeur par défaut | 
| --- | --- | --- | --- | 
|  NetworkTimeoutMillis  | Aucune | Facultatif | Aucune |