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 (Vorschau) helfen Ihnen, datengesteuerte Anwendungen auf Microsoft Fabric zu erstellen, indem Sie Datenmodelle, generierte APIs, Authentifizierung und Hosting in einem Entwicklungsworkflow kombinieren. Sie definieren Ihre Datenmodelle in TypeScript, und Fabric Apps sie zum Generieren der benötigten Back-End-Teile verwenden. Fabric Apps unterstützt TypeScript als Sprache für Datenmodelle, Clientcode und Anwendungslogik.
Important
Dieses Feature befindet sich in der Vorschauphase.
Wichtigste Funktionen
Fabric Apps bieten folgende Funktionen:
-
Datenmodelle für APIs – Schmücken Sie TypeScript-Klassen mit
@entity(),@text(), und@uuid()anderen Dekoratoren. Fabric Apps generiert Datenbankschemas und GraphQL-Endpunkte automatisch. - Typsichere Clients – Das Client-SDK überprüft Abfragen und Mutationen, bevor sie das Back-End erreichen und Fehler während der Entwicklung abfangen.
- Integrierte Authentifizierung – Sitzungsverwaltung , Tokenbehandlung und Authentifizierungsflüsse 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 bedienen Sie Ihre Frontend-Anwendung zusammen mit Ihren Back-End-APIs mit einem einzigen Bereitstellungsbefehl.
- Local Development – Führen Sie den vollständigen Stapel lokal mit Docker aus, um eine schnelle Iteration durchzuführen, und stellen Sie dann für Microsoft Fabric bereit, wenn sie für die Produktion bereit sind. Gerüstprojekte, Entwickeln mit GitHub Copilot und Bereitstellen für Fabric mit Rayfin CLI.
Voraussetzungen
Gewebekapazität
Ihrem Arbeitsbereich muss eine Fabric-Kapazität zugewiesen sein. Wählen Sie beim Erstellen eines neuen Arbeitsbereichs eine Fabric-Kapazität aus, mit der er verknüpft werden soll. Fabric Apps-Dienste verbrauchen Kapazitätseinheiten aus der zugewiesenen Kapazität.
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 (Vorschau) die Einstellung auf Enabled 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 wird als verwalteter Dienst in Microsoft Fabric mit Einer Suite von Diensten ausgeführt, die das Back-End definieren, z. B. App-Hosting, Datenbank, GraphQL-APIs und Authentifizierung. Fabric verwaltet das Hosting, das Netzwerk und die Skalierung. Die Authentifizierung verwendet Fabric SSO (Microsoft Entra ID einmaliges Anmelden) ausschließlich – nach der Bereitstellung sind keine anderen Authentifizierungsanbieter verfügbar.
Wenn Sie Ihre Anwendung mit rayfin up bereitstellen, erstellt Fabric untergeordnete Dienste basierend auf Ihrer konfiguration rayfin.yml. Diese untergeordneten Dienste werden als untergeordnete Elemente unter der Fabric-App im Fabric-Portal angezeigt.
| Teildienst | Was es bietet | Portalfunktionen |
|---|---|---|
| SQL-Datenbank in Fabric | Eine verwaltete SQL-Datenbank mit Ihrem Schema, das von TypeScript-Datenmodelldekorzierern angewendet wird. | Datenbank anzeigen, Abfragen mit dem Abfrage-Editor ausführen, Verbindungszeichenfolge kopieren. Die Datenbank ist im Portal schreibgeschützt – Schemaänderungen müssen aus Ihrem Code heraus über rayfin up erfolgen. |
| Authentifizierung | Fabric vermittelte Authentifizierung mit Microsoft Entra ID (SSO). Benutzer melden sich über ihre vorhandene Fabric Identität an. | Zeigen Sie authentifizierte Benutzer in der SQL-Datenbank an. |
| Statischer Inhalt | Ihre integrierten Frontend-Ressourcen (HTML, CSS, JS) werden über oneLake-Speicher an einer öffentlichen URL bereitgestellt. | Host-URL anzeigen. Assets werden bei jeder Bereitstellung aktualisiert. |
Backend-URL der App
Jede Fabric-App verfügt über einen einzelnen Endpunkt, der Zugriff auf alle Dienste bietet:
https://<your-app>-app.rayfin.windows.net/
Der Endpunkt macht einen Pfad für jeden Dienst verfügbar:
| Pfad | Service |
|---|---|
/api/graphql |
Daten-API (GraphQL) — wird von RayfinClient für Lese- und Schreiboperationen verwendet |
/auth |
Authentifizierungsdienst |
/storage |
Dateispeicherung |
Verwaltung im Fabric-Portal
Nach der Bereitstellung können Sie Ihre Fabric-App direkt im Fabric-Portal verwalten.
Elementeigenschaften anzeigen
Öffnen Sie die Fabric-App im Portal, um Folgendes anzuzeigen:
- App-Back-End-URL – Dieser Endpunkt wird für alle Back-End-Dienste verwendet, die von der Anwendung verwendet werden.
- App-URL – Die öffentliche URL, in der Ihre statischen Inhalte gehostet werden. Fabric SSO ist erforderlich, um auf die App zuzugreifen.
Verwalten untergeordneter Elemente
Wählen Sie die Fabric-App aus, um die untergeordneten Dienste anzuzeigen:
-
SQL-Datenbank in Fabric – Öffnet das Fabric SQL-Datenbankelement, um den Objekt-Explorer anzuzeigen. Sie können Leseabfragen für Ihre Daten ausführen. Schemaänderungen sollten immer im Code unter
rayfin/dataOrdner vorgenommen werden. Schemakonflikte können auftreten, wenn das Schema direkt in der SQL-Datenbank geändert wird, und dazu führen, dass die App nicht mehr funktioniert.
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 freigeben | Gewähren Sie anderen Benutzern Zugriff auf die Fabric-App. Erfordert die Administratorrolle für den Arbeitsbereich. |
Weitere Informationen zu Arbeitsbereichsrollen.
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:
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() user_id!: string;
}
Fabric Apps analysiert diese Dekoratoren und generiert:
- Datenbanktabellendefinitionen
- GraphQL-API-Endpunkte
- Autorisierungsregeln auf Zeilenebene
- Typsichere Client-Methoden
Wann Fabric Apps verwendet werden sollen
Fabric Apps eignen sich ideal für:
- Schnelle Prototyperstellung – Wechseln Sie von der Idee zur Live-URL in Minuten mit vorkonfigurierten Infrastruktur.
- Interne Tools und Dashboards – Erstellen sie authentifizierte Administratorschnittstellen, ohne Back-End-Textbausteine zu schreiben.
- Datenexploration und -visualisierung – Fabric-Daten über GraphQL abfragen und in benutzerdefinierten Frontends anzeigen.
- KI- und Agent-Anwendungen – Stellen Sie strukturierte Back-End-Dienste für KI-Agents bereit, die beständigen 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 benutzerdefinierte Authentifizierungsanbieter über Fabric SSO und E-Mail/Kennwort hinaus erfordern.
Sicherheitsverantwortlichkeiten
Fabric bietet: Fabric Single Sign-On (Microsoft Entra ID), Sicherheit auf Zeilenebene über @role-Dekoratoren, HTTPS, PKCE sowie Berechtigungen auf Arbeitsbereichs- und Elementebene.
Sie sind dafür verantwortlich:
- Halten Sie Geheimnisse, API-Schlüssel und vertrauliche Daten aus Ihrem Code, Ihren Frontend-Assets und Ihrem Repository heraus. Statische Inhalte werden von einer öffentlichen URL bereitgestellt.
- 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.