Linux

Si vous souhaitez utiliser un ordinateur client Linux pour accéder à Amazon Athena, le pilote Amazon ODBC Athena est requis.

Configuration système requise pour Linux

Chaque ordinateur client Linux sur lequel vous installez le pilote doit répondre aux exigences suivantes.

• Vous avez un accès root.

• Utilisez l'une des distributions Linux suivantes :

  • Red Hat Enterprise Linux (7 ou 8RHEL)

  • CentOS 7 or 8.

• Disposer de 100 Mo d'espace disque disponible.

• Utilisez la version 2.3.1 ou ultérieure d'ODBCUnix.

• Utilisez la version 2.26 ou ultérieure de la bibliothèque GNU C (glibc).

Installation du connecteur ODBC de données sous Linux

Suivez la procédure ci-dessous pour installer le ODBC pilote Amazon Athena sur un système d'exploitation Linux.

Pour installer le ODBC pilote Amazon Athena sous Linux

1. Entrez l'une des commandes suivantes :

   sudo rpm -Uvh AmazonAthenaODBC-2.X.Y.Z.rpm

   or

   sudo yum --nogpgcheck localinstall AmazonAthenaODBC-2.X.Y.Z.rpm

2. Une fois l'installation terminée, entrez l'une des commandes suivantes pour vérifier que le pilote est installé :

   • yum list | grep amazon-athena-odbc-driver

     Sortie :

     amazon-athena-odbc-driver.x86_64 2.0.2.1-1.amzn2int installed

   • rpm -qa | grep amazon

     Sortie :

     amazon-athena-odbc-driver-2.0.2.1-1.amzn2int.x86_64

Configuration du nom d'une source de données sous Linux

Une fois le pilote installé, vous pouvez trouver des exemples .odbc.ini et .odbcinst.ini des fichiers à l'emplacement suivant :

• /opt/athena/odbc/ini/.

Utilisez les .ini fichiers de cet emplacement comme exemples pour configurer le ODBC pilote Amazon Athena et le nom de la source de données ()DSN.

Note

Par défaut, les gestionnaires de ODBC pilotes utilisent les fichiers de configuration cachés .odbc.ini et.odbcinst.ini, qui se trouvent dans le répertoire de base.

Pour spécifier le chemin d'accès aux .odbcinst.ini fichiers .odbc.ini et à l'aide d'UnixODBC, effectuez les étapes suivantes.

Pour spécifier l'emplacement des ODBC .ini fichiers à l'aide d'Unix ODBC

1. Définissez ODBCINI le chemin complet et le nom de fichier du odbc.ini fichier, comme dans l'exemple suivant.

   export ODBCINI=/opt/athena/odbc/ini/odbc.ini

2. Définissez ODBCSYSINI le chemin complet du répertoire contenant le odbcinst.ini fichier, comme dans l'exemple suivant.

   export ODBCSYSINI=/opt/athena/odbc/ini

3. Entrez la commande suivante pour vérifier que vous utilisez le gestionnaire de ODBC pilotes Unix et les bons odbc*.ini fichiers :

   username % odbcinst -j

   Exemple de sortie.

   unixODBC 2.3.1
   DRIVERS............: /opt/athena/odbc/ini/odbcinst.ini
   SYSTEM DATA SOURCES: /opt/athena/odbc/ini/odbc.ini
   FILE DATA SOURCES..: /opt/athena/odbc/ini/ODBCDataSources
   USER DATA SOURCES..: /opt/athena/odbc/ini/odbc.ini
   SQLULEN Size.......: 8
   SQLLEN Size........: 8
   SQLSETPOSIROW Size.: 8

4. Si vous souhaitez utiliser un nom de source de données (DSN) pour vous connecter à votre magasin de données, configurez le odbc.ini fichier pour définir les noms des sources de données (DSNs). Définissez les propriétés du odbc.ini fichier pour créer un DSN qui spécifie les informations de connexion pour votre magasin de données, comme dans l'exemple suivant.

   [ODBC Data Sources]
   athena_odbc_test=Amazon Athena ODBC (x64) 
   
   [ATHENA_WIDE_SETTINGS]  # Special DSN-name to signal driver about logging configuration.
   LogLevel=0              # To enable ODBC driver logs, set this to 1.
   UseAwsLogger=0          # To enable AWS-SDK logs, set this to 1.
   LogPath=/opt/athena/odbc/logs/ # Path to store the log files. Permissions to the location are required. 
   
   [athena_odbc_test]
   Driver=/opt/athena/odbc/lib/libathena-odbc.so
   AwsRegion=us-west-1
   Workgroup=primary
   Catalog=AwsDataCatalog
   Schema=default
   AuthenticationType=IAM Credentials
   UID=
   PWD=
   S3OutputLocation=s3://amzn-s3-demo-bucket/

5. Configurez le odbcinst.ini fichier, comme dans l'exemple suivant.

   [ODBC Drivers]
   Amazon Athena ODBC (x64)=Installed 
   
   [Amazon Athena ODBC (x64)]
   Driver=/opt/athena/odbc/lib/libathena-odbc.so
   Setup=/opt/athena/odbc/lib/libathena-odbc.so

6. Après avoir installé et configuré le ODBC pilote Amazon Athena, utilisez l'outil de ODBC isql ligne de commande Unix pour vérifier la connexion, comme dans l'exemple suivant.

   username % isql -v "athena_odbc_test" 
   +---------------------------------------+
   | Connected!                            |
   |                                       |
   | sql-statement                         |
   | help [tablename]                      |
   | quit                                  |
   |                                       |
   +---------------------------------------+
   SQL>