Belangrijkste concepten en functies

De Toolkit voor uitbreidbaarheid introduceert een reeks mogelijkheden die zijn ontworpen om uw gegevenstoepassing zo eenvoudig mogelijk in infrastructuur te brengen. Met deze functies kunnen ontwikkelaars uitgebreide, geïntegreerde ervaringen bouwen met minimale inspanning. Met de Extensibility Toolkit kunt u eenvoudig toegang krijgen tot Fabric-API's rechtstreeks vanuit de front-end, de itemdefinitie (status) binnen Fabric behouden, een gestandaardiseerde stroom voor het maken van items gebruiken en profiteren van verbeterde beveiliging en interoperabiliteit via iFrame-ontspanning en openbare API-ondersteuning. Daarnaast stroomlijnt het uw ontwikkelingslevenscyclus met ingebouwde CI/CD-ondersteuning, waardoor het eenvoudiger is om implementatie en testen te automatiseren. De volgende secties bieden een overzicht van de belangrijkste functionaliteit en richtlijnen voor het opnemen ervan in uw workloads.

Standaard itemaanmaakervaring

Het maken van items wordt gestandaardiseerd via een specifieke Fabric-bedieningselement waarmee gebruikers door het proces worden geleid. Met dit besturingselement kunnen gebruikers de werkruimte selecteren waarin het item is gemaakt, vertrouwelijkheidslabels toewijzen en andere relevante instellingen configureren. Door deze gestandaardiseerde ervaring te gebruiken, hoeft u de complexiteit van het maken van items niet meer zelf af te handelen of u zorgen te maken over toekomstige wijzigingen in het proces. Bovendien zorgt deze aanpak ervoor dat het maken van items rechtstreeks binnen uw workloadpagina wordt weergegeven, waardoor een naadloze en geïntegreerde gebruikerservaring wordt geboden.

Gebruik de handleiding Een item maken om te begrijpen hoe deze kan worden geïmplementeerd.

Ondersteuning voor front-end-API

Met de Extensibility Toolkit kunt u een Microsoft Entra On-Behalf-Of (OBO)-token rechtstreeks in uw front-endtoepassing verkrijgen, waardoor beveiligde toegang tot elke met Entra beveiligde API mogelijk is. Met deze mogelijkheid kunt u diep integreren met Microsoft Fabric-services. U kunt bijvoorbeeld gegevens lezen en opslaan in OneLake, andere Fabric-items maken en gebruiken of Spark gebruiken als verwerkingsengine via de Livey-API's. Zie de Microsoft Entra-documentatie, OneLake-documentatie, Fabric REST API's en Spark in Fabric voor meer informatie.

Gebruik de handleiding How to acquire Microsoft Entra Token om te begrijpen hoe het kan worden geïmplementeerd. Gebruik ook de handleiding Over het openen van Fabric-API's om te begrijpen hoe u met Fabric kunt werken.

Itemdefinitie (toestand) opslaan in Fabric

Met deze functie kunt u de metagegevens van uw item, zoals itemconfiguratie en andere relevante informatie, rechtstreeks in OneLake opslaan in een verborgen map die niet zichtbaar is voor eindgebruikers. De gegevens worden opgeslagen met dezelfde indeling die wordt toegepast door openbare API's en CI/CD-processen, waardoor consistentie en interoperabiliteit tussen verschillende integratiepunten wordt gegarandeerd. In de volgende secties vindt u meer informatie over de indeling en het gebruik ervan met openbare API's en CI/CD.

Gebruik de Itemdefinitie opslaan om te begrijpen hoe deze kan worden geïmplementeerd.

Wat moet u opslaan in de definitie

Denk na over de status als iets dat alle informatie bevat die nodig is om een item te herstellen als het ergens anders wordt verwijderd of gekopieerd. Dit omvat niet de gegevens zelf, die zijn opgeslagen in OneLake (zie Itemgegevens opslaan in OneLake).

Hier volgen enkele praktische voorbeelden:

• Notitieblokitem: De status slaat de code, celvolgorde en metagegevens van het notitieblok op, zoals welke uitvoeringsengine (bijvoorbeeld Spark, SQL) moet worden gebruikt. De werkelijke gegevens die door het notebook worden verwerkt, worden niet opgeslagen in de status.
• Item van bestandseditor: de status slaat de bestandsinhoud niet zelf op, maar slaat in plaats daarvan de editorconfiguratie op, zoals kleurenschema, instellingen voor automatisch aanvullen, tekengrootte en andere gebruikersvoorkeuren.
• Installatie- of orchestratoritem: als uw item andere onderdelen (zoals databases of rekenresources) installeert of in richt, moet de status verwijzingen (ID's, URI's) bevatten naar de items die zijn gemaakt. Hierdoor kan uw workload de status controleren of ze later beheren.

Door u te richten op configuratie, metagegevens en verwijzingen, zorgt u ervoor dat de status van uw item draagbaar, lichtgewicht en eenvoudig te herstellen of te migreren is.

Itemgegevens opslaan in OneLake

Elk item wordt geleverd met een eigen Onelake-itemmap waar ontwikkelaars gestructureerde en ongestructureerde gegevens kunnen opslaan. Net als bij een Lakehouse heeft het item een tabelmap waarin gegevens kunnen worden opgeslagen in Delta- of Iceberg-indeling en een map Bestanden waarin ongestructureerde gegevens kunnen worden opgeslagen.

