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
<a name="odbc-v2-driver-getting-started-macos"></a>

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

## Configuration requise pour macOS
<a name="odbc-v2-driver-getting-started-macos-macos-system-requirements"></a>

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](https://www.iodbc.org/dataspace/doc/iodbc/wiki/iodbcWiki/WelcomeVisitors) 3.52.16 ou version ultérieure

## Installation du connecteur de données ODBC sous macOS
<a name="odbc-v2-driver-getting-started-macos-installing-the-odbc-data-connector-on-macos"></a>

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`.

1. Double-click le `.pkg` dossier.

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

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

1. Choisissez **Installer**.

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

1. 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
<a name="odbc-v2-driver-getting-started-macos-configuring-a-data-source-name-on-macos"></a>

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'`.example`extension. 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
   ```

1. 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
   ```

1. 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/
   ```

1. 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
   ```

1. 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>
   ```