Mettre à jour un connecteur de source de données - Amazon Athena

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.

Mettre à jour 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. La mise à jour d'un connecteur de source de données inclut les étapes suivantes :

Trouvez 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 GitHub versions 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 le fichier GitHub URL 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 year.week_of_year.iteration_of_week de la Fédération Athena Query

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

Rechercher et noter les 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 à 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.

    Choisissez le menu d'expansion.
  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.

    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.

    Notez le nom de la fonction.
  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 le repo sans serveur-your_application_namepage, 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.

Trouvez 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 le SAMmodèle.

  3. Recherchez CodeUri.

  4. Dans le champ Clé ci-dessous 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 CloudWatch connecteur :

    applications-AthenaCloudwatchConnector-versions-2021.42.1/15151159...
  5. Enregistrez la valeur pour year.week_of_year.iteration_of_week (par exemple, 2021.42.1). Il s'agit de la version correspondant à votre connecteur.

Déployez 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 à 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.

    Choisissez le menu d'expansion.
  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.

    Page du connecteur dans la AWS Lambda console.
  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 AthenaCatalogNamechamp. 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 reconnais que cette application crée des IAM rôles et des politiques de ressources 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.

    La mise à jour du connecteur est terminée.
  11. Pour confirmer le nouveau numéro de version, vous pouvez développer le SAMmodèle comme précédemment CodeUri, rechercher 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.