Comment activer les journaux de débogage dans mon pilote Athena JDBC/ODBC ?

Résolution

Important : les journaux de débogage doivent uniquement être activés pendant la durée requise pour identifier un problème. La journalisation réduit les performances et peut consommer une grande quantité d'espace disque.

Pilotes JDBC

Vous pouvez utiliser les versions 2.x et 3.x du pilote JDBC pour vous connecter à Athena. Pour en savoir plus sur les différents paramètres des versions 2.x et 3.x de JDBC, consultez la page Niveau de journalisation.

Activation des journaux de débogage pour Athena JDBC version 2.x

Pour activer les journaux de débogage, configurez les propriétés suivantes dans votre pilote Athena JDBC 2.x :

• Pour LogLevel, sélectionnez 5.
• Pour UseAwsLogger, sélectionnez 1.
  Remarque : grâce à cette propriété, le pilote JDBC enregistre également les informations provenant des appels d'API AWS.
• Dans LogPath, saisissez l’emplacement sur votre machine hôte où vous souhaitez que les journaux du pilote soient capturés.

Remarque : vous pouvez également configurer des options similaires dans votre outil de business intelligence pour activer les journaux de débogage.

Veillez à redémarrer votre application JDBC, puis à vous reconnecter au serveur.

Pour en savoir plus sur les fichiers journaux activés, consultez la page Configuring logging sur le site Web d'insightsoftware.

Activation des journaux de débogage pour Athena JDBC version 3.x

Pour activer les journaux de débogage, configurez les propriétés suivantes dans votre pilote Athena JDBC 3.x :

• Dans LogLevel, sélectionnez DEBUG.
• Dans LogPath, saisissez l’emplacement sur votre machine hôte où vous souhaitez que les journaux du pilote soient capturés.

Remarque : vous pouvez également configurer des options similaires dans votre outil de business intelligence pour activer les journaux de débogage.

Pour vous assurer que les nouveaux paramètres prennent effet, redémarrez votre application JDBC, puis reconnectez-vous au serveur.

Le pilote Athena JDBC 3.x générera des fichiers journaux à l'emplacement spécifié dans la propriété LogPath.

Pilotes ODBC

Vous pouvez utiliser les versions 1.x et 2.x du pilote ODBC pour vous connecter à Athena. Pour obtenir plus d'informations et télécharger les pilotes ODBC, consultez la page Connexion à Amazon Athena via ODBC.

Activation des journaux de débogage pour le pilote Athena ODBC 1.x

Téléchargez le pilote Athena ODBC 1.x pour Windows, Linux ou macOS sur votre ordinateur.

Pour activer les journaux de débogage sur un ordinateur Windows, procédez comme suit :

1. Dans le menu Démarrer de Windows, choisissez Sources de données ODBC.
2. Dans l’administrateur de sources de données ODBC, choisissez l’onglet DSN système.
3. Choisissez Ajouter.
4. Dans la liste des pilotes, choisissez Simba Athena ODBC Driver.
5. Choisissez Terminer.
   Remarque : un nouvel assistant s'ouvre dans lequel vous pouvez ajouter des informations, telles que la région AWS, le schéma, le groupe de travail, l'emplacement de sortie Amazon Simple Storage Service (Amazon S3) et la clé AWS Key Management Service (AWS KMS).
6. Choisissez Options de journalisation.
   Dans Niveau de journalisation, sélectionnez INFO.
   Dans Chemin d'accès aux journaux, sélectionnez un chemin sur votre ordinateur Windows.
   Cliquez sur OK.

Les journaux du pilote ODBC seront générés dans le chemin d'accès aux journaux que vous avez sélectionné.

Pour activer les journaux de débogage dans un pilote sur un ordinateur Linux ou macOS, procédez comme suit :

Linux : modifiez le fichier /opt/simba/athenaodbc/lib/64/simba.athenaodbc.ini, puis configurez les propriétés suivantes :

• Pour LogLevel, sélectionnez 5.
• Dans LogPath, saisissez un chemin d’accès à votre hôte.

macOS : modifiez le fichier /Library/simba/athenaodbc/lib/simba.athenaodbc.ini, puis configurez les propriétés suivantes :

• Pour LogLevel, sélectionnez 5.
• Dans LogPath, saisissez un chemin d’accès à votre hôte.

Veillez à redémarrer votre application ODBC, puis à vous reconnecter au serveur.

Pour en savoir plus sur les fichiers journaux activés, consultez la page Configuring logging options sur le site Web d'insightsoftware.

Activation des journaux de débogage pour le pilote Athena ODBC 2.x

Téléchargez le pilote Athena ODBC 2.x pour votre ordinateur Windows, Linux ou macOS. Créez ensuite une source de données pour votre système d'exploitation (OS).

Pour activer les journaux de débogage sur un ordinateur Windows, procédez comme suit :

1. Dans le menu Démarrer de Windows, choisissez Sources de données ODBC.
2. Dans l'administrateur des sources de données ODBC, choisissez le nom de votre source de données.
3. Choisissez Configurer, puis Options de journalisation.
4. Utilisez les paramètres suivants :
   Dans Niveau de journalisation choisissez log level: 1.
   Dans Chemin d'accès aux journaux, sélectionnez un chemin sur votre ordinateur Windows.
   (Facultatif) Pour activer les journaux du kit SDK AWS, choisissez Activer l’enregistreur AWS.
5. Cliquez sur OK.

Pour activer les journaux de débogage sur votre machine macOS, procédez comme suit :

1. Installez le connecteur de données ODBC sur macOS.
2. En fonction de votre processeur, ouvrez le fichier odbc.ini à l'emplacement suivant :
   Processeur Intel : /opt/athena/odbc/x86_64/ini/
   Processeur ARM : /opt/athena/odbc/arm64/ini/
3. Utilisez les paramètres suivants :
   Pour LogLevel, sélectionnez 1.
   (Facultatif) Pour UseAwsLogger, sélectionnez 1.
   Dans LogPath, saisissez un chemin d’accès à votre hôte.
4. Utilisez l'outil de ligne de commande iodbctest pour vérifier la connexion.

Pour activer les journaux de débogage sur un ordinateur Linux, procédez comme suit :

1. Installez le connecteur de données ODBC sous Linux.
2. Ouvrez le fichier /opt/athena/odbc/ini/odbc.ini.
3. Utilisez les paramètres suivants :
   Pour LogLevel, sélectionnez 1.
   (Facultatif) Pour UseAwsLogger, sélectionnez 1.
   Dans LogPath, saisissez un chemin d’accès à votre hôte.
4. Utilisez l'outil de ligne de commande unixODBC isql pour vérifier la connexion.

Les journaux du pilote ODBC seront générés dans le chemin d'accès aux journaux que vous avez sélectionné.

Informations connexes

Connexion à Amazon Athena avec les pilotes ODBC et JDBC

Athena ODBC & JDBC Driver sur le site Web d'insightsoftware