Freigeben über

Wichtige Konzepte und Features

Das Extensibility-Toolkit bietet eine Reihe von Funktionen und Möglichkeiten, die darauf ausgelegt sind, Ihre Datenanwendung so einfach wie möglich in das Fabric zu integrieren. Mit diesen Features können Entwickler umfangreiche, integrierte Erfahrungen mit minimalem Aufwand erstellen. Mit dem Extensibility Toolkit können Sie ganz einfach direkt über das Frontend auf Fabric-APIs zugreifen, die Elementdefinition (Status) in Fabric beibehalten, einen standardisierten Elementerstellungsablauf verwenden und die Vorteile verbesserter Sicherheit und Interoperabilität über iFrame-Entspannung und öffentliche API-Unterstützung nutzen. Darüber hinaus optimiert sie Ihren Entwicklungslebenszyklus mit integrierter CI/CD-Unterstützung und erleichtert die Automatisierung von Bereitstellung und Tests. In den folgenden Abschnitten finden Sie eine Übersicht über die Wichtigsten Funktionen und Anleitungen zur Integration dieser Funktionen in Ihre Workloads.

Standard-Element-Erstellungserfahrung

Die Elementerstellung wird über ein dediziertes Fabric-Steuerelement standardisiert, das Benutzer durch den Prozess führt. Mit diesem Steuerelement können Benutzer den Arbeitsbereich auswählen, in dem das Element erstellt wird, Vertraulichkeitsbezeichnungen zuweisen und andere relevante Einstellungen konfigurieren. Durch die Verwendung dieser standardisierten Oberfläche müssen Sie nicht mehr die Komplexität der Elementerstellung selbst behandeln oder sich gedanken über zukünftige Änderungen am Prozess machen. Darüber hinaus kann mit diesem Ansatz die Elementerstellung direkt auf Ihrer Workloadseite angezeigt werden, sodass eine nahtlose und integrierte Benutzeroberfläche entsteht.

Verwenden Sie die Anleitung zur Erstellung eines Elements, um zu verstehen, wie es implementiert werden kann.

Front-End-API-Unterstützung

Mit dem Extensibility Toolkit können Sie ein Microsoft Entra On-Behalf-Of (OBO)-Token direkt in Ihrer Front-End-Anwendung abrufen und so sicheren Zugriff auf jede entra-geschützte API ermöglichen. Mit dieser Funktion können Sie tief in Microsoft Fabric-Dienste integriert werden, z. B. daten in OneLake lesen und speichern, mit anderen Fabric-Elementen erstellen und interagieren oder Spark als Verarbeitungsmodul über die Livey-APIs verwenden. Weitere Informationen finden Sie in der Microsoft Entra-Dokumentation, oneLake-Dokumentation, Fabric-REST-APIs und Spark in Fabric.

Verwenden Sie den Leitfaden zum Abrufen von Microsoft Entra-Token , um zu verstehen, wie es implementiert werden kann. Verwenden Sie außerdem das Handbuch für den Zugriff auf Fabric-APIs , um zu verstehen, wie Sie mit Fabric interagieren können.

Speichern der Elementdefinition (Status) in Fabric

Mit diesem Feature können Sie die Metadaten Ihres Elements , z. B. elementkonfiguration und andere relevante Informationen, direkt in OneLake in einem ausgeblendeten Ordner speichern, der für Endbenutzer nicht sichtbar ist. Die Daten werden mit demselben Format gespeichert, das von öffentlichen APIs und CI/CD-Prozessen angewendet wird, um Konsistenz und Interoperabilität über verschiedene Integrationspunkte hinweg sicherzustellen. Details zum Format und deren Verwendung mit öffentlichen APIs und CI/CD werden in den folgenden Abschnitten erläutert.

Verwenden Sie die Definition zum Speichern von Elementen , um zu verstehen, wie sie implementiert werden kann.

Was in der Definition gespeichert werden soll

Denken Sie an den Zustand als etwas, das alle zum Wiederherstellen eines Elements erforderlichen Informationen enthält, wenn es gelöscht oder an anderer Stelle kopiert wird. Dies schließt nicht die Daten selbst ein, die in OneLake gespeichert werden (siehe Speichern von Elementdaten in OneLake).

Hier sind einige praktische Beispiele:

  • Notebook-Element: Der Zustand des Notebooks speichert dessen Code, Zellreihenfolge und Metadaten, wie beispielsweise welche Ausführungs-Engine (z. B. Spark, SQL) verwendet werden soll. Die tatsächlich vom Notizbuch verarbeiteten Daten werden nicht im Speicher gespeichert.
  • Datei-Editor-Element: Der Zustand speichert die Dateiinhalte nicht selbst, sondern speichert stattdessen die Editorkonfiguration , z. B. Farbschema, AutoVervollständigen-Einstellungen, Schriftgrad und andere Benutzereinstellungen.
  • Installationsprogramm oder Orchestratorelement: Wenn Ihr Element andere Komponenten (z. B. Datenbanken oder Computeressourcen) installiert oder bereitgestellt, sollte der Zustand Verweise (IDs, URIs) auf die erstellten Elemente enthalten. Auf diese Weise kann Ihre Workload ihren Status überprüfen oder diese später verwalten.

Indem Sie sich auf die Konfiguration, Metadaten und Verweise konzentrieren, stellen Sie sicher, dass der Zustand des Elements portabel, ressourcensparend und leicht wiederherstellbar oder migrierbar ist.

Speichern von Elementdaten in OneLake

Jedes Element enthält einen eigenen Onelake-Elementordner, in dem Entwickler strukturierte und unstrukturierte Daten speichern können. Ähnlich wie bei einem Lakehouse verfügt das Element über einen Tabellenordner, in dem Daten im Delta- oder Iceberg-Format gespeichert werden können, und einen Ordner "Dateien", in dem unstrukturierte Daten gespeichert werden können.

Verwenden Sie die Vorgehensweise zum Speichern von Daten im Element , um zu verstehen, wie sie implementiert werden kann.

Verknüpfungsdaten

Da jedes Element seinen eigenen Onelake-Ordner hat, können sie auch mit Verknüpfungen arbeiten. Über die Workload der öffentlichen Verknüpfungs-API können Entwickler unterschiedliche Verknüpfungstypen von oder in ihr Element erstellen, um an der Zusage für einzelne Kopien von OneLake teilzunehmen.

Verwenden Sie die Vorgehensweise zum Erstellen von Verknüpfungen , um zu verstehen, wie sie implementiert werden kann.

CRUD-Element-API-Unterstützung

Benutzer können Elemente mit Inhalten mithilfe der standardmäßigen Fabric Item Rest-APIs erstellen, aktualisieren und löschen. Diese automatische Aktivierung erleichtert die Integration von Workloadelementen auf die gleiche Weise wie die Kern-Fabric-Elemente, das Optimieren der Interoperabilität und die Reduzierung des Aufwands für die Erstellung robuster Integrationen.

CI/CD-Unterstützung

Hinweis

CI/CD-Unterstützung für das Extensibility Toolkit wird derzeit entwickelt. Die unten beschriebenen Features sind geplante Funktionen und können vor der Veröffentlichung geändert werden.

CI/CD-Unterstützung für alle Artikel ist eine der höchsten Anfragen von Kunden. Mit diesem Feature können Alle Elemente sofort an CICD teilnehmen, ohne bestimmte Logik oder Vorgänge implementieren zu müssen. Dies bedeutet, dass Sie bereitstellungs-, test- und updates für Ihre Workloads mithilfe standardmäßiger Azure-Pipelines und -Tools automatisieren können. Das Elementformat und die APIs sind so konzipiert, dass sie vollständig mit CI/CD-Prozessen kompatibel sind, um eine konsistente und zuverlässige Erfahrung über verschiedene Umgebungen hinweg sicherzustellen. Weitere Informationen zur Integration mit CI/CD finden Sie in der Fabric CICD-Dokumentation.

CRUD-Benachrichtigungs-API für Elemente

Hinweis

Die CRUD-Benachrichtigungs-API-Unterstützung für das Extensibility Toolkit wird derzeit entwickelt. Die unten beschriebenen Features sind geplante Funktionen und können vor der Veröffentlichung geändert werden.

Es gibt Fälle, in denen Ihre Workload an den CruD-Ereignissen des Elements teilnehmen muss. Da Elemente direkt über die UX auf der Plattform erstellt werden, sind öffentliche APIs oder CI/CD-Workloadbesitzer nicht in der Kontrolle, wenn ein neues Element über diese Einstiegspunkte erstellt wird. Standardmäßig speichern Elemente ihren Zustand in Fabric und müssen nicht über die Änderung des Elements informiert werden. Dennoch gibt es einige Fälle, in denen Workloads an dem CRUD-Fluss teilnehmen müssen. Dies ist hauptsächlich der Fall, wenn Infrastruktur für Elemente bereitgestellt oder konfiguriert werden muss (z. B. Datenbanken). Für diese Szenarien ermöglichen wir Partnern die Implementierung einer Crud-Benachrichtigungs-API, die Fabric für jedes Ereignis aufruft. In diesem Szenario müssen Workload-Entwickler sicherstellen, dass ihre API erreichbar ist, da andernfalls Fabric-Vorgänge fehlschlagen.

Fabric-Scheduler

Hinweis

Die Fabric Scheduler-Unterstützung für das Extensibility Toolkit wird derzeit entwickelt. Die unten beschriebenen Features sind geplante Funktionen und können vor der Veröffentlichung geändert werden.

Fabric unterstützt das Job-Scheduling für Workloads (Arbeitslasten). Mit diesem Feature können Entwickler Workloads erstellen, die benachrichtigt werden, auch wenn der Benutzer nicht vor der UX steht und basierend auf dem Auftrag handelt, der ausgeführt werden soll (z. B. Daten in Onelake kopieren). Partner müssen eine API implementieren und ihre Arbeitsauslastung so konfigurieren, dass sie an dieser Funktionalität teilnimmt.

iFrame-Entspannung

Entwickler können weitere iFrame-Attribute anfordern, um erweiterte Szenarien wie Dateidownloads oder öffnen externe Websites zu ermöglichen. Mit diesem Feature kann Ihre Workload Benutzer zur expliziten Zustimmung auffordern, bevor Sie Aktionen ausführen, die umfassendere Browserfunktionen erfordern, z. B. das Initiieren von Downloads oder das Verbinden von Benutzern mit externen APIs mithilfe ihrer aktuellen Fabric-Anmeldeinformationen. Indem Sie diese Anforderungen in Ihrer Workloadkonfiguration angeben, stellen Sie sicher, dass Die Benutzer informiert sind und die erforderlichen Berechtigungen erteilen können, wodurch die nahtlose Integration in externe Systeme ermöglicht wird und gleichzeitig die Sicherheit und die Benutzervertrauensstellung beibehalten werden.

Verwenden Sie das How to relax the iFrame , um zu verstehen, wie es implementiert werden kann.

Hinweis

Wenn Sie dieses Feature aktivieren, müssen Benutzer mehr Microsoft Entra-Zustimmung für den Entspannungsbereich gewähren, und zwar über den Standard-Fabric-Bereich hinaus, der für grundlegende Workloadfunktionen erforderlich ist.

Featurebeschränkungen

Alle Workloads werden für den Verbrauch und die Entwicklung blockiert, wenn Private Link auf Ebene des Mandanten oder Arbeitsbereichs aktiviert ist.

  • Last updated on