API REST publique pour le pipeline de données Microsoft Fabric (aperçu)
Article
Important
L'API Microsoft Fabric pour Data Factory est actuellement en avant-première publique. Certaines informations portent sur un produit en préversion susceptible d’être substantiellement modifié avant sa publication. Microsoft ne donne aucune garantie, expresse ou implicite, concernant les informations fournies ici.
Dans Data Factory pour Microsoft Fabric, les API consistent uniquement en des opérations CRUD pour les pipelines et les flux de données. Actuellement, seuls les pipelines de données sont pris en charge. Les API de flux de données seront publiées ultérieurement. D’autres domaines communs aux projets d’intégration de données se trouvent dans des API distinctes : les planifications, la surveillance et les connexions ont leurs propres API dans Fabric. La principale documentation de référence en ligne pour les API REST de Microsoft Fabric se trouve dans Références API REST Microsoft Fabric. Reportez-vous également à l’API des éléments de base et au planificateur de tâches.
Montage d’API publiques
Les API publiques de montage sont désormais disponibles. Ces API vous permettent d’intégrer et d’accéder en toute transparence à diverses sources de données publiques au sein de vos pipelines de données.
Utilisez MSAL.Net pour acquérir un jeton Microsoft Entra ID pour le service Fabric avec les portées suivantes : Workspace.ReadWrite.All, Item.ReadWrite.All. Pour plus d’informations sur l’acquisition de jetons avec MSAL.Net, consultez Acquisition de jetons – Bibliothèque d’authentification Microsoft pour .NET.
Collez l’ID de l’application (client) que vous avez copié précédemment et collez-le dans la variable ClientId.
Option 2 : Utilisation du portail Fabric
Connectez-vous au portail Fabric pour le client que vous voulez tester et appuyez sur F12 pour accéder au mode développeur du navigateur. Dans la console, exécutez :
powerBIAccessToken
Copiez le jeton et collez-le dans la variable ClientId.
Définition d’élément avec charge utile encodée en base64
La documentation indique qu’il n’y a que deux propriétés requises : displayName et type. Actuellement, Workload-DI ne prend pas en charge la création sans définition. Le correctif pour cette exigence erronée est en cours de déploiement. Pour l’instant, vous pouvez envoyer la même définition par défaut que celle utilisée par l’interface utilisateur Fabric : ‘{"properties":{"activities":[]}}’
Aucun corps n’est renvoyé pour l’instant, mais l’identifiant de la tâche devrait être renvoyé. Pendant l’aperçu, il peut être trouvé dans les en-têtes renvoyés, dans la propriété « Location ».
POST https://api.fabric.microsoft.com/v1/workspaces/<your WS Id>/items/<pipeline id>/jobs/instances/<job ID>/cancel
Réponse 202 : (Aucun corps)
Notes
Après avoir annulé une tâche, vous pouvez en vérifier l’état soit en appelant Get item job instance, soit en consultant Afficher l’historique des exécutions dans l’interface utilisateur Fabric.
Interroger les exécutions d'activité
Exemple :
POST https://api.fabric.microsoft.com/v1/workspaces/<your WS Id>/datapipelines/pipelineruns/<job id>/queryactivityruns