Linux - Amazon Athena

Linux

Wenn Sie einen Linux-Client-Computer für den Zugriff auf Amazon Athena verwenden möchten, ist der Amazon Athena ODBC-Treiber erforderlich.

Linux-Systemanforderungen

Jeder Linux-Client-Computer, auf dem Sie den Treiber installieren, muss die folgenden Anforderungen erfüllen.

  • Sie haben Root-Zugriff.

  • Verwenden Sie eine der folgenden Linux-Verteilungen:

    • Red Hat Enterprise Linux (RHEL) 7 oder 8

    • CentOS 7 oder 8.

  • 100 MB Speicherplatz verfügbar haben.

  • Verwenden Sie Version 2.3.1 oder höher von unixODBC.

  • Verwenden Sie Version 2.26 oder höher der GNU C Bibliothek (glibc).

ODBC-Datenconnectors unter Linux installieren

Gehen Sie wie folgt vor, um den Amazon Athena ODBC-Treiber auf einem Linux-Betriebssystem zu installieren.

Um den Amazon Athena ODBC-Treiber unter Linux zu installieren
  1. Geben Sie einen der folgenden Befehle ein:

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

    oder

    sudo yum --nogpgcheck localinstall AmazonAthenaODBC-2.X.Y.Z.rpm
  2. Geben Sie nach Abschluss der Installation einen der folgenden Befehle ein, um zu überprüfen, ob der Treiber installiert ist:

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

      Ausgabe:

      amazon-athena-odbc-driver.x86_64 2.0.2.1-1.amzn2int installed
    • rpm -qa | grep amazon

      Ausgabe:

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

Konfiguration eines Datenquellennamens unter Linux

Nach der Installation des Treibers finden Sie .odbc.ini und .odbcinst.ini-Beispieldateien an folgendem Speicherort:

  • /opt/athena/odbc/ini/.

Verwenden Sie die .ini-Dateien als Beispiele für die Konfiguration des Amazon Athena ODBC-Treibers und des Datenquellennamens (DSN).

Anmerkung

Standardmäßig verwenden ODBC-Treibermanager die versteckten Konfigurationsdateien .odbc.ini und .odbcinst.ini, die sich im Home-Verzeichnis befinden.

Gehen Sie wie folgt vor, um den Pfad zu den .odbc.ini und .odbcinst.ini-Dateien mit unixODBC anzugeben.

Um die ODBC .ini-Dateispeicherorte mit unixODBC anzugeben
  1. Legen Sie ODBCINI auf den vollständigen Pfad und Dateinamen der odbc.ini-Datei fest, wie im folgenden Beispiel.

    export ODBCINI=/opt/athena/odbc/ini/odbc.ini
  2. Legen Sie ODBCSYSINI auf den vollständigen Pfad des Verzeichnisses fest, das die odbcinst.ini-Datei enthält, wie im folgenden Beispiel.

    export ODBCSYSINI=/opt/athena/odbc/ini
  3. Geben Sie den folgenden Befehl ein, um zu überprüfen, ob Sie den unixODBC-Treibermanager und die richtigen odbc*.ini-Dateien verwenden:

    username % odbcinst -j

    Beispielausgabe

    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. Wenn Sie einen Datenquellennamen (DSN) für die Verbindung zu Ihrem Datenspeicher verwenden möchten, konfigurieren Sie die odbc.ini-Datei um Datenquellennamen (DSNs) zu definieren. Legen Sie die Eigenschaften in der odbc.ini-Datei fest, um einen DSN zu erstellen, der die Verbindungsinformationen für den Datenspeicher angibt, wie im folgenden Beispiel.

    [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. Konfigurieren Sie die odbcinst.ini Datei, wie im folgenden Beispiel.

    [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. Nachdem Sie den Amazon Athena ODBC-Treiber installiert und konfiguriert haben, verwenden Sie das unixODBC isql-Befehlszeilentool, um die Verbindung zu überprüfen, wie im folgenden Beispiel.

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

Die ODBC-Treibersignatur überprüfen

Wichtig

Wir empfehlen, die RPM-Signatur des Athena ODBC-Treibers zu überprüfen, bevor Sie ihn auf Ihrem Computer installieren.

Gehen Sie wie folgt vor, um die Signatur des RPM-Pakets des Athena ODBC-Treibers zu überprüfen:

  1. Bereiten Sie die Vorlagen vor

    Bereiten Sie die Befehle mit dem entsprechenden öffentlichen Schlüssel, der RPM-Signatur und dem entsprechenden Zugriffslink zu den RPM-Skripten vor, die in Amazon S3-Buckets gehostet werden. Sie müssen Folgendes auf Ihr Gerät herunterladen.

  2. Laden Sie den Athena ODBC-Treiber, den öffentlichen Schlüssel und die Athena ODBC RPM-Signatur auf Ihr Gerät herunter.

  3. Führen Sie den folgenden Befehl aus, um die ODBC-Treibersignatur zu überprüfen:

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

    Wenn die Überprüfung erfolgreich abgeschlossen wurde, wird eine Meldung ähnlich wie Verified OK angezeigt. Das bedeutet, dass Sie jetzt mit der Installation des Athena ODBC-Treibers fortfahren können.

    Wenn es mit einer Meldung Verification Failure fehlschlägt, bedeutet dies, dass die Signatur auf RPM manipuliert wurde. Stellen Sie sicher, dass alle drei in Schritt 1 genannten Dateien vorhanden sind, dass die Pfade korrekt angegeben sind und dass die Dateien seit dem Herunterladen nicht geändert wurden, und wiederholen Sie dann den Überprüfungsvorgang.