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.
Rubriques
- Paramètres de chiffrement du résultat
- Paramètres de récupération des résultats
- Paramètres de réutilisation des résultats des requêtes
- Paramètres d'interrogation pour l'exécution des requêtes
- Paramètres de remplacement du point de terminaison
- Paramètres de configuration du proxy
- Paramètres de journalisation
- Nom de l'application
- Test de connexion
- Nombre de nouvelles tentatives
- Délai d'expiration du réseau
Paramètres de chiffrement du résultat
Notez les points suivants :
-
La AWS KMS clé doit être spécifiée quand
EncryptionOption
estSSE_KMS
ouCSE_KMS
. -
La AWS KMS clé ne peut pas être spécifiée lorsqu'elle ne l'
EncryptionOption
est pas ou quand elle l'EncryptionOption
estSSE_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=GetQueryResultsStream
option 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://
protocoleshttps://
ou ne sont pas spécifiés dans le document fourniURL, le pilote insère lehttps://
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://
protocoleshttps://
ou ne sont pas spécifiés dans le document fourniURL, le pilote insère lehttps://
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 remplacementAthenaEndpoint
. Si ni le remplacementAthenaStreamingEndpoint
ni le remplacementAthenaEndpoint
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://
protocoleshttps://
ou ne sont pas spécifiés dans le document fourniURL, le pilote insère lehttps://
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://
protocoleshttps://
ou ne sont pas spécifiés dans le document fourniURL, le pilote insère lehttps://
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://
protocoleshttps://
ou ne sont pas spécifiés dans le document fourniURL, le pilote insère lehttps://
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 |