Windows - Amazon Athena

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_64 (64 bits)

  • Au moins 100 Mo d'espace disque disponible

  • Microsoft Visual C++ Redistributable pour Visual Studio  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 le fichier d'installation AmazonAthenaODBC-2.x.x.x.msi.

  2. Lancez le fichier d'installation, puis choisissez Suivant.

  3. Pour accepter les conditions du contrat de licence, cochez la case, puis choisissez Suivant.

  4. Pour modifier l'emplacement d'installation, choisissez Parcourir, naviguez jusqu'au dossier souhaité, puis cliquez sur OK.

  5. Pour accepter l'emplacement d'installation, choisissez Suivant.

  6. Choisissez Installer.

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

  2. Dans l'administrateur de sources de données ODBC, choisissez l'onglet Pilotes.

  3. Dans la colonne Nom, vérifiez qu'Amazon Athena ODBC (x64) est présent.

  4. Effectuez l’une des actions suivantes :

    • Pour configurer le pilote pour tous les utilisateurs de l'ordinateur, sélectionnez l'onglet DSN système. Les applications qui utilisent un compte différent pour charger les données peuvent ne pas être en mesure de détecter les DSN utilisateur à partir d'un autre compte, nous recommandons l'option de configuration DSN 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.

  5. Choisissez Ajouter. La boîte de dialogue Créer une nouvelle source de données s'ouvre.

  6. Choisissez Pilote ODBC Amazon Athena (x64), puis cliquez sur Terminer.

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

    • 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é 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.

  8. Pour spécifier les options de configuration pour l'authentification IAM, choisissez Options d'authentification.

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

    • Entrez un nom d'utilisateur dans Nom d'utilisateur.

    • Dans Mot de passe, entrez un mot de passe.

    • Dans Jeton de session, entrez un jeton de session si vous souhaitez utiliser des informations d'identification AWS temporaires. Pour plus d'informations sur les informations d'identification temporaires, consultez Utilisation d'informations d'identification temporaires avec des ressources AWS dans le Guide de l'utilisateur IAM.

  10. Choisissez OK.

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

  12. 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;