Gebruik de instructies voor het opslaan van gegevens in item om te begrijpen hoe deze kunnen worden geïmplementeerd.

Snelkoppelingsgegevens

Aangezien elk item zijn eigen Onelake-map heeft, kunnen ze ook met snelkoppelingen werken. Ontwikkelaars van de openbare Shortcut API kunnen verschillende snelkoppelingstypen maken van of naar hun item om deel te nemen aan de belofte van één enkele kopie van OneLake.

Gebruik de snelkoppelingen maken om te begrijpen hoe deze kan worden geïmplementeerd.

API-ondersteuning voor CRUD-items

Gebruikers kunnen items met inhoud maken, bijwerken en verwijderen met behulp van de standaard REST API's voor fabricitems. Dankzij deze automatische activering is het veel eenvoudiger om te integreren met workloaditems op dezelfde manier als met core Fabric-items, wat de interoperabiliteit stroomlijnt en de inspanning vermindert die nodig is om robuuste integraties te bouwen.

CI/CD-ondersteuning

Opmerking

CI/CD-ondersteuning voor de Extensibility Toolkit is momenteel in ontwikkeling. De hieronder beschreven functies zijn geplande mogelijkheden en kunnen vóór de release veranderen.

CI/CD-ondersteuning voor alle items is een van de hoogste vragen van klanten. Met deze functie kunnen alle items out-of-the-box deelnemen aan CICD, zonder dat u specifieke logica of bewerkingen hoeft te implementeren. Dit betekent dat u implementatie, testen en updates voor uw workloads kunt automatiseren met behulp van standaard Azure Pipelines en hulpprogramma's. De itemindeling en API's zijn ontworpen om volledig compatibel te zijn met CI/CD-processen en zorgen voor een consistente en betrouwbare ervaring in omgevingen. Zie de Fabric CICD-documentatie voor meer informatie over integratie met CI/CD.

API voor CRUD-meldingen van items

Opmerking

Momenteel is de ondersteuning voor de CRUD Notification API voor de Extensibility Toolkit in ontwikkeling. De hieronder beschreven functies zijn geplande mogelijkheden en kunnen vóór de release veranderen.

Er zijn gevallen waarin uw workload moet deelnemen aan de ITEM CRUD-gebeurtenissen. Aangezien items direct op het platform worden gecreëerd via de UX, Public APIs of CI/CD, hebben werkbelastingseigenaren geen controle over wanneer een nieuw item via deze toegangspunten wordt aangemaakt. Standaard slaan items hun status op in Fabric en hoeven ze niet op de hoogte te worden gesteld van de wijziging van het item. Toch zijn er enkele gevallen waarin workloads moeten deelnemen aan het CRUD-proces. Dit is vooral het geval als infrastructuur voor items moet worden ingericht of geconfigureerd (bijvoorbeeld Databases). Voor deze scenario's kunnen partners een Crud-meldings-API implementeren die Fabric aanroept op elke gebeurtenis. In dit scenario moet de workloadontwikkelaar ervoor zorgen dat de API bereikbaar is, omdat fabric-bewerkingen anders mislukken.

Fabric-scheduler

Opmerking

Fabric Scheduler-ondersteuning voor de Extensibility Toolkit is momenteel in ontwikkeling. De hieronder beschreven functies zijn geplande mogelijkheden en kunnen vóór de release veranderen.

Fabric ondersteunt taakplanning voor werkbelastingen. Met deze functie kunnen ontwikkelaars workloads bouwen die op de hoogte worden gesteld, zelfs als de gebruiker zich niet voor de UX bevindt en actie ondernemen op basis van de taak die moet worden uitgevoerd (bijvoorbeeld gegevens kopiëren in Onelake). Partners moeten een API implementeren en hun workload configureren om deel te nemen aan deze functionaliteit.

iFrame ontspanning

Ontwikkelaars kunnen meer iFrame-kenmerken aanvragen om geavanceerde scenario's mogelijk te maken, zoals het downloaden van bestanden of het openen van externe websites. Met deze functie kan uw workload gebruikers vragen om expliciete toestemming te geven voordat acties worden uitgevoerd waarvoor uitgebreidere browsermogelijkheden nodig zijn, zoals het initiëren van downloads of het verbinden van gebruikers met externe API's met behulp van hun huidige Fabric-referenties. Door deze vereisten op te geven in uw workloadconfiguratie, zorgt u ervoor dat gebruikers op de hoogte worden gesteld en de benodigde machtigingen kunnen verlenen, waardoor naadloze integratie met externe systemen mogelijk is en tegelijkertijd beveiliging en gebruikersvertrouwen behouden blijft.

Gebruik de Handleiding voor het ontspannen van de iFrame om te begrijpen hoe dit kan worden geïmplementeerd.

Opmerking

Als u deze functie inschakelt, moeten gebruikers extra toestemming verlenen aan Microsoft Entra om het ontspanningsbereik mogelijk te maken, naast het standaard Fabric-bereik dat vereist is voor de basiswerklastfunctionaliteit.

Functiebeperkingen

Privélink

Alle workloads worden geblokkeerd voor verbruik en ontwikkeling als Private Link is ingeschakeld op tenant- of werkruimteniveau.