View a markdown version of this page

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

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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-click le .pkg dossier.

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

    Si le pilote est correctement installé, le résultat ressemble à ce qui suit.

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

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

Une fois le pilote installé, vous trouverez les exemples de fichiers odbc.ini.example et odbcinst.ini.example à l’emplacement suivant :

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

Copiez les fichiers d'exemple dans un répertoire de configuration et supprimez l'.exampleextension. Utilisez ces fichiers comme point de départ pour configurer le pilote ODBC Amazon Athena et le nom de la source de données (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
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 ODBC .ini emplacements de fichiers à l'aide du gestionnaire de pilotes iODBC

  1. Définissez ODBCINI sur le chemin complet et le nom du fichier odbc.ini, comme illustré dans l’exemple suivant.

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

  2. Définissez ODBCSYSINI sur le chemin complet du répertoire qui contient le fichier odbcinst.ini, comme illustré dans l’exemple suivant.

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

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

    [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. 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.x.y.z (Amazon Athena ODBC Driver) 

SQL>