Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Fabric Apps basiert auf dem Rayfin SDK und ermöglicht es Entwicklern, datengesteuerte Anwendungen auf Fabric mit einem einheitlichen Entwicklungsworkflow zu erstellen. Entwickler definieren Datenmodelle in TypeScript, und Fabric Apps generiert automatisch APIs, verarbeitet die Authentifizierung, stellt Hosting bereit und integriert in Fabric Dienste. Fabric Apps unterstützt TypeScript für Datenmodelle, Clientcode und Anwendungslogik. Weitere Informationen finden Sie in der Übersicht über das Rayfin SDK.
Wichtigste Funktionen
Fabric Apps bieten folgende Funktionen:
-
Datenmodelle für APIs – Dekoriere TypeScript-Klassen mit
@entity(),@text(),@uuid()und anderen Dekoratoren. Fabric Apps generiert Datenbankschemas und GraphQL-Endpunkte automatisch. - Serverseitige Funktionen – Führen Sie die TypeScript-Logik auf dem Server aus und rufen Sie sie von Ihrem Frontend über den typisierten Client auf. Greifen Sie auf App-Daten zu, arbeiten Sie mit Geheimnissen und rufen Sie externe APIs auf. Siehe Funktionen in Fabric-Apps verwenden.
- Eigene Daten mit Connectors einbinden – Fügen Sie typisierten Zugriff auf ein bestehendes Lakehouse, Warehouse, eine SQL-Datenbank in Fabric oder ein semantisches Modell hinzu. Unterstützte Operationen hängen vom Konnektor ab. Siehe Verbinden von Fabric-Apps mit Fabric-Daten.
- Dateispeicherung – Definiere getippte Ordner, kontrolliere den Zugriff mit authentifizierten Richtlinien und lade Dateien hoch, lädst herunter, liste und lösche Dateien in Fabric. Siehe Dateien speichern und verwalten.
- Typsichere Clients – Das Client-SDK validiert Abfragen und Mutationen, bevor sie das Backend erreichen, und erkennt Fehler während der Entwicklung.
- Eingebaute Authentifizierung – Sitzungsmanagement, Tokenhandhabung und Authentifizierungsabläufe sind enthalten. Konfigurieren Sie Fabric SSO für bereitgestellte Anwendungen, oder verwenden Sie E-Mail und Kennwort während der lokalen Entwicklung.
- Statisches Hosting – Erstellen und hosten Sie Ihre Frontend-Anwendung zusammen mit Ihren Backend-APIs. Erfordern Sie Zugriff auf Fabric-Items oder erlauben Sie anonymen Zugriff auf gehostete Assets.
- Entwicklungs-Workflow – Projektgerüste erstellen, entwickeln Sie mit GitHub Copilot oder anderen Coding-Agenten und deployen Sie mit der Rayfin-CLI auf Fabric. Verwenden Sie während der Entwicklung Fabric-gestützte Dienste oder Docker für unterstützte lokale Dienste. Dateispeicher verwendet Fabric-Speicher sowohl in der Entwicklung als auch in der Bereitstellung.
Unterstützte Regionen
Informationen zur Regionsverfügbarkeit finden Sie unter Fabric-Regionverfügbarkeit.
Voraussetzungen
Lizenz und Arbeitsbereich
Die Anforderungen an den Arbeitsbereich hängen von der Lizenzoption Ihrer App ab:
- Für eine kapazitätsgestützte App weisen Sie dem Arbeitsbereich Fabric-Kapazität oder eine aktive Fabric-Testkapazität zu. App-Dienste verbrauchen Kapazitätseinheiten aus dieser Kapazität.
- Für das Power BI Pro-Erlebnis verwenden Sie einen Pro-Arbeitsbereich. Du musst keine Fabric-Kapazität zuweisen. Die Power BI Pro-Limits gelten.
Für Lizenzanforderungen siehe Lizenzoption für Fabric-Apps auswählen. Um eine App mit einer der beiden Optionen zu erstellen, folgen Sie Eine App über das Portal erstellen.
Einstellungen des Mandantenadministrators
Ein Fabric Mandantenadministrator muss die Fabric Apps-Workload aktivieren, bevor Benutzer Elemente erstellen können.
- Melden Sie sich beim Fabric-Verwaltungsportal an.
- Navigieren Sie zu Mandanteneinstellungen.
- Schalten Sie unter Fabric Apps die Einstellung auf Aktiviert um.
- Wählen Sie aus, ob für die gesamte Organisation oder bestimmte Sicherheitsgruppen aktiviert werden soll.
- Wählen Sie Anwenden.
Änderungen können einige Minuten dauern, bis sie verteilt werden.
So funktioniert es
Eine Fabric-App vereint Frontend-Hosting und verwaltete Backend-Services. Ihr Frontend nutzt den Rayfin-Client, um auf Daten-APIs zuzugreifen, Funktionen aufzurufen, Dateien zu verwalten und verbundene Daten abzufragen. Fabric verwaltet das Hosting, das Netzwerk und die Skalierung. Bereitgestellte Apps verwenden Fabric SSO (Microsoft Entra ID Single Sign-on) für die Benutzerauthentifizierung; andere Anmeldeanbieter sind nach der Bereitstellung nicht verfügbar.
Wenn Sie mit der Rayfin-CLI bereitstellen, stellt Fabric die in rayfin.yml aktivierten Dienste bereit oder aktualisiert sie. Wählen Sie die Dienste aus, die Ihre App benötigt:
| Service | Was es bietet |
|---|---|
| Daten- und GraphQL-APIs | Strukturierte Anwendungsdaten in einer SQL-Datenbank in Fabric, mit Schemata und APIs, die aus Ihren TypeScript-Datenmodellen und Autorisierungsregeln generiert werden. |
| Functions | Serverseitige TypeScript-Logik, die über aufrufbare HTTP-Endpunkte zugänglich gemacht wird, mit getippten Clientaufrufen und Zugriff auf App-Daten und externe Dienste. |
| Dateispeicherung | OneLake-gestützter Speicher für Dokumente, Bilder und Anhänge mit typisierten Ordnern und authentifizierten Zugriffsregeln. Speicher erfordert den Datendienst. |
| Authentication | Fabric SSO für bereitgestellte Apps, sodass Benutzer sich mit ihrer bestehenden Fabric-Identität anmelden. |
| Statisches Hosting | Ihre erstellten Frontend-Dateien werden über eine Hosting-URL bereitgestellt, mit geschütztem oder anonymem Zugriff auf die statischen Inhalte. |
Verwaltung im Fabric-Portal
Nach der Bereitstellung können Sie Ihre Fabric-App direkt im Fabric-Portal verwalten.
Ein Fabric-Administrator kann vorübergehend andere Nutzer daran hindern, Ihre App zu laden. Als App-Besitzer kannst du die App trotzdem öffnen. Weitere Informationen finden Sie unter Blockieren und die Blockierung von Fabric-Apps aufheben.
Wenn Sie eine blockierte App besitzen oder verwenden, lesen Sie Was passiert, wenn eine App blockiert wird.
Elementberechtigungen
Arbeitsbereichsrollen ersetzen keine Berechtigungen auf Elementebene. Um eine App für eine Person in Ihrer Organisation freizugeben, benötigen sie die Berechtigung "Ausführen und Interagieren " (Lesen und Ausführen), um die App auszuführen und die Back-End-APIs aufzurufen.
| Erlaubnis | Was dies zulässt |
|---|---|
| Ausführen und interagieren (Standard) | Öffnen und verwenden Sie die bereitgestellte Anwendung. Alle Arbeitsbereichsmitglieder erhalten diese Ebene standardmäßig. |
| Bearbeiten (Schreiben) | Ändern Sie die Fabric-App – stellen Sie Code über rayfin up bereit, übernehmen Sie Schemaänderungen, aktualisieren Sie Einstellungen und verwalten Sie untergeordnete Dienste. |
| Erneut teilen | Gewähren Sie anderen Benutzern Zugriff auf die Fabric-App. Erfordert die Administratorrolle für den Arbeitsbereich. |
Weitere Informationen zu Arbeitsbereichsrollen.
Für den Sharing-Workflow, Berechtigungen zu verwandten Elementen und Zugriffsanfragen siehe Share a Fabric App.
Entwicklung mit Rayfin CLI
Die CLI erstellt ein Gerüst für neue Projekte, startet lokale Infrastruktur, synchronisiert Schemaänderungen und stellt für Fabric bereit. Installieren Sie es mit npm create @microsoft/rayfin@latest.
Tastenbefehle:
| Befehl | Purpose |
|---|---|
npm create @microsoft/rayfin@latest |
Erstellen Sie ein neues Projekt aus einer Vorlage. |
npx rayfin up |
Stellen Sie Ihr Projekt für Fabric bereit. |
npx rayfin up db apply |
Wenden Sie Datenbankschemaänderungen an. |
Eine vollständige Befehlsreferenz finden Sie unter CLI-Referenz.
Datenmodell-Dekoratoren
Definieren von Datenmodellen mithilfe von TypeScript-Dekoratoren:
Das Standardgerüst blankapp ist ein Universal App-Arbeitsbereich. Daten sind opt-in: Aktivieren Sie sie, bevor Entitäten zu packages/data/src/ hinzugefügt werden, und halten Sie kundenorientierte Verträge in packages/shared/src/. Einfache Vorlagen können stattdessen rayfin/data/ verwendet werden. Siehe Definieren von Datenmodellen.
import {
entity,
role,
text,
boolean,
date,
uuid,
} from '@microsoft/rayfin-core';
@entity()
@role('authenticated', '*', {
policy: (claims, item) => claims.sub.eq(item.user_id),
})
export class Todo {
@uuid() id!: string;
@text({ min: 1, max: 100 }) title!: string;
@boolean() isCompleted!: boolean;
@date() createdAt!: Date;
@date({ optional: true }) dueDate?: Date;
@text({ max: 255 }) user_id!: string;
}
Sie können sich auch mit vorhandenen Daten verbinden, anstatt alle Daten in der Datenbank der App zu speichern. Connectors bieten Lesezugriff auf ein Lakehouse über dessen SQL-Analytics-Endpunkt, unterstützte Lese- und Schreiboperationen auf einem Warehouse oder einer SQL-Datenbank in Fabric sowie Abfragen gegen ein semantisches Modell. Connector-Zugriff erfordert die entsprechenden Quellberechtigungen; er gewährt keinen Zugriff auf die zugrunde liegenden Daten. Siehe Verbinden von Fabric-Apps mit Fabric-Daten.
Für Daten und Dienste außerhalb dieser Connectoren verwenden Sie Funktionen, um externe APIs sowie unterstützte Azure- und Fabric-Ressourcen aufzurufen. Externe Verbindungen nutzen die Berechtigungen der App-Identität, während der Zugriff auf die App-Datenbank über eine Funktion die Berechtigungen des Anrufers erhält. Bewahren Sie Zugangsdaten und Ressourcentoken auf dem Server auf. Siehe Funktionen mit externen Ressourcen verbinden.
Wann Fabric Apps verwendet werden sollen
Fabric Apps eignen sich ideal für:
- Schnelles Prototyping – Von der Idee zur Live-URL in wenigen Minuten mit vorkonfigurierter Infrastruktur gehen.
- Interne Tools und Dashboards – Baue authentifizierte Admin-Schnittstellen, ohne Backend-Boilerplate zu schreiben.
- Datenexploration und Visualisierung – Verwenden Sie Connectors, um unterstützte Fabric-Datenelemente abzufragen und die Ergebnisse in benutzerdefinierten Frontends anzuzeigen.
- KI- und Agentenanwendungen – Stellen strukturierte Backend-Services für KI-Agenten bereit, die einen persistenten Zustand benötigen.
Fabric Apps eignen sich möglicherweise nicht für:
- Anwendungen, die komplexe Transaktionen mit mehreren Schritten oder gespeicherte Prozeduren erfordern.
- Apps, die nach der Bereitstellung Anmeldeanbieter außer Fabric SSO erfordern.
Sicherheitsverantwortlichkeiten
Fabric bietet: Fabric Single Sign On (Microsoft Entra ID), Sicherheit auf Zeilenebene über @role Decorators, HTTPS, PKCE sowie Berechtigungen auf Arbeitsflächen- und Elementebene.
Sie sind verantwortlich für:
- Halten Sie Geheimnisse, API-Schlüssel und vertrauliche Daten aus Ihrem Code, Ihren Frontend-Assets und Ihrem Repository heraus. Speichere keine Geheimnisse in Frontend-Assets, unabhängig vom konfigurierten Hosting-Zugriff.
- Was Ihre App über Fabric SSO bereitstellt, steuert die Anmeldung, da Ihr Code bestimmt, was authentifizierte Benutzer sehen und tun können.
- Beitragenden nur die Berechtigungen erteilen, die sie zum Bereitstellen oder Verwalten der App benötigen.
- Rechtliche und Compliance-Verantwortlichkeit für die Daten, die Ihre App sammelt, verarbeitet und speichert.