Partager via

Utiliser l’activité Web pour appeler des API REST dans des pipelines

  • Article

L’activité Web peut être utilisée pour appeler un point de terminaison REST personnalisé à partir d’un pipeline Azure Data Factory ou Synapse. Vous pouvez transmettre des jeux de données et des services liés que l’activité peut utiliser et auxquels elle peut accéder.

Remarque

La taille maximale de la charge utile de la réponse en sortie est de 4 Mo.

Prérequis

Pour commencer, vous devez remplir les conditions préalables suivantes :

Ajouter une activité Web à un pipeline avec l’interface utilisateur

Pour utiliser une activité Web dans un pipeline, effectuez les étapes suivantes :

Créer l’activité

  1. Créez un pipeline dans votre espace de travail.

  2. Recherchez l’activité Web dans le volet Activités du pipeline et sélectionnez-la pour l’ajouter au canevas du pipeline.

    Capture d’écran de l’interface utilisateur fabric avec le volet Activités et l’activité web mis en surbrillance.

  3. Sélectionnez la nouvelle activité Web sur le canevas si elle n’est pas déjà sélectionnée.

    Capture d’écran montrant l’onglet Paramètres généraux de l’activité Web.

    Remarque

    L’activité Web peut simplement apparaître sous forme d’icône dans la barre d’outils, comme indiqué dans l’image précédente, si la résolution de l’écran ne permet pas d’écrire entièrement son nom.

Reportez-vous aux instructions relatives aux paramètres Général pour configurer l’onglet Paramètres Général .

Paramètres de l’activité Web

  1. Sélectionnez l’onglet Paramètres , sélectionnez une connexion existante dans la liste déroulante Connexion , ou créez une connexion, puis spécifiez ses détails de configuration.

    Capture d’écran montrant l’onglet de paramètres d’activité Recherche en surbrillance et où choisir une nouvelle connexion.

  2. Quand vous choisissez + Nouveau pour créer une connexion, la boîte de dialogue de création de la connexion s’affiche. Celle-ci vous permet de fournir l’URL de base et les informations d’identification pour vous connecter.

    Capture d’écran montrant la boîte de dialogue nouvelle connexion pour l’activité web.

    Remarque

    Le nom de connexion peut comporter au maximum 80 caractères.

  3. Après avoir choisi ou créé votre connexion, renseignez les champs obligatoires restants, ajoutez les en-têtes requis ou définissez des paramètres avancés. L’activité Web prend en charge les méthodes GET, POST, PUT, DELETE et PATCH.

Enregistrer et exécuter ou planifier le pipeline

En général, vous utilisez la sortie de l’activité Web avec d’autres activités, mais une fois configurée, vous pouvez également l’exécuter directement sans autres activités. Si vous l’exécutez pour appeler une API REST qui effectue une action et que vous n’avez pas besoin d’une sortie de l’activité, votre pipeline peut aussi contenir uniquement l’activité Web. Pour exécuter l’activité, basculez vers l’onglet Accueil en haut de l’éditeur de pipeline et sélectionnez le bouton Enregistrer pour enregistrer votre pipeline. Sélectionnez Exécuter pour l'exécuter directement ou Planifier pour le planifier. Vous pouvez également afficher l'historique d'exécution ici ou configurer d'autres paramètres.

Capture d'écran montrant l'onglet Accueil dans l'éditeur de pipeline avec le nom de l'onglet, les boutons Enregistrer, Exécuter et Planifier en surbrillance.

Contenu connexe