Vad är Fabric Apps (förhandsversion)?

Fabric Apps (förhandsversion) hjälper dig att skapa datadrivna program på Microsoft Fabric genom att kombinera datamodeller, genererade API:er, autentisering och värdtjänster i ett utvecklingsarbetsflöde. Du definierar dina datamodeller i TypeScript och Fabric Apps använder dem för att generera de serverdelsdelar som din app behöver. Fabric Apps stöder TypeScript som språk för datamodeller, klientkod och programlogik.

Viktiga funktioner

Fabric Apps innehåller följande funktioner:

• Datamodeller till API:er – Dekorera TypeScript-klasser med @entity(), @text(), @uuid()och andra dekoratörer. Fabric Apps genererar databasscheman och GraphQL-slutpunkter automatiskt.
• Typsäkra klienter – klient-SDK validerar frågor och mutationer innan de når serverdelen och fångar fel under utvecklingen.
• Inbyggd autentisering – Sessionshantering, tokenhantering och autentiseringsflöden ingår. Konfigurera Fabric enkel inloggning för distribuerade program eller använd e-post och lösenord under den lokala utvecklingen.
• Statisk värd – Skapa och hantera klientdelsprogrammet tillsammans med dina API:er för serverdelen med ett enda distributionskommando.
• Lokal utveckling – Kör hela stacken lokalt med Docker för snabb iteration och distribuera sedan till Microsoft Fabric när du är redo för produktion. Autogenerera projekt, utveckla med GitHub Copilot och distribuera till Fabric med Rayfin CLI.

Regioner som stöds

Fabric Appar kan inte nås i alla regioner ännu. Mer information finns i regioner som stöds för Fabric App.

Förutsättningar

Tygets kapacitet

Arbetsytan måste ha en Fabric-kapacitet tilldelad. När du skapar en ny arbetsyta väljer du en Fabric-kapacitet att koppla till den. Fabric Apps-tjänster förbrukar kapacitetsenheter från den tilldelade kapaciteten.

Klientorganisationsadministratörsinställningar

En Fabric-klientorganisationsadministratör måste aktivera arbetsbelastningen för Fabric Apps innan användarna kan skapa objekt.

1. Logga in på administratörsportalen Fabric.
2. Gå till Klientinställningar.
3. Under Fabric Apps (förhandsversion) ändrar du inställningen till Enabled.
4. Välj om du vill aktivera för hela organisationen eller specifika säkerhetsgrupper.
5. Välj Tillämpa.

Det kan ta några minuter att sprida ändringarna.

Så här fungerar det

En Fabric app körs som en hanterad tjänst i Microsoft Fabric med en uppsättning tjänster som definierar serverdelen, till exempel appvärd, databas, GraphQL-API:er och autentisering. Fabric hanterar värdtjänster, nätverk och skalning. Autentiseringen använder uteslutande Fabric SSO (Microsoft Entra ID enkel inloggning) – inga andra autentiseringsleverantörer är tillgängliga efter distribution.

När du distribuerar ditt program med rayfin up skapar Fabric underordnade tjänster baserat på konfigurationen rayfin.yml. Dessa underordnade tjänster visas som underordnade objekt under appen Fabric i Fabric portalen.

Appens serversidans URL

Varje Fabric app har en enda slutpunkt som ger åtkomst till alla tjänster:

https://<your-app>-app.rayfin.windows.net/

Slutpunkten exponerar en sökväg för varje tjänst:

Hantering i Fabric-portalen

Efter distributionen kan du hantera din Fabric app direkt i Fabric portalen.

Visa objektegenskaper

Öppna Fabric-appen i portalen för att se:

• Appens serverdels-URL – Den här slutpunkten används för alla serverdelstjänster som används av programmet.
• App-URL – den offentliga URL:en där ditt statiska innehåll finns. Fabric SSO krävs för att komma åt appen.

Hantera underordnade objekt

Välj appen Fabric för att se dess underliggande tjänster:

• SQL-databasen i Fabric – öppnar objektet Fabric SQL Database för att visa objektutforskaren. Du kan köra läsfrågor mot dina data. Schemaändringar bör alltid göras i koden under rayfin/data mappen. Schemakonflikter kan uppstå om schemat ändras direkt i SQL Database och kan bryta appen.

Objektbehörigheter

Arbetsyteroller ersätter inte behörigheter på objektnivå. Om du vill dela en app med någon i din organisation behöver de behörigheten Kör och interagera (Läsa och köra) för att köra appen och anropa serverdels-API:erna.

Läs mer om arbetsyteroller.

Utveckling med Rayfin CLI

CLI skapar nya projekt, startar lokal infrastruktur, synkroniserar schemaändringar och distribuerar till Fabric. Installera den med npm create @microsoft/rayfin@latest.

Nyckelkommandon:

En fullständig kommandoreferens finns i CLI-referens.

Datamodelldekoratörer

Definiera datamodeller med TypeScript-dekoratörer:

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 analyserar dessa dekoratörer och genererar:

• Databastabelldefinitioner
• GraphQL API-slutpunkter
• Auktoriseringsregler på radnivå
• Typsäkra klientmetoder

När du ska använda Fabric-appar

Fabric Apps är perfekt för:

• Snabba prototyper – Gå från idé till live-URL på några minuter med förkonfigurerad infrastruktur.
• Interna verktyg och dashboards – Skapa administratörsgränssnitt med autentisering utan att skriva backend-grundkod.
• Utforska och visualisera data – Fråga efter data i Fabric via GraphQL och visa dem i anpassade gränssnitt.
• AI- och agentprogram – Tillhandahålla strukturerade serverdelstjänster för AI-agenter som behöver beständiga tillstånd.

Fabric Appar kanske inte är lämpliga för:

• Program som kräver komplexa transaktioner i flera steg eller lagrade procedurer.
• Appar som kräver anpassade autentiseringsleverantörer utöver enkel inloggning med Fabric och e-post/lösenord.

Säkerhetsansvar

Fabric tillhandahåller: Fabric Single Sign-On (Microsoft Entra ID), säkerhet på radnivå med hjälp av @role dekoratorer, HTTPS, PKCE och behörigheter på arbetsyte- och objektnivå.

Du ansvarar för:

• Hålla hemligheter, API-nycklar och känsliga data borta från din kod, klientdelstillgångar och lagringsplats. Statiskt innehåll hanteras från en offentlig URL.
• Vad din app exponerar via Fabric SSO styr inloggningen eftersom koden styr vad autentiserade användare ser och gör.
• Om du bara beviljar de behörigheter som deltagare behöver för att distribuera eller hantera appen.
• Juridiskt och efterlevnadsansvar för de data som din app samlar in, bearbetar och lagrar.

Nästa steg

• Skapa ditt första Fabric Apps-projekt
• Definiera datamodeller med dekoratörer
• Distribuera till Microsoft Fabric
• Konfigurera autentisering