Linux - Amazon Athena
Configuration système requise pour LinuxInstallation du connecteur de données ODBC sous LinuxConfiguration du nom d'une source de données sous LinuxVérifiez la signature du pilote ODBC

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.

Linux

Si vous souhaitez utiliser un ordinateur client Linux pour accéder à Amazon Athena, le pilote ODBC Amazon 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 (RHEL) 7 ou 8

    • CentOS 7 or 8.

  • Disposer de 100 Mo d'espace disque disponible.

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

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

Installation du connecteur de données ODBC sous Linux

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

Pour installer le pilote ODBC 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 pilote ODBC Amazon Athena et le nom de la source de données (DSN).

Note

Par défaut, les gestionnaires de pilotes ODBC utilisent les fichiers de configuration cachés .odbc.ini et .odbcinst.ini situés 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 opérations suivantes.

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

  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 pilotes UnixODBC et les bons fichiers : odbc*.ini

    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 pilote ODBC Amazon Athena, utilisez l'outil de isql ligne de commande UnixODBC pour vérifier la connexion, comme dans l'exemple suivant.

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

Vérifiez la signature du pilote ODBC

Important

Nous vous recommandons de vérifier la signature RPM du pilote ODBC Athena avant de l'installer sur votre machine.

Procédez comme suit pour vérifier la signature du package RPM du pilote ODBC Athena :

  1. Préparez les modèles

    Préparez les commandes avec la clé publique appropriée, la signature RPM et le lien d'accès correspondant aux scripts RPM hébergés dans les compartiments Amazon S3. Vous devez télécharger ce qui suit sur votre appareil.

  2. Téléchargez le pilote ODBC Athena, la clé publique et la signature Athena ODBC RPM sur votre appareil.

  3. Exécutez la commande suivante pour vérifier la signature du pilote ODBC :

    openssl dgst -sha256 -verify public_key.pem -signature signature.bin AmazonAthenaODBC-2.0.4.0.rpm

    Si la vérification est réussie, vous verrez un message similaire àVerified OK. Cela signifie que vous pouvez maintenant procéder à l'installation du pilote ODBC Athena.

    S'il échoue avec un messageVerification Failure, cela signifie que la signature sur RPM a été falsifiée. Assurez-vous que les trois fichiers mentionnés à l'étape 1 sont présents, que les chemins sont correctement spécifiés et que les fichiers n'ont pas été modifiés depuis le téléchargement, puis relancez le processus de vérification.