Pilote JDBC 2.x d'Athena - Amazon Athena

Pilote JDBC 2.x d'Athena

Vous pouvez utiliser une connexion JDBC pour connecter Athena à des outils de business intelligence et à d'autres applications, telles que SQL workbench. Pour ce faire, utilisez les liens Amazon S3 de cette page pour télécharger, installer et configurer le pilote Athena JDBC 2.x. Pour obtenir des informations sur la création de l'URL de connexion JDBC, consultez le document téléchargeable Guide d'installation et de configuration du pilote JDBC. Pour plus d'informations sur les autorisations, voir Contrôle d’accès via des connexions JDBC et ODBC. Pour envoyer des commentaires concernant le pilote JDBC, envoyez un e-mail à athena-feedback@amazon.com. À partir de la version 2.0.24, deux versions du pilote sont disponibles : l'une qui inclut le kit SDK AWS, et l'autre qui ne l'inclut pas.

Important

Lorsque vous utilisez le pilote JDBC, veillez à respecter les exigences suivantes :

  • Ouvrez le port 444 – Conservez ouvert le port 444, utilisé par Athena pour diffuser les résultats de requête, pour le trafic sortant. Lorsque vous utilisez un point de terminaison PrivateLink pour vous connecter à Athena, assurez-vous que le groupe de sécurité attaché au point de terminaison PrivateLink est ouvert pour le trafic entrant sur le port 444. Si le port 444 est bloqué, il est possible que vous receviez le message d'erreur [Simba][AthenaJDBC](100123) Une erreur s'est produite. Exception during column initialization (Exception pendant l'initialisation de la colonne.

  • Politique athena:GetQueryResultsStream – Ajoutez l’action de politIque athena:GetQueryResultsStream pour les principaux IAM qui utilisent le pilote JDBC. Cette action de politique n'est pas exposée directement avec l'API. Elle est uniquement utilisée avec les pilotes ODBC et JDBC dans le cadre de la prise en charge des résultats de streaming. Pour un exemple de politique, consultez AWSPolitique gérée par  : AWSQuicksightAthenaAccess.

  • Utilisation du pilote JDBC pour plusieurs catalogues de données – Pour utiliser le pilote JDBC pour plusieurs catalogues de données avec Athena (par exemple, lors de l'utilisation d'un métastore Hive externe ou de requêtes fédérées), incluez MetadataRetrievalMethod=ProxyAPI dans votre chaîne de connexion JDBC.

  • Pilotes 4.1 – À partir de 2023, la prise en charge des pilotes pour JDBC version 4.1 sera interrompue. Aucune autre mise à jour ne sera publiée. Si vous utilisez un pilote JDBC 4.1, la migration vers le pilote 4.2 est fortement recommandée.

Pilote JDBC 2.x avec kit SDK AWS

La version 2.2.2 du pilote JDBC est conforme à la norme de données JDBC API 4.2 et nécessite le kit JDK 8.0 ou une version ultérieure. Pour plus d'informations sur la vérification de la version de l'Environnement d'exécution Java (JRE) que vous utilisez, consultez la documentation Java.

Utilisez le lien suivant pour télécharger le fichier .jar du pilote JDBC 4.2.

Le téléchargement du fichier .zip suivant contient le fichier .jar pour JDBC 4.2 et inclut le kit SDK AWS et la documentation, les notes de mise à jour, les licences et les accords qui l'accompagnent.

Pilote JDBC 2.x sans kit SDK AWS

La version 2.2.2 du pilote JDBC est conforme à la norme de données JDBC API 4.2 et nécessite le kit JDK 8.0 ou une version ultérieure. Pour plus d'informations sur la vérification de la version de l'Environnement d'exécution Java (JRE) que vous utilisez, consultez la documentation Java.

Cliquez sur le lien suivant pour télécharger le fichier .jar du pilote JDBC 4.2 sans le kit SDK AWS.

Le téléchargement du fichier .zip suivant contient le fichier .jar pour JDBC 4.2 et la documentation, les notes de mise à jour, les licences et les accords qui l'accompagnent. Il n'inclut pas le kit SDK AWS.

Notes de mise à jour du pilote JDBC 2.x, contrat de licence et mentions légales

Après avoir téléchargé la version dont vous avez besoin, consultez les notes de mise à jour ainsi que le Contrat de licence et les Mentions légales.

Documentation du pilote JDBC 2.x

Téléchargez la documentation suivante pour le pilote :