macOS

Si vous souhaitez utiliser un ordinateur client macOS pour accéder à Amazon Athena, le pilote ODBC Amazon Athena est requis.

Configuration système requise pour macOS

Chaque ordinateur macOS sur lequel vous installez le pilote doit répondre aux exigences suivantes.

• Utilisez macOS version 14 ou ultérieure.

• Disposer de 100 Mo d'espace disque disponible.

• Utilisez la version 3.52.16 ou ultérieure d'iODBC.

Installation du connecteur de données ODBC sur 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 .pkg du package.

2. Double-cliquez sur le fichier .pkg.

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

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

5. Choisissez Installer.

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

7. Entrez la commande suivante pour vérifier que le pilote est installé :

   > pkgutil --pkgs | grep athenaodbc

   En fonction de votre système, la sortie peut ressembler à l'une des suivantes.

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

   or

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

Configuration du nom d'une source de données sous macOS

Une fois le pilote installé, vous pouvez trouver des exemples .odbc.ini et .odbcinst.ini des fichiers aux emplacements suivants :

• Ordinateurs à processeur Intel : /opt/athena/odbc/x86_64/ini/

• Ordinateurs à processeur ARM : /opt/athena/odbc/arm64/ini/

Utilisez les .ini fichiers de cet emplacement 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 situés dans le répertoire de base.

Pour spécifier le chemin d'accès aux .odbcinst.ini fichiers .odbc.ini et à l'aide du gestionnaire de pilotes iODBC, effectuez les opérations suivantes.

Pour spécifier l'emplacement des .ini fichiers ODBC à 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 utiliser un nom de source de données (DSN) pour vous connecter à votre magasin de données, configurez le odbc.ini fichier pour définir les noms de source de données (DSN). Définissez les propriétés du odbc.ini fichier pour créer un DSN qui spécifie les informations de connexion pour votre magasin de données, comme 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://DOC-EXAMPLE-BUCKET/

4. Configurez le odbcinst.ini fichier, comme dans l'exemple suivant.

   [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 iodbctest ligne de commande 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>