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

Linux

L’accès à Amazon Athena depuis un ordinateur client Linux requiert le pilote ODBC Amazon Athena.

Configuration système requise pour Linux

Chaque ordinateur client Linux sur lequel vous installez le pilote doit disposer au minimum des éléments suivants.

  • Accès racine

  • L’une des distributions Linux suivantes :

    • Red Hat Enterprise Linux (RHEL) 7  8

    • CentOS 7 or 8.

  • 100 Mo d’espace disque disponible

  • unixODBC 2.3.1 ou version ultérieure

  • Bibliothèque C GNU (glibc) 2.26 ou version ultérieure.

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’opération 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 d’un nom de source de données sous Linux

Une fois le pilote installé, vous trouverez les exemples de fichiers .odbc.ini et .odbcinst.ini à l’emplacement suivant :

  • /opt/athena/odbc/ini/.

Vous pouvez utiliser les fichiers .ini 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, qui se trouvent dans le répertoire de base.

Procédez comme suit pour spécifier le chemin d’accès aux fichiers .odbc.ini et .odbcinst.ini à l’aide d’unixODBC.

Pour spécifier l’emplacement des fichiers ODBC .ini à l’aide d’unixODBC

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

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

  2. Définissez ODBCSYSINI sur le chemin complet du répertoire qui contient le fichier odbcinst.ini, comme illustré 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 fichiers odbc*.ini appropriés :

    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 vous connecter à votre magasin de données à l’aide d’un DSN, configurez le fichier odbc.ini pour définir des DSN. Définissez les propriétés dans le fichier odbc.ini pour créer un DSN qui spécifie les informations de connexion de votre magasin de données, comme illustré 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 fichier odbcinst.ini comme indiqué ci-dessous.

    [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 ligne de commande unixODBC isql pour vérifier la connexion, comme dans l’exemple suivant.

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

Vérification de la signature du pilote ODBC

Important

Il est recommandé de vérifier la signature du RPM du pilote ODBC Athena avant de l’installer sur votre ordinateur.

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 du RPM et le lien d’accès correspondant aux scripts RPM hébergés dans des compartiments Amazon S3. Téléchargez les éléments suivants sur votre appareil :

  2. Téléchargez le pilote ODBC Athena, la clé publique et la signature du RPM du pilote ODBC Athena 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 aboutit, un message semblable à Verified OK s’affiche. Cela signifie que vous pouvez procéder à l’installation du pilote ODBC Athena.

    Si la vérification échoue et génère un message Verification Failure, cela signifie que la signature du RPM a été falsifiée. Vérifiez 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 la vérification.