Invoquer une API REST pour récupérer les données du trafic routier - Cloud

Guide des connecteurs des applications Talend Cloud

Version
Cloud
Language
Français
Product
Talend Cloud
Module
Talend Data Inventory
Talend Data Preparation
Talend Pipeline Designer
Content
Administration et monitoring > Gestion des connexions
Création et développement > Création de Pipelines
Last publication date
2024-03-21

Ce scénario a pour objectif de vous aider à configurer et à utiliser des connecteurs dans un pipeline. Ce scénario doit être adapté en fonction de votre environnement et de votre cas d'utilisation.

Procédure

  1. Cliquez sur Connections (Connexions) > Add connection (Ajouter une connexion).
  2. Dans le panneau qui s'ouvre, sélectionnez le type de connexion à créer.

    Exemple

    REST
  3. Sélectionnez votre moteur dans la liste Engine.
    Remarque :
    • Il est recommandé d'utiliser Moteur distant Gen2 plutôt que Moteur Cloud pour le design pour un traitement avancé des données.
    • Si aucun Moteur distant Gen2 n'a été créé depuis Talend Management Console ou s'il existe mais semble indisponible, ce qui signifie qu'il n'est pas en cours de fonctionnement, vous ne pourrez pas sélectionner de type de connexion (Connection type) dans la liste ou sauvegarder la nouvelle connexion.
    • Les types de connexion disponibles dépendent du moteur sélectionné.
  4. Sélectionnez le type de connexion à créer.
    Sélectionnez REST.
  5. Renseignez les propriétés de la connexion et l'URL du serveur REST à invoquer, comme décrit dans Propriétés REST. Vérifiez la connexion et cliquez sur Add dataset. Dans cet exemple, le service https://opendata.paris.fr/api/datasets/1.0/ listant les données libres de Paris est appelé.
  6. Dans le panneau Add a new dataset, nommez votre jeu de données. Le connecteur REST retourne un JSON avec une entrée de corps parsé.

    Exemple

    Paris road traffic
  7. Renseignez les propriétés requises pour invoquer le service et cliquez sur View sample (Voir l'échantillon) pour voir un aperçu de l'échantillon de données :
    1. Dans le champ Type, sélectionnez Batch, comme vous ne souhaitez invoquer le service qu'une seule fois.
    2. Dans le champ Resource, saisissez search.
    3. Sélectionnez GET dans la liste HTTP method.
    4. Dans le champ Answer body format, sélectionnez Text.
    5. Activez l'option Set URL parameter et ajoutez les paramètres de requête : dataset (paramètre) et referentiel-comptages-routiers (valeur).
  8. Cliquez sur Validate (Valider) pour sauvegarder votre jeu de données.
  9. Répétez l'opération pour ajouter le jeu de données Test à utiliser comme destination dans votre pipeline pour recevoir des logs. Renseignez les propriétés de la connexion comme décrit dans Tester les propriétés de la connexion.
  10. Cliquez sur Add pipeline (Ajouter un pipeline) dans la page Pipelines. Votre nouveau pipeline s’ouvre.
  11. Donnez-lui un nom significatif.

    Exemple

    From Http Rest to Log output - invoke & process
  12. Cliquez sur ADD SOURCE et sélectionnez votre jeu de données source, Paris road traffic dans le panneau qui s'ouvre.
  13. Cliquez sur l'élément ADD DESTINATION dans le pipeline pour ouvrir le panneau vous permettant de sélectionner le jeu de données de sortie dans lequel vos logs de sortie seront stockés.
  14. Dans l'onglet Configuration de la destination, activez l'option Log records to STDOUT afin de capturer les logs dans cette destination de sortie.
  15. Cliquez sur Save (Sauvegarder) pour sauvegarder votre configuration.
  16. Dans la barre d'outils en haut de Talend Cloud Pipeline Designer, cliquez sur le bouton Run (Exécuter) pour ouvrir le panneau vous permettant de sélectionner votre profil d'exécution.
  17. Sélectionnez dans la liste votre profil d'exécution (pour plus d'informations, consultez Profils d'exécution), puis cliquez sur Run (Exécuter) pour exécuter votre pipeline.

Résultats

Votre pipeline est en cours d'exécution. Les données invoquées depuis le service de l'API REST ont été traitées et les logs de sortie sont stockés dans le jeu de données cible défini.