Microsoft Fabric Apps: Was sie sind und wie Sie sie nutzen
Von Mirko Peters ·
Fabric Apps (Vorschau) ermöglicht es Entwicklern, mit TypeScript datengetriebene Apps auf Microsoft Fabric zu erstellen. Dieser Leitfaden erklärt, was die Funktion ist, wie der Administrator sie aktiviert, wie Sie eine App erstellen und bereitstellen, welche Berechtigungen gelten und welche aktuellen Einschränkungen es gibt.
Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen
Fabric Apps ist eine Funktion von Microsoft Fabric, derzeit in der Vorschau, zum Erstellen datengetriebener Anwendungen. Entwickler schreiben Datenmodelle in TypeScript, und Fabric generiert daraus das Datenbankschema, GraphQL-APIs, die Anmeldung und das Hosting. Die Funktion richtet sich an Entwickler und nicht an Berichtsautoren und ist von Power BI-Apps getrennt.
Das Wichtigste in Kürze
- Fabric Apps ist eine Vorschaufunktion auf Basis des Rayfin SDK. Entwickler definieren Datenmodelle in TypeScript, und Fabric generiert die Datenbank, die GraphQL-API, die Authentifizierung und das Hosting.
- Ein Mandantenadministrator muss Fabric Apps (Vorschau) zuerst im Fabric Admin Portal unter Mandanteneinstellungen aktivieren, und zwar für die gesamte Organisation oder für bestimmte Sicherheitsgruppen.
- Dem Arbeitsbereich muss Fabric-Kapazität zugewiesen sein. Fabric Apps-Dienste verbrauchen daraus Kapazitätseinheiten.
- Nach der Bereitstellung erfolgt die Anmeldung ausschließlich über Fabric SSO mit Microsoft Entra ID. E-Mail-Adresse und Kennwort funktionieren nur für die lokale Entwicklung.
- Microsoft nennt Einschränkungen wie fehlende Many-to-Many-Beziehungen, keine zusammengesetzten Schlüssel, kein ALM und keine Unterstützung für Private Link. Prüfen Sie diese, bevor Sie sich für ein Design entscheiden.
Was Fabric Apps leistet
Microsoft Learn beschreibt Fabric Apps als Funktion auf Basis des Rayfin SDK. Sie versehen TypeScript-Klassen mit Dekoratoren, zum Beispiel @entity(), @text() oder @uuid(). Aus diesem Modell erstellt Fabric:
- Datenbanktabellen, mit einer SQL-Datenbank in Fabric als verwaltetem Speicher
- einen GraphQL-Endpunkt unter
/api/graphqlauf der Backend-URL der App - Regeln zur zeilenbasierten Autorisierung über
@role-Dekoratoren - typsichere Clientmethoden
- statisches Hosting für das Frontend
Wenn Sie rayfin up ausführen, erstellt Fabric untergeordnete Elemente unter der App: eine SQL-Datenbank in Fabric, Authentication und Static Content. Jede App hat einen Backend-Endpunkt in der Form https://<ihre-app>-app.rayfin.windows.net/ mit den Pfaden /api/graphql für Daten und /auth für die Authentifizierung.
Weitere dokumentierte Funktionen sind typisierte Connectors zu einem Lakehouse, Warehouse, einer SQL-Datenbank in Fabric oder einem semantischen Modell sowie typisierter Dateispeicher mit Zugriffsrichtlinien.
Wofür sich Fabric Apps eignet
Microsoft nennt folgende Einsatzbereiche als gut geeignet: schnelles Prototyping, interne Tools und Dashboards, Datenexploration mit Fabric-Connectors sowie KI- oder Agenten-Apps, die einen dauerhaften Zustand benötigen. Als wahrscheinlich ungeeignet gelten Apps, die komplexe mehrstufige Transaktionen oder gespeicherte Prozeduren benötigen, sowie Apps, die eigene Authentifizierungsanbieter brauchen.
Schritt 1: Mandanteneinstellung aktivieren
Diese Aufgabe übernimmt der Administrator, und sie muss erledigt sein, bevor Benutzer das Element erstellen können.
- Melden Sie sich im Fabric Admin Portal an.
- Öffnen Sie Mandanteneinstellungen.
- Setzen Sie unter Fabric Apps (Vorschau) den Schalter auf Aktiviert.
- Wählen Sie die gesamte Organisation oder bestimmte Sicherheitsgruppen aus.
- Wählen Sie Anwenden aus.
Änderungen können einige Minuten benötigen, bis sie wirksam werden.
Schritt 2: Arbeitsbereich vorbereiten
Der Workspace benötigt eine zugewiesene Fabric-Kapazität. Wählen Sie beim Erstellen des Workspace eine Kapazität aus. Zum Erstellen einer App benötigen Sie die Berechtigung Mitwirkender oder Administrator in diesem Workspace. Für die lokale Arbeit installieren Sie Node.js 20 oder höher.
Schritt 3: Das App-Element erstellen
- Wählen Sie in der linken Navigation Workspaces aus und öffnen Sie Ihren Workspace.
- Wählen Sie Neues Element aus, suchen Sie nach App und wählen Sie sie aus.
- Geben Sie einen Namen ein und wählen Sie Erstellen aus.
Das Portal zeigt dann einen Befehl zum lokalen Herunterladen eines Projekts an. Er hat folgende Form:
npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>
Schritt 4: Entwickeln und bereitstellen
Bearbeiten Sie das Projekt oder arbeiten Sie mit GitHub Copilot, und testen Sie anschließend das Backend in Fabric mit npm run dev. Stellen Sie mit npx rayfin up bereit. Um in einen anderen Workspace bereitzustellen, ergänzen Sie --workspace <workspacename>. Bestätigen Sie das Backend mit npx rayfin up status.
Das Beispiel-Kommentar in den häufigen Fragen besagt, dass eine Bereitstellung nur mit statischen Inhalten mit npx rayfin up staticapp deploy nach der ersten Bereitstellung 30 bis 60 Sekunden dauert. Die gelesenen Seiten nennen keine Zeit für die erste Bereitstellung. Eine reine Bereitstellung statischer Inhalte kann die initiale Remote-App nicht erstellen, daher führen Sie zuerst einmal npx rayfin up aus. Zum Zurücksetzen prüfen Sie den früheren Git-Commit aus und führen npx rayfin up erneut aus.
Was Sie im Fabric-Portal sehen
Nach rayfin up zeigt das App-Element untergeordnete Elemente an, die Fabric aus Ihrer Konfiguration rayfin.yml erstellt hat:
- SQL-Datenbank in Fabric: die verwaltete Datenbank mit dem Schema aus Ihren Decorators. Im Portal ist sie schreibgeschützt. Ändern Sie das Schema daher im Code.
- Authentifizierung: die von Fabric vermittelte Anmeldung über Microsoft Entra ID. Sie können die authentifizierten Benutzer in der SQL-Datenbank einsehen.
- Statische Inhalte: die erstellten Frontend-Ressourcen, die über eine Hosting-URL bereitgestellt und bei jeder Bereitstellung aktualisiert werden. In der Übersicht heißt es, dass für das statische Hosting Zugriff auf das Fabric-Element erforderlich sein kann oder anonymer Zugriff zugelassen werden kann.
Authentifizierung und Berechtigungen
Learn nennt Fabric-SSO für bereitgestellte Apps und E-Mail und Kennwort für die lokale Entwicklung. Die Anmeldung mit E-Mail und Kennwort funktioniert nach der Bereitstellung nicht, und für die Bereitstellung muss die Fabric-Authentifizierung aktiviert sein.
Elementberechtigungen sind von Workspace-Rollen getrennt:
| Berechtigung | Ermöglicht | |---|---| | Ausführen und interagieren | App öffnen und verwenden sowie deren Backend-APIs aufrufen. Alle Workspace-Mitglieder erhalten sie standardmäßig. | | Bearbeiten (Schreiben) | Bereitstellen, Schema ändern, Einstellungen aktualisieren, untergeordnete Dienste verwalten | | Erneut freigeben | Anderen Zugriff gewähren. Erfordert die Administratorrolle im Workspace. |
Ein Fabric-Administrator kann anderen Benutzern vorübergehend das Laden einer App untersagen, der Eigentümer kann sie dennoch öffnen.
Die Sicherheit liegt zum Teil weiterhin bei Ihnen. Microsoft empfiehlt, Geheimnisse nicht im Code und nicht in den Frontend-Ressourcen abzulegen. Ihr Code bestimmt, was angemeldete Benutzer sehen und tun dürfen.
Einschränkungen, die Sie zuerst prüfen sollten
Die häufigen Fragen nennen folgende aktuelle Einschränkungen:
- keine Many-to-Many-Beziehungen und keine zusammengesetzten Primärschlüssel (jede Entität benötigt ein einzelnes UUID-Feld mit dem Namen
id) - keine benutzerdefinierten Authentifizierungsanbieter
- keine Verwaltung mehrerer Umgebungen standardmäßig
- kein Schutz vor ausgehendem Zugriff auf Workspace-Ebene
- keine privaten Links auf Mandanten- oder Workspace-Ebene
- kein Application Lifecycle Management (ALM)
count()ist im Fluent-GraphQL-Client nicht verfügbar
Datenmodelle werden in TypeScript mit Decorators geschrieben.
Typische Probleme
Microsoft nennt einen fehlenden Production-Build als häufigste Ursache für Buildfehler. Führen Sie daher zuerst npm run build aus. Bei Fehlern zu Kapazität oder Berechtigungen prüfen Sie, ob dem Workspace Kapazität zugewiesen ist und Sie dort Elemente erstellen oder ändern können. Bei Schemafehlern sehen Sie die Änderungen seit der letzten erfolgreichen Bereitstellung durch. Die Seite zur Fehlerbehebung besagt, dass der App-Code die maßgebliche Quelle ist. Ändern Sie das Remote-Schema nicht über das Fabric-Portal oder SQL-Tools, denn das Entfernen oder Ändern einer vorhandenen Spalte kann die App und ihre Bereitstellung beschädigen. Nehmen Sie Schemaänderungen im Code vor und wenden Sie sie mit npx rayfin up db apply an.
Verwandte Themen
Quellen
- Übersicht über Fabric Apps (Vorschau)
- Erstellen Sie Ihr erstes Fabric Apps-Projekt
- Häufige Fragen zu Fabric Apps
- Fehlerbehebung für Fabric Apps
FAQ
Sind Fabric Apps allgemein verfügbar?
Nein. Microsoft Learn kennzeichnet Fabric Apps als Vorschaufunktion und weist darauf hin, dass sie noch nicht in allen Regionen verfügbar ist. Auf den für diesen Artikel gelesenen Seiten wird kein Termin für die allgemeine Verfügbarkeit genannt.
Wer kann eine Fabric-App erstellen?
Laut Microsoft Learn benötigen Sie die Berechtigung Mitwirkender oder Administrator in einem Fabric-Arbeitsbereich mit Fabric-Kapazität. Außerdem muss ein Mandantenadministrator die Mandanteneinstellung Fabric Apps (Vorschau) aktiviert haben. Für die lokale Entwicklung ist Node.js 20 oder höher erforderlich.
Welche Anmeldemethoden unterstützen bereitgestellte Fabric-Apps?
Laut Microsoft Learn verwenden bereitgestellte Apps ausschließlich Fabric SSO, also die einmalige Anmeldung von Microsoft Entra. Anmeldung mit E-Mail-Adresse und Kennwort ist nur für die lokale Entwicklung verfügbar. Eine Bereitstellung ist außerdem nur möglich, wenn die Authentifizierung aktiviert ist.
Kann eine Fabric-App eine vorhandene Datenbank verwenden?
Nein. Die FAQ von Microsoft Learn besagt, dass Fabric Apps das Schema anhand Ihrer TypeScript-Modelle verwaltet und nicht auf eine Datenbank mit vordefiniertem Schema verweisen kann. Um auf ein vorhandenes Lakehouse, Warehouse oder eine SQL-Datenbank in Fabric zuzugreifen, fügen Sie einen Connector hinzu.
Erklären die Microsoft-Seiten die Preise für Fabric Apps?
Nein. Die gelesenen Seiten enthalten keine Preisangaben. Der Überblick nennt lediglich, dass der Arbeitsbereich Fabric-Kapazität benötigt und dass Fabric Apps-Dienste Kapazitätseinheiten daraus verbrauchen. Die FAQ besagt, dass die Leistung von Ihrer Fabric-Kapazität abhängt.