Was ist Fabric Apps (Vorschau)?

Fabric Apps (Vorschau) basiert auf dem Rayfin SDK und ermöglicht Entwicklern das Erstellen von datengesteuerten Anwendungen auf Fabric mithilfe eines einheitlichen Entwicklungsworkflows. 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.

Important

Dieses Feature befindet sich in der Vorschauphase.

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.
• Fabric Data Connectors – Fügen Sie typisierten Zugriff auf ein Lakehouse, Warehouse, eine SQL-Datenbank in Fabric oder ein semantisches Modell hinzu.
• 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.
• Lokale Entwicklung – Den Full Stack lokal mit Docker für schnelle Iterationen ausführen und dann bei Produktionsbereitschaft auf Fabric deployen. Gerüstprojekte, Entwickeln mit GitHub Copilot und Bereitstellen für Fabric mit Rayfin CLI.

Unterstützte Regionen

Fabric Apps sind in allen Regionen noch nicht verfügbar. Weitere Informationen finden Sie unter Unterstützte Regionen für Fabric App.

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.

1. Melden Sie sich beim Fabric-Verwaltungsportal an.
2. Navigieren Sie zu Mandanteneinstellungen.
3. Schalten Sie unter Fabric Apps (Vorschau) die Einstellung auf Enabled um.
4. Wählen Sie aus, ob für die gesamte Organisation oder bestimmte Sicherheitsgruppen aktiviert werden soll.
5. 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 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	Deine erstellten Frontend-Assets (HTML, CSS, JS) werden von einer Fabric Apps Hosting-URL bereitgestellt. Konfigurieren Sie geschützten Zugriff oder erlauben Sie anonymen Zugriff auf die Assets.	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 umfasst folgende Servicepfade:

Pfad	Service
/api/graphql	Daten-API (GraphQL) — wird von RayfinClient für Lese- und Schreiboperationen verwendet
/auth	Authentifizierungsdienst

Für Dateioperationen verwenden Sie das Storage Client SDK.

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.

Elementeigenschaften anzeigen

Öffnen Sie die Fabric-App im Portal, um Folgendes anzuzeigen:

• App Backend-URL — Dieser Endpunkt wird für alle von der Anwendung genutzten Backend-Dienste verwendet.
• App-URL – Die URL, auf der Ihre statischen Inhalte gehostet werden. Der Zugang hängt von der Einstellung assetAccess in rayfin.yml.

Verwalten untergeordneter Elemente

Wählen Sie die Fabric-App aus, um die untergeordneten Dienste anzuzeigen:

• SQL-Datenbank in Fabric — Öffnet das Fabric-Element „SQL-Datenbank in Fabric“, um den Objekt-Explorer aufzurufen. Sie können Leseabfragen für Ihre Daten ausführen. Mach Schemaänderungen in deinem konfigurierten Datenpaket (packages/data in der Standard-Universal-App oder rayfin/data in flachen Vorlagen), nicht direkt in der Datenbank. Manuelle Schemaänderungen können Konflikte verursachen und die App kaputt machen.

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.

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;
}

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:

• 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 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 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.

Nächste Schritte

• Erstellen Sie Ihr erstes Fabric Apps-Projekt
• Definiere Datenmodelle mit Dekoratoren
• Fabric-Apps mit Fabric-Daten verbinden
• Dateien speichern und verwalten
• In Fabric bereitstellen
• Authentifizierung konfigurieren