View a markdown version of this page

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

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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. Double-click die .pkg Datei.

  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 athena.odbc

    Wenn der Treiber erfolgreich installiert wurde, sieht die Ausgabe wie folgt aus.

    com.amazon.athena.odbc.Runtime
com.amazon.athena.odbc.Documentation

Konfiguration eines Datenquellennamens unter macOS

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

  • /opt/amazon/athena-odbc/share/athena-odbc/

Kopieren Sie die Beispieldateien in ein Konfigurationsverzeichnis und entfernen Sie die .example Erweiterung. Verwenden Sie diese Dateien als Ausgangspunkt für die Konfiguration des Amazon Athena ODBC-Treibers und des Datenquellennamens (DSN).

sudo mkdir -p /opt/amazon/athena-odbc/etc/athena-odbc
sudo cp /opt/amazon/athena-odbc/share/athena-odbc/odbc.ini.example /opt/amazon/athena-odbc/etc/athena-odbc/odbc.ini
sudo cp /opt/amazon/athena-odbc/share/athena-odbc/odbcinst.ini.example /opt/amazon/athena-odbc/etc/athena-odbc/odbcinst.ini
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.

Um ODBC anzugeben .ini Dateispeicherorte mit dem iODBC-Treibermanager

  1. Legen Sie ODBCINI auf den vollständigen Pfad und Dateinamen der odbc.ini-Datei fest, wie im folgenden Beispiel.

    export ODBCINI=/opt/amazon/athena-odbc/etc/athena-odbc/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/amazon/athena-odbc/etc/athena-odbc

  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/amazon/athena-odbc/logs/ # Path to store the log files. Permissions to the location are required.

[athena_odbc_test]
Description=Amazon Athena ODBC (x64)
Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.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)]
Driver=/opt/amazon/athena-odbc/lib/libathenaodbc.dylib
Setup=/opt/amazon/athena-odbc/lib/libathenaodbc.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.x.y.z (Amazon Athena ODBC Driver) 

SQL>