Mise à jour d'un connecteur de source de données

Athena vous recommande de mettre régulièrement à jour les connecteurs de source de données que vous utilisez vers la dernière version afin de tirer parti des nouvelles fonctionnalités et améliorations. Pour commencer, vous devez trouver le dernier numéro de version.

Recherche de la dernière version d'Athena Query Federation

Le dernier numéro de version des connecteurs de source de données Athena correspond à la dernière version d'Athena Query Federation. Dans certains cas, les versions de GitHub peuvent être légèrement plus récentes que celles disponibles sur le AWS Serverless Application Repository (SAR).

Trouver le dernier numéro de version d'Athena Query Federation

1. Consultez l'URL GitHub https://github.com/awslabs/aws-athena-query-federation/releases/latest.

2. Notez le numéro de version dans l'en-tête de la page principale au format suivant :

   Version v année. semaine_de_l_année.itération_de_la_semaine d'Athena Query Federation

   Par exemple, le numéro de version de la Version v2023.8.3 d'Athena Query Federation est 2023.8.3.

Recherche et annotation des noms des ressources

Pour préparer la mise à niveau, vous devez trouver et noter les informations suivantes :

1. Le nom de la fonction Lambda pour le connecteur.

2. Les variables d'environnement de la fonction Lambda.

3. Le nom de l'application Lambda, qui gère la fonction Lambda pour le connecteur.

Pour trouver les noms des ressources dans la console Athena

1. Ouvrez la console Athena à l'adresse https://console.aws.amazon.com/athena/.

2. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche.

   

3. Dans le panneau de navigation, choisissez Sources de données.

4. Dans la colonne Nom de la source de données, choisissez le lien vers la source de données de votre connecteur.

5. Dans la section Détails de la source de données, sous Fonction Lambda, choisissez le lien vers votre fonction Lambda.

   

6. Sur la page Fonctions, dans la colonne Nom de la fonction, notez le nom de la fonction de votre connecteur.

   

7. Choisissez le lien du nom de la fonction.

8. Dans la section Présentation de la fonction, choisissez l'onglet Configuration.

9. Dans le panneau de gauche, choisissez Variables d'environnement.

10. Dans la section Variables d'environnement, notez les clés et leurs valeurs correspondantes.

11. Faites défiler jusqu'en haut de la page.

12. Dans le message Cette fonction appartient à une application. Cliquez ici pour la gérer, sélectionnez le lien Cliquez ici.

13. Sur la page nom_de_votre_application serverlessrepo, notez le nom de votre application sans serverlessrepo. Par exemple, si le nom de l'application est serverlessrepo-DynamoDbTestApp, le nom de votre application est DynamoDbTestApp.

14. Restez sur la page de console Lambda pour votre application, puis suivez les étapes décrites dans la section Recherche de la version du connecteur que vous utilisez.

Recherche de la version du connecteur que vous utilisez

Pour trouver la version du connecteur que vous utilisez, procédez comme suit.

Pour trouver la version du connecteur que vous utilisez

1. Sur la page de console Lambda pour votre application Lambda, choisissez l'onglet Déploiements.

2. Dans l'onglet Déploiements, développez la section Modèle SAM.

3. Recherchez CodeUri.

4. Dans le champ Clé sous CodeUri, recherchez la chaîne suivante :

   applications-connector_name-versions-year.week_of_year.iteration_of_week/hash_number

   L'exemple suivant montre une chaîne pour le connecteur CloudWatch :

   applications-AthenaCloudwatchConnector-versions-2021.42.1/15151159...

5. Enregistrez la valeur pour année.semaine_de_l_année.itération_de_la_semaine (par exemple, 2021.42.1). Il s'agit de la version correspondant à votre connecteur.

Déploiement de la nouvelle version de votre connecteur

Pour déployer une nouvelle version de votre connecteur, procédez comme suit.

Pour déployer une nouvelle version de votre connecteur

1. Ouvrez la console Athena à l'adresse https://console.aws.amazon.com/athena/.

2. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche.

   

3. Dans le panneau de navigation, choisissez Sources de données.

4. À la page Data sources (Sources de données), choisissez Connect data source (Connecter la source de données).

5. Choisissez la source de données que vous souhaitez mettre à niveau, puis sélectionnez Suivant.

6. Dans la section Détails de la connexion, choisissez Créer une fonction Lambda. Cela ouvre la console Lambda dans laquelle vous pourrez déployer votre application mise à jour.

   

7. Comme vous ne créez pas réellement une nouvelle source de données, vous pouvez fermer l'onglet de la console Athena.

8. Sur la page de console Lambda pour le connecteur, effectuez les étapes suivantes :

   1. Assurez-vous d'avoir supprimé le préfixe serverlessrepo- du nom de votre application, puis copiez le nom de l'application dans le champ Nom de l'application.

   2. Copiez le nom de votre fonction Lambda dans le champ AthenaCatalogName. Certains connecteurs appellent ce champ LambdaFunctionName.

   3. Copiez les variables d'environnement que vous avez enregistrées dans les champs correspondants.

9. Sélectionnez l'option Je comprends que cette application crée des rôles IAM personnalisés, puis choisissez Déployer.

10. Pour vérifier que votre application a été mise à jour, sélectionnez l'onglet Déploiements.

    La section Historique de déploiement indique que votre mise à jour est terminée.

    

11. Pour confirmer le nouveau numéro de version, vous pouvez développer la section Modèle SAM comme auparavant, rechercher CodeUri et vérifier le numéro de version du connecteur dans le champ Clé.

Vous pouvez désormais utiliser votre connecteur mis à jour pour créer des requêtes fédérées Athena.