Concepts et fonctionnalités clés

Le kit de ressources d’extensibilité introduit une suite de fonctionnalités conçues pour rendre votre application de données plus simple que possible. Ces fonctionnalités permettent aux développeurs de créer des expériences enrichies et intégrées avec un effort minimal. Avec le Kit de ressources d’extensibilité, vous pouvez facilement accéder aux API Fabric directement à partir du front-end, conserver la définition d’élément (état) dans Fabric, utiliser un flux de création d’élément standardisé et tirer parti d’une sécurité et d’une interopérabilité améliorées par le biais de la relaxation iFrame et de la prise en charge des API publiques. En outre, il simplifie votre cycle de vie de développement avec la prise en charge ci/CD intégrée, ce qui facilite l’automatisation du déploiement et des tests. Les sections suivantes fournissent une vue d’ensemble des principales fonctionnalités et des instructions sur la façon de les incorporer dans vos charges de travail.

Expérience de création d’élément standard

La création d’éléments est standardisée par le biais d’un contrôle Fabric dédié qui guide les utilisateurs dans le processus. Ce contrôle permet aux utilisateurs de sélectionner l’espace de travail où l’élément est créé, d’attribuer des étiquettes de confidentialité et de configurer d’autres paramètres pertinents. En utilisant cette expérience standardisée, vous n’avez plus besoin de gérer les complexités de la création d’éléments vous-même ou vous soucier des modifications futures apportées au processus. En outre, cette approche permet à la création d’éléments d’être exposée directement dans votre page de charge de travail, ce qui offre une expérience utilisateur transparente et intégrée.

Utilisez le guide pratique pour créer un guide d’élément pour comprendre comment il peut être implémenté.

Prise en charge de l’API frontend

Avec le Kit de ressources d’extensibilité, vous pouvez obtenir un jeton Microsoft Entra On-Behalf-Of (OBO) directement dans votre application frontale, ce qui permet un accès sécurisé à n’importe quelle API protégée par Entra. Cette fonctionnalité vous permet d’intégrer profondément les services Microsoft Fabric, par exemple, vous pouvez lire et stocker des données dans OneLake, créer et interagir avec d’autres éléments Fabric, ou utiliser Spark comme moteur de traitement via les API Livey. Pour plus d’informations, consultez la documentation Microsoft Entra, la documentation OneLake, les API REST Fabric et Spark dans Fabric.

Utilisez le guide d’acquisition du jeton Microsoft Entra pour comprendre comment il peut être implémenté. Utilisez également le guide d’accès aux API Fabric pour comprendre comment interagir avec Fabric.

Stockage de la définition d’élément (état) dans Fabric

Cette fonctionnalité vous permet de stocker les métadonnées de votre élément, telles que la configuration d’élément et d’autres informations pertinentes, directement dans OneLake dans un dossier masqué qui n’est pas visible pour les utilisateurs finaux. Les données sont stockées à l’aide du même format appliqué par les API publiques et les processus CI/CD, ce qui garantit la cohérence et l’interopérabilité entre différents points d’intégration. Les détails sur le format et son utilisation avec les API publiques et CI/CD sont abordés dans les sections suivantes.

Utilisez la définition how to store Item pour comprendre comment elle peut être implémentée.

Éléments à stocker dans la définition

Considérez l’état comme quelque chose qui contient toutes les informations nécessaires pour restaurer un élément s’il est supprimé ou copié ailleurs. Cela n’inclut pas les données elles-mêmes, qui sont stockées dans OneLake (voir Stockage des données d’élément dans OneLake).

Voici quelques exemples pratiques :

• Élément de bloc-notes : l’état stocke le code, l’ordre des cellules et les métadonnées du bloc-notes, comme le moteur d’exécution (par exemple, Spark, SQL) à utiliser. Les données réelles traitées par le notebook ne sont pas stockées dans l’état.
• Élément de l’éditeur de fichiers : l’état ne stocke pas le contenu du fichier eux-mêmes, mais stocke plutôt la configuration de l’éditeur, comme le jeu de couleurs, les paramètres de saisie semi-automatique, la taille de police et d’autres préférences utilisateur.
• Programme d’installation ou élément d’orchestrateur : si votre élément installe ou provisionne d’autres composants (comme des bases de données ou des ressources de calcul), l’état doit contenir des références (ID, URI) aux éléments qu’il a créés. Cela permet à votre charge de travail de vérifier leur état ou de les gérer ultérieurement.

En mettant l’accent sur la configuration, les métadonnées et les références, vous assurez que l’état de votre élément est portable, léger et facile à restaurer ou à migrer.

Stockage des données d’élément dans OneLake

Chaque élément est fourni avec son propre dossier d’éléments Onelake où les développeurs peuvent stocker des données structurées et non structurées. À l’instar d’un Lakehouse , l’élément possède un dossier Table dans lequel les données peuvent être stockées au format Delta ou Iceberg et un dossier Files où les données non structurées peuvent être stockées.

Utilisez la procédure de stockage des données dans Item pour comprendre comment elles peuvent être implémentées.

Données de raccourci

Comme chaque élément a son propre dossier Onelake, il peut également fonctionner avec les raccourcis. Via la charge de travail publique de l’API Raccourci, les développeurs peuvent créer différents types de raccourcis à partir ou vers leur élément pour participer à la promesse de copie unique de OneLake.

Utilisez la procédure de création de raccourcis pour comprendre comment elle peut être implémentée.

Prise en charge de l’API d’objet CRUD

Les utilisateurs peuvent créer, mettre à jour et supprimer des éléments en utilisant les API Rest Fabric Item standard. Cette activation automatique facilite grandement l’intégration avec les éléments de charge de travail de la même façon que les éléments principaux de Fabric, rationalisant l'interopérabilité et réduisant l’effort nécessaire pour créer des intégrations robustes.

Prise en charge CI/CD

Le support CI/CD pour tous les éléments est l'une des demandes les plus demandées des clients. Avec cette fonctionnalité, tous les éléments participent à CICD dès le départ, sans avoir besoin de mettre en œuvre une logique ou des opérations spécifiques. Cela signifie que vous pouvez automatiser le déploiement, le test et les mises à jour de vos charges de travail à l’aide d’Azure Pipelines et d’outils standard. Le format des éléments et les API sont conçus pour être entièrement compatibles avec les processus CI/CD, garantissant une expérience cohérente et fiable à travers les différents environnements. Pour plus d’informations sur l’intégration à CI/CD, consultez la documentation Fabric CICD.

API de notification des opérations CRUD sur les items

Il existe des cas où votre charge de travail doit participer aux événements CRUD d’élément. À mesure que les éléments sont créés directement sur la plateforme via l’expérience utilisateur, les API publiques ou les propriétaires de charge de travail CI/CD ne sont pas en contrôle lorsqu’un nouvel élément est créé sur ces points d’entrée. Par défaut, les éléments stockent leur état dans Fabric et n’ont pas besoin d’être informés de la modification de leur élément. Toutefois, il existe certains cas où les charges de travail ont besoin de participer au flux CRUD. Cela est principalement le cas si l’infrastructure pour les éléments doit être provisionnée ou configurée (par exemple, bases de données). Pour ces scénarios, nous permettons aux partenaires d’implémenter une API de notification Crud que Fabric appelle sur chaque événement. Dans ce scénario, le développeur de l'application doit s'assurer que son API est accessible, sinon les opérations du Fabric échouent.

Planificateur de Fabric

Fabric prend en charge la planification des travaux pour les charges de travail. Cette fonctionnalité permet aux développeurs de créer des charges de travail qui sont averties même si l’utilisateur n’est pas devant l’expérience utilisateur et agit en fonction du travail qui doit être exécuté (par exemple, copier des données dans Onelake). Les partenaires doivent implémenter une API et configurer leur charge de travail pour participer à cette fonctionnalité.

Détente des restrictions iFrame

Les développeurs peuvent demander davantage d’attributs iFrame pour activer des scénarios avancés tels que les téléchargements de fichiers ou l’ouverture de sites web externes. Cette fonctionnalité permet à votre charge de travail d’inviter les utilisateurs à donner un consentement explicite avant d’effectuer des actions nécessitant des fonctionnalités de navigateur plus larges, telles que le lancement de téléchargements ou la connexion d’utilisateurs à des API externes à l’aide de leurs informations d’identification Fabric actuelles. En spécifiant ces exigences dans la configuration de votre charge de travail, vous assurez que les utilisateurs sont informés et peuvent accorder les autorisations nécessaires, ce qui permet une intégration transparente avec des systèmes externes tout en conservant la sécurité et la confiance des utilisateurs.

Utilisez l’application How to relax the iFrame pour comprendre comment elle peut être implémentée.

Limitations des fonctionnalités

Lien privé

Toutes les charges de travail sont bloquées pour la consommation et le développement si Private Link est activé au niveau du locataire ou de l’espace de travail.