macOS - Amazon Athena
Configuration requise pour macOSInstallation du connecteur de données ODBC sous macOSConfiguration d’un nom de source de données sous macOS

macOS

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

Configuration requise pour macOS

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

  • macOS 14 ou une version ultérieure.

  • 100 Mo d’espace disque disponible

  • iODBC 3.52.16 ou version ultérieure

Installation du connecteur de données ODBC sous macOS

Suivez la procédure ci-dessous pour télécharger et installer le pilote ODBC Amazon Athena pour les systèmes d’exploitation macOS.

Pour télécharger et installer le pilote ODBC Amazon Athena pour macOS

  1. Téléchargez le fichier de package .pkg.

  2. Double-cliquez sur le fichier .pkg.

  3. Suivez les étapes de l’assistant pour installer le pilote.

  4. Sur la page Contrat de licence, appuyez sur Continuer, puis sélectionnez Accepter.

  5. Choisissez Installer.

  6. Une fois l'installation terminée, choisissez Terminer.

  7. Vérifiez à l’aide de la commande suivante que le pilote est installé :

    > pkgutil --pkgs | grep athenaodbc

    Selon le système, la sortie peut se présenter comme suit :

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

    or

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

Configuration d’un nom de source de données sous macOS

Une fois le pilote installé, vous trouverez les exemples de fichiers .odbc.ini et .odbcinst.ini aux emplacements suivants :

  • Ordinateurs équipés de processeurs Intel : /opt/athena/odbc/x86_64/ini/

  • Ordinateurs équipés de processeurs ARM : /opt/athena/odbc/arm64/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 du gestionnaire de pilotes iODBC.

Pour spécifier l’emplacement des fichiers ODBC .ini à l’aide du gestionnaire de pilotes iODBC

  1. Définissez ODBCINI vers le chemin complet et le nom du fichier odbc.ini.

    • Pour les ordinateurs macOS équipés de processeurs Intel, utilisez la syntaxe suivante.

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

    • Pour les ordinateurs macOS équipés de processeurs ARM, utilisez la syntaxe suivante.

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

  2. Définissez ODBCSYSINI vers le chemin complet et le nom du fichier odbcinst.ini.

    • Pour les ordinateurs macOS équipés de processeurs Intel, utilisez la syntaxe suivante.

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

    • Pour les ordinateurs macOS équipés de processeurs ARM, utilisez la syntaxe suivante.

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

  3. 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             # 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. Configurez le fichier odbcinst.ini comme indiqué ci-dessous.

    [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. Après avoir installé et configuré le pilote ODBC Amazon Athena, utilisez l’outil de ligne de commande iodbctest pour vérifier la connexion, comme dans l’exemple suivant.

    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>