View a markdown version of this page

macOS - Amazon Athena
Requisiti del sistema macOSInstallazione del connettore dati ODBC su macOSConfigurazione del nome di un'origine dati in macOS

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

macOS

Se si desidera utilizzare un computer client macOS per accedere ad Amazon Athena, è necessario il driver Amazon Athena ODBC.

Requisiti del sistema macOS

Ciascun computer macOS su cui è stato installato il driver deve soddisfare i seguenti requisiti:

  • Utilizzare macOS versione 14 o successiva.

  • Avere 100 MB di spazio su disco disponibile.

  • Utilizza la versione 3.52.16 o successiva di iODBC.

Installazione del connettore dati ODBC su macOS

Utilizzare la procedura seguente per scaricare e installare il driver ODBC di Amazon Athena per i sistemi operativi macOS.

Per scaricare e installare il driver Amazon Athena ODBC per macOS

  1. Scarica il file del pacchetto .pkg.

  2. Double-click il .pkg fascicolo.

  3. Seguire i passaggi nella procedura guidata per installare il driver.

  4. Nella pagina Contratto di licenza, premere Continua, quindi scegliere Accetto.

  5. Scegli Installa.

  6. Al termine dell'installazione, seleziona Termina.

  7. Inserire il seguente comando per verificare il driver sia installato:

    > pkgutil --pkgs | grep athena.odbc

    Se il driver è stato installato correttamente, l'output è simile al seguente.

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

Configurazione del nome di un'origine dati in macOS

Dopo aver installato il driver, è possibile trovare file di esempio odbc.ini.example e odbcinst.ini.example nella seguente posizione:

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

Copiate i file di esempio in una directory di configurazione e rimuovete l'.exampleestensione. Utilizza questi file come punto di partenza per configurare il driver ODBC e il nome dell'origine dati (DSN) di Amazon Athena.

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
Nota

Per impostazione predefinita, i gestori del driver ODBC utilizzano versioni nascoste dei file di configurazione .odbc.ini e .odbcinst.ini, che si trovano nella directory principale.

Per specificare il percorso dei file odbc.ini e odbcinst.ini utilizzando il driver manager IODBC, effettuare le seguenti operazioni.

Per specificare ODBC .ini posizioni dei file utilizzando il driver manager IODBC

  1. Impostare ODBCINI sul percorso completo e sul nome file del file odbc.ini, come nell’esempio seguente.

    export ODBCINI=/opt/amazon/athena-odbc/etc/athena-odbc/odbc.ini

  2. Imposta ODBCSYSINI sul percorso completo della directory che contiene il file odbcinst.ini, come nell’esempio seguente.

    export ODBCSYSINI=/opt/amazon/athena-odbc/etc/athena-odbc

  3. Quando ci si connette all’archivio dati utilizzando un nome origine dati (DSN), configurare il file odbc.ini per definire il nome dell’origine dati (DSN). Imposta le proprietà nel file odbc.ini per creare un DSN che specifica le informazioni di connessione per i data store, come nell’esempio seguente.

    [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. Configura il file odbcinst.ini, come nell’esempio seguente.

    [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. Dopo aver installato e configurato il driver Amazon Athena ODBC, utilizza lo strumento da iodbctest riga di comando per verificare la connessione, come nell’esempio seguente.

    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>