macOS - Amazon Athena
macOS-SystemanforderungenInstallation des ODBC-Datenconnectors unter macOSKonfiguration eines Datenquellennamens unter macOS

macOS

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

macOS-Systemanforderungen

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

  • Für macOS-Version 14 oder höher.

  • 100 MB Speicherplatz verfügbar haben.

  • Für Version 3.52.16 oder höher von iODBC.

Installation des ODBC-Datenconnectors unter macOS

Gehen Sie wie folgt vor, um den Amazon Athena ODBC-Treiber für macOS-Betriebssysteme herunterzuladen und zu installieren.

Wie Sie den ODBC-Treiber von Amazon Athena für macOS herunterzuladen und installieren

  1. Laden Sie die .pkg-Paketdatei herunter.

  2. Doppelklicken Sie auf die Datei .pkg.

  3. Zum Installieren des Treibers folgen Sie den Anweisungen im Assisten.

  4. Klicken Sie in der Lizenzvereinbarungs-Seite auf Weiter und wählen Sie dann Zustimmen aus.

  5. Wählen Sie Installieren aus.

  6. Nach abgeschlossener Installation wählen Sie Beenden aus.

  7. Geben Sie den folgenden Befehl ein, um zu überprüfen, ob der Treiber installiert ist:

    > pkgutil --pkgs | grep athenaodbc

    Je nach System kann die Ausgabe wie eine der folgenden aussehen.

    com.amazon.athenaodbc-x86_64.Config
com.amazon.athenaodbc-x86_64.Driver

    oder

    com.amazon.athenaodbc-arm64.Config
com.amazon.athenaodbc-arm64.Driver

Konfiguration eines Datenquellennamens unter macOS

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

  • Computer mit Intel-Prozessoren: /opt/athena/odbc/x86_64/ini/

  • Computer mit ARM-Prozessoren: /opt/athena/odbc/arm64/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 dem iODBC-Treibermanager anzugeben.

So geben Sie ODBC .ini-Dateispeicherorte mit dem iODBC-Treibermanager an

  1. Legen Sie ODBCINI auf den vollständigen Pfad und Dateinamen der odbc.ini-Datei fest.

    • Verwenden Sie die folgende Syntax für macOS-Computer mit Intel-Prozessoren.

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

    • Verwenden Sie die folgende Syntax für macOS-Computer mit ARM-Prozessoren.

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

  2. Legen Sie ODBCSYSINI auf den vollständigen Pfad und Dateinamen der odbcinst.ini-Datei fest.

    • Verwenden Sie die folgende Syntax für macOS-Computer mit Intel-Prozessoren.

      export ODBCSYSINI=/opt/athena/odbc/x86_64/ini/odbcinst.ini

    • Verwenden Sie die folgende Syntax für macOS-Computer mit ARM-Prozessoren.

      export ODBCSYSINI=/opt/athena/odbc/arm64/ini/odbcinst.ini

  3. 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             # set to 1 to enable ODBC driver logs
UseAwsLogger=0         # set to 1 to enable AWS-SDK logs
LogPath=/opt/athena/odbc/logs/ # Path to store the log files. Permissions to the location are required. 

[athena_odbc_test]
Description=Amazon Athena ODBC (x64)
# For ARM:
Driver=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib
# For Intel:
# Driver=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib
AwsRegion=us-west-1
Workgroup=primary
Catalog=AwsDataCatalog
Schema=default
AuthenticationType=IAM Credentials
UID=
PWD=
S3OutputLocation=s3://amzn-s3-demo-bucket/

  4. Konfigurieren Sie die odbcinst.ini Datei, wie im folgenden Beispiel.

    [ODBC Drivers]
Amazon Athena ODBC (x64)=Installed 

[Amazon Athena ODBC (x64)]
# For ARM:
Driver=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib
Setup=/opt/athena/odbc/arm64/lib/libathena-odbc-arm64.dylib
# For Intel:
# Driver=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib
# Setup=/opt/athena/odbc/x86_64/lib/libathena-odbc-x86_64.dylib

  5. Nachdem Sie den Amazon Athena ODBC-Treiber installiert und konfiguriert haben, verwenden Sie das iodbctest-Befehlszeilentool, um die Verbindung zu überprüfen, wie im folgenden Beispiel.

    username@ % iodbctest
iODBC Demonstration program
This program shows an interactive SQL processor
Driver Manager: 03.52.1623.0502 

Enter ODBC connect string (? shows list): ? 

DSN                              | Driver
------------------------------------------------------------------------------
athena_odbc_test                 | Amazon Athena ODBC (x64) 

Enter ODBC connect string (? shows list): DSN=athena_odbc_test;
Driver: 2.0.2.1 (Amazon Athena ODBC Driver) 

SQL>