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.
# Prise en main du pilote ODBC 2.x
Utilisez les informations de cette section pour commencer à utiliser le pilote ODBC 2.x Amazon Athena. Le pilote est pris en charge sur les systèmes d’exploitation Windows, Linux et macOS.
**Topics**
+ [Windows](odbc-v2-driver-getting-started-windows.md)
+ [Linux](odbc-v2-driver-getting-started-linux.md)
+ [macOS](odbc-v2-driver-getting-started-macos.md)
# Windows
L’accès à Amazon Athena depuis un ordinateur client Windows requiert le pilote ODBC Amazon Athena.
## Configuration système requise Windows
Installez le pilote ODBC Amazon Athena sur les ordinateurs clients qui accèderont directement aux bases de données Amazon Athena au lieu d'utiliser un navigateur Web.
Le système Windows que vous utilisez doit remplir les conditions suivantes :
+ Vous avez des droits d'administrateur
+ L’un des systèmes d’exploitation suivants :
+ Windows 11, 10 ou 8.1
+ Windows Server 2019, 2016 ou 2012
+ Architecture de processeur prise en charge : x86\$164 (64 bits)
+ Au moins 100 Mo d'espace disque disponible
+ [Microsoft Visual C\$1\$1 Redistributable pour Visual Studio ](https://visualstudio.microsoft.com/downloads/#microsoft-visual-c-redistributable-for-visual-studio-2022) pour Windows 64 bits installé.
## Installation du pilote ODBC Amazon Athena
**Pour télécharger et installer le pilote ODBC Amazon Athena pour Windows**
1. [Téléchargez](odbc-v2-driver.md#odbc-v2-driver-download) le fichier d'installation `AmazonAthenaODBC-2.x.x.x.msi`.
1. Lancez le fichier d'installation, puis choisissez **Suivant**.
1. Pour accepter les conditions du contrat de licence, cochez la case, puis choisissez **Suivant**.
1. Pour modifier l'emplacement d'installation, choisissez **Parcourir**, naviguez jusqu'au dossier souhaité, puis cliquez sur **OK**.
1. Pour accepter l'emplacement d'installation, choisissez **Suivant**.
1. Choisissez **Installer**.
1. Une fois l'installation terminée, choisissez **Terminer**.
## Méthodes de définition des options de configuration du pilote
Pour contrôler le comportement du pilote ODBC Amazon Athena sous Windows, vous pouvez définir les options de configuration du pilote de la manière suivante :
+ Dans le programme **Administrateur de sources de données ODBC** lorsque vous configurez un nom de source de données (DSN).
+ En ajoutant ou en modifiant les clés de registre Windows à l'emplacement suivant :
```
HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\YOUR_DSN_NAME
```
+ En définissant les options du pilote dans la chaîne de connexion lorsque vous vous connectez par programmation.
## Configuration du nom d'une source de données sous Windows
Après avoir téléchargé et installé le pilote ODBC, vous devez ajouter une entrée de nom de source de données (DSN) à l'ordinateur client ou à l'instance Amazon EC2. Les outils clients SQL utilisent cette source de données pour se connecter à la base de données Amazon Athena et l'interroger.
**Pour créer une entrée DSN système**
1. Dans le menu **Démarrer** de Windows, cliquez avec le bouton droit sur **Sources de données ODBC (64 bits)**, puis choisissez **Plus**, **Exécuter en tant qu'administrateur**.
1. Dans l'**administrateur de sources de données ODBC**, choisissez l'onglet **Pilotes**.
1. Dans la colonne **Nom**, vérifiez qu'**Amazon Athena ODBC (x64)** est présent.
1. Effectuez l’une des actions suivantes :
+ Pour configurer le pilote pour tous les utilisateurs de l'ordinateur, sélectionnez l'onglet **DSN système**. Étant donné que les applications qui utilisent un compte différent pour charger les données risquent de ne pas être en mesure de détecter l'utilisateur DSNs d'un autre compte, nous recommandons l'option de configuration DSN du système.
**Note**
L'utilisation de l'option **DSN système** nécessite des privilèges administratifs.
+ Pour configurer le pilote uniquement pour votre compte utilisateur, choisissez l'onglet **DSN utilisateur**.
1. Choisissez **Ajouter**. La boîte de dialogue **Créer une nouvelle source de données** s'ouvre.
1. Choisissez **Pilote ODBC Amazon Athena (x64)**, puis cliquez sur **Terminer**.
1. Dans la boîte de dialogue **Configuration ODBC Amazon Athena**, entrez les informations suivantes. Pour des informations détaillées sur ces options, consultez [Principaux paramètres de connexion ODBC 2.x](odbc-v2-driver-main-connection-parameters.md).
+ Dans **Nom de la source de données**, entrez le nom que vous souhaitez utiliser pour identifier la source de données.
+ Dans **Description**, entrez une description qui vous permettra d'identifier rapidement la source de données.
+ Dans **Région**, entrez le nom de la Région AWS dans laquelle vous utiliserez Athena (par exemple, ** us-west-1**).
+ Dans **Catalogue**, entrez le nom du catalogue Amazon Athena. La valeur par défaut est **AwsDataCatalog**, qui est utilisée par AWS Glue.
+ Dans **Base de données**, entrez le nom de la base de données Amazon Athena. La valeur par défaut est **Par défaut**.
+ Dans **Groupe de travail**, entrez le nom du groupe de travail Amazon Athena. La valeur par défaut est **primaire**.
+ Dans **Emplacement de sortie S3**, entrez l’emplacement d’Amazon S3 auquel les résultats des requêtes seront stockés (par exemple, **s3://amzn-s3-demo-bucket/**).
+ (Facultatif) Dans **Options de chiffrement**, choisissez une option de chiffrement. La valeur par défaut est `NOT_SET`.
+ (Facultatif) Dans **Clé KMS**, choisissez une clé KMS de chiffrement si nécessaire.
1. Pour spécifier les options de configuration pour l'authentification IAM, choisissez **Options d'authentification**.
1. Entrez les informations suivantes :
+ Dans **Type d'authentification**, choisissez **Informations d'identification IAM**. Il s’agit de l’option par défaut. Pour plus d'informations sur les types d'authentification disponibles, consultez [Options d'authentification](odbc-v2-driver-authentication-options.md).
+ Entrez un nom d'utilisateur dans **Nom d'utilisateur**.
+ Dans **Mot de passe**, entrez un mot de passe.
+ Pour le **jeton de session**, entrez un jeton de session si vous souhaitez utiliser des AWS informations d'identification temporaires. Pour plus d'informations sur les informations d'identification temporaires, consultez la section [Utilisation des informations d'identification temporaires avec les AWS ressources](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) du *Guide de l'utilisateur IAM*.
1. Choisissez **OK**.
1. Dans le bas de la boîte de dialogue **Configuration ODBC Amazon Athena**, choisissez **Test**. Si l'ordinateur client se connecte correctement à Amazon Athena, le champ **Test de connexion** indique **Connexion réussie**. Dans le cas contraire, la boîte indique **Échec de la connexion** avec les informations d'erreur correspondantes.
1. Pour fermer le test de connexion, cliquez sur **OK**. La source de données que vous avez créée apparaît désormais dans la liste des noms de source de données.
## Utilisation d'une connexion sans DSN sous Windows
Vous pouvez utiliser une connexion sans DSN pour vous connecter à une base de données sans nom de source de données (DSN). L'exemple suivant montre une chaîne de connexion pour le pilote ODBC Amazon Athena (x64) qui se connecte à Amazon Athena.
```
DRIVER={Amazon Athena ODBC (x64)};Catalog=AwsDataCatalog;AwsRegion=us-west-1;Schema=test_schema;S3OutputLocation=
s3://amzn-s3-demo-bucket/;AuthenticationType=IAM Credentials;UID=YOUR_UID;PWD=YOUR_PWD;
```
# Linux
L’accès à Amazon Athena depuis un ordinateur client Linux requiert le pilote ODBC Amazon Athena.
## Configuration système requise pour Linux
Chaque ordinateur client Linux sur lequel vous installez le pilote doit disposer au minimum des éléments suivants.
+ Accès racine
+ L’une des distributions Linux suivantes :
+ Red Hat Enterprise Linux (RHEL) 7 8
+ CentOS 7 or 8.
+ 100 Mo d’espace disque disponible
+ [unixODBC](https://www.unixodbc.org/) 2.3.1 ou version ultérieure
+ [Bibliothèque C GNU](https://www.gnu.org/software/libc/) (glibc) 2.26 ou version ultérieure.
## Installation du connecteur de données ODBC sous Linux
Suivez la procédure ci-dessous pour installer le pilote ODBC Amazon Athena sur un système d’exploitation Linux.
**Pour installer le pilote ODBC Amazon Athena sous Linux**
1. Entrez l'une des commandes suivantes :
```
sudo rpm -Uvh AmazonAthenaODBC-2.X.Y.Z.rpm
```
or
```
sudo yum --nogpgcheck localinstall AmazonAthenaODBC-2.X.Y.Z.rpm
```
1. Une fois l’opération terminée, entrez l’une des commandes suivantes pour vérifier que le pilote est installé :
+
```
yum list | grep amazon-athena-odbc-driver
```
Sortie :
```
amazon-athena-odbc-driver.x86_64 2.0.2.1-1.amzn2int installed
```
+
```
rpm -qa | grep amazon
```
Sortie :
```
amazon-athena-odbc-driver-2.0.2.1-1.amzn2int.x86_64
```
## Configuration d’un nom de source de données sous Linux
Une fois le pilote installé, vous trouverez les exemples de fichiers `.odbc.ini` et `.odbcinst.ini` à l’emplacement suivant :
+ `/opt/athena/odbc/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 d’unixODBC.
**Pour spécifier l’emplacement des fichiers ODBC `.ini` à l’aide d’unixODBC**
1. Définissez `ODBCINI` sur le chemin complet et le nom du fichier `odbc.ini`, comme illustré dans l’exemple suivant.
```
export ODBCINI=/opt/athena/odbc/ini/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/athena/odbc/ini
```
1. Entrez la commande suivante pour vérifier que vous utilisez le gestionnaire de pilotes unixODBC et les fichiers `odbc*.ini` appropriés :
```
username % odbcinst -j
```
Exemple de sortie.
```
unixODBC 2.3.1
DRIVERS............: /opt/athena/odbc/ini/odbcinst.ini
SYSTEM DATA SOURCES: /opt/athena/odbc/ini/odbc.ini
FILE DATA SOURCES..: /opt/athena/odbc/ini/ODBCDataSources
USER DATA SOURCES..: /opt/athena/odbc/ini/odbc.ini
SQLULEN Size.......: 8
SQLLEN Size........: 8
SQLSETPOSIROW Size.: 8
```
1. 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 des sources de données (DSNs). 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 # To enable ODBC driver logs, set this to 1.
UseAwsLogger=0 # To enable AWS-SDK logs, set this to 1.
LogPath=/opt/athena/odbc/logs/ # Path to store the log files. Permissions to the location are required.
[athena_odbc_test]
Driver=/opt/athena/odbc/lib/libathena-odbc.so
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/athena/odbc/lib/libathena-odbc.so
Setup=/opt/athena/odbc/lib/libathena-odbc.so
```
1. Après avoir installé et configuré le pilote ODBC Amazon Athena, utilisez l’outil de ligne de commande unixODBC `isql` pour vérifier la connexion, comme dans l’exemple suivant.
```
username % isql -v "athena_odbc_test"
+---------------------------------------+
| Connected! |
| |
| sql-statement |
| help [tablename] |
| quit |
| |
+---------------------------------------+
SQL>
```
## Vérification de la signature du pilote ODBC
**Important**
Il est recommandé de vérifier la signature du RPM du pilote ODBC Athena avant de l’installer sur votre ordinateur.
Procédez comme suit pour vérifier la signature du package RPM du pilote ODBC Athena :
1. **Préparez les modèles**
Préparez les commandes avec la clé publique appropriée, la signature du RPM et le lien d’accès correspondant aux scripts RPM hébergés dans des compartiments Amazon S3. Téléchargez les éléments suivants sur votre appareil :
+ [Pilote ODBC Athena](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/AmazonAthenaODBC-2.1.0.0.rpm)
+ [Clé publique](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/public_key.pem)
+ [Signature du RPM du pilote ODBC Athena](https://downloads.athena.us-east-1.amazonaws.com/drivers/ODBC/v2.1.0.0/Linux/signature.bin)
1. Téléchargez le pilote ODBC Athena, la clé publique et la signature du RPM du pilote ODBC Athena sur votre appareil.
1. Exécutez la commande suivante pour vérifier la signature du pilote ODBC :
```
openssl dgst -sha256 -verify public_key.pem -signature signature.bin AmazonAthenaODBC-2.1.0.0.rpm
```
Si la vérification aboutit, un message semblable à `Verified OK` s’affiche. Cela signifie que vous pouvez procéder à l’installation du pilote ODBC Athena.
Si la vérification échoue et génère un message `Verification Failure`, cela signifie que la signature du RPM a été falsifiée. Vérifiez que les trois fichiers mentionnés à l’étape 1 sont présents, que les chemins sont correctement spécifiés et que les fichiers n’ont pas été modifiés depuis le téléchargement, puis relancez la vérification.
# 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](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
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-cliquez sur le fichier `.pkg`.
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 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
```
1. 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
```
1. 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 des sources de données (DSNs). 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/
```
1. 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
```
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.0.2.1 (Amazon Athena ODBC Driver)
SQL>
```