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

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.

Prérequis

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

• Un compte locataire avec un abonnement actif. Créez un compte gratuitement.
• Un espace de travail est créé.

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.

   

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

   

   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 et une connexion existante dans la liste déroulante Connexion, ou créez une connexion et spécifiez-en les détails de configuration.

   

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.

   

   Remarque

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

Utilisation de la passerelle de données sur site ou de réseau virtuel

1. Lorsque vous créez votre connexion, vous pouvez maintenant choisir d’utiliser une passerelle de données locale (OPDG) ou une passerelle de données de réseau virtuel. Pour obtenir des conseils sur la création et la configuration de votre OPDG, consultez comment créer une passerelle de données locale

2. Si vous souhaitez utiliser une passerelle de réseau virtuel, reportez-vous à la création d’une passerelle de données de réseau virtuel.

3. Une fois que vous avez correctement créé et configuré votre passerelle, elle doit apparaître sous la liste déroulante passerelle de données dans la boîte de dialogue de connexion

   

4. Après avoir choisi ou créé votre passerelle de connexion et de données, complétez les champs requis restants, ajoutez les en-têtes requis ou définissez les paramètres avancés. L’activité Web prend en charge les méthodes GET, POST, PUT, DELETE et PATCH.

5. 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.

Contenu connexe

• Guide pratique pour superviser les exécutions de pipelines