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.
Migration vers le pilote ODBC 2.x
La plupart des paramètres de connexion ODBC 2.x Athena étant rétrocompatibles avec le pilote ODBC 1.x, vous pouvez réutiliser la majeure partie de votre chaîne de connexion existante avec le pilote ODBC 2.x Athena. Toutefois, les paramètres de connexion suivants nécessitent des modifications.
Niveau de journalisation
Alors que le pilote ODBC actuel fournit une gamme d'options de journalisation disponibles, allant de LOG_OFF (0) àLOG_TRACE (6), le pilote ODBC 2.x Amazon Athena ne comportait initialement que deux valeurs : 0 (désactivé) et 1 (activé). À partir de la version 2.0.6.0, le pilote prend désormais en charge des niveaux de journalisation plus granulaires avec des fonctionnalités de journalisation améliorées :
OFF- La journalisation est désactivéeERROR- Seuls les messages d'erreur sont enregistrésWARN- Les messages d'avertissement et les erreurs sont enregistrésINFO- Les messages d'information, les avertissements et les erreurs sont enregistrésDEBUG- Les informations de débogage détaillées et tous les messages de niveau inférieur sont enregistrésTRACE- Niveau de journalisation le plus détaillé, inclut tous les messages
Pour plus d'informations sur la journalisation du pilote ODBC 2.x, consultez Options de journalisation.
| Pilote ODBC 1.x | Pilote ODBC 2.x | |
|---|---|---|
| Nom de chaîne de connexion | LogLevel |
LogLevel |
| Type de paramètre | Facultatif | Facultatif |
| Valeur par défaut | 0 |
OFF |
| Valeurs possibles | 0-6 |
Pour les versions antérieures à 2.0.6.0 : Pour les versions 2.0.6.0 et ultérieures : |
| Exemple de chaîne de connexion | LogLevel=6; |
LogLevel=INFO; |
Note
Dans les versions 2.0.6.0 et ultérieures, le cadre de journalisation a été optimisé pour réduire les délais opérationnels et la génération excessive de fichiers journaux, tout en fournissant des informations de diagnostic plus détaillées grâce à ces niveaux de journalisation granulaires. Chaque niveau inclut tous les messages des niveaux inférieurs.
MetadataRetrievalMethod
Le pilote ODBC actuel propose plusieurs options pour récupérer les métadonnées d'Athena. Le pilote ODBC Amazon Athena rend la MetadataRetrievalMethod obsolète et utilise toujours l'API Amazon Athena pour extraire les métadonnées.
Athena introduit le drapeau QueryExternalCatalogs pour l'interrogation des catalogues externes. Pour interroger des catalogues externes avec le pilote ODBC actuel, définissez MetadataRetrievalMethod sur ProxyAPI. Pour interroger des catalogues externes avec le pilote ODBC, définissez QueryExternalCatalogs sur 1.
| Pilote ODBC 1.x | Pilote ODBC 2.x | |
|---|---|---|
| Nom de chaîne de connexion | MetadataRetrievalMethod |
QueryExternalCatalogs |
| Type de paramètre | Facultatif | Facultatif |
| Valeur par défaut | Auto |
0 |
| Valeurs possibles | Auto, AWS Glue, ProxyAPI,
Query |
0,1 |
| Exemple de chaîne de connexion | MetadataRetrievalMethod=ProxyAPI; |
QueryExternalCatalogs=1; |
Test de connexion
Lorsque vous testez une connexion à un pilote ODBC 1.x, le pilote exécute une requête SELECT 1 qui génère deux fichiers dans votre compartiment Amazon S3 : un pour le jeu de résultats et un pour les métadonnées. La connexion de test est facturée conformément à la politique de tarification Amazon Athena
Lorsque vous testez la connexion d'un pilote ODBC 2.x, le pilote appelle l'action GetWorkGroupAthena API. L'appel utilise le type d'authentification et le fournisseur d'informations d'identification correspondant que vous avez spécifiés pour récupérer les informations d'identification. Le test de connexion est gratuit lorsque vous utilisez le pilote ODBC 2.x, et le test ne génère aucun résultat de requête dans votre compartiment Amazon S3.
