Vad är Fabric-appar?

Fabric Apps bygger på Rayfin SDK och gör det möjligt för utvecklare att skapa datadrivna applikationer på Fabric med ett enhetligt utvecklingsarbetsflöde. Utvecklare definierar datamodeller i TypeScript och Fabric Apps genererar automatiskt API:er, hanterar autentisering, tillhandahåller värdtjänster och integrerar med Fabric tjänster. Fabric Apps stöder TypeScript för datamodeller, klientkod och programlogik. Läs mer i Översikt över Rayfin SDK.

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.
  • Serverfunktioner – Kör TypeScript-logik på servern och anropa den från din frontend via den typade klienten. Få åtkomst till appdata, arbeta med hemligheter och anropa externa API:er. Se Använd funktioner i Fabric-appar.
  • Ta med egna data med anslutningar – Lägg till typad åtkomst till ett befintligt lakehouse, lager, SQL-databas i Fabric eller semantisk modell. Vilka åtgärder som stöds beror på anslutningsprogrammet. Se Connect Fabric Apps to Fabric data.
  • Fillagring – Definiera typade mappar, kontrollera åtkomst med autentiserade policyer och ladda upp, ladda ner, lista och radera filer i Fabric. Se Lagra och hantera filer.
  • Typsäkra klienter – Klient-SDK:n validerar frågor och mutationer innan de når backend 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 hosting – Bygg och hosta din frontend-applikation tillsammans med dina backend-API:er. Kräv åtkomst till Fabric-objekt eller tillåt anonym åtkomst till hostade tillgångar.
  • Utvecklingsarbetsflöde – Bygg upp projekt, utveckla med GitHub Copilot eller andra kodningsagenter, och distribuera till Fabric med hjälp av Rayfin-CLI:n. Använd Fabric-backade tjänster under utveckling eller Docker för stödda lokala tjänster. Fillagring använder Fabric-lagring både i utveckling och driftsättning.

Regioner som stöds

För regiontillgänglighet, se Fabric regiontillgänglighet.

Förutsättningar

Licens och arbetsyta

Arbetsytans krav beror på din apps licensalternativ:

  • För en kapacitetsstödd app, tilldela Fabric-kapacitet eller en aktiv Fabric-testkapacitet till arbetsytan. App-tjänster förbrukar kapacitetsenheter från den kapaciteten.
  • För Power BI Pro-upplevelsen, använd ett Pro-arbetsutrymme. Du behöver inte tilldela Fabric-kapacitet. Power BI Pro-begränsningarna gäller.

För licenskrav, se Välj ett licensalternativ för Fabric Apps. För att skapa en app med något av alternativen, följ Skapa en app från portalen.

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 växlar du inställningen till Aktiverat.
  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 kombinerar frontend-hosting och hanterade backend-tjänster. Din frontend använder Rayfin-klienten för att komma åt data-API:er, anropa funktioner, hantera filer och fråga i ansluten data. Fabric hanterar värdtjänster, nätverk och skalning. Distribuerade appar använder Fabric SSO (Microsoft Entra ID single sign-on) för användarautentisering; andra inloggningsleverantörer är inte tillgängliga efter distribution.

Skärmdump som visar Fabric-appens hanterade tjänst och komponenter.

När du distribuerar med Rayfin-CLI:n tillhandahåller eller uppdaterar Fabric de tjänster som är aktiverade i rayfin.yml. Välj de tjänster din app behöver:

Service Vad det ger
Data- och GraphQL-API:er Strukturerad appdata i en SQL-databas i Fabric, med scheman och API:er genererade från dina TypeScript-datamodeller och auktorisationsregler.
Functions Serverbaserad TypeScript-logik exponeras via anropbara HTTP-slutpunkter, med typade klientanrop och åtkomst till appdata och externa tjänster.
Fil lagring OneLake-stödd lagring för dokument, bilder och bilagor, med typindelade mappar och autentiserade åtkomstregler. Lagring kräver Data-tjänsten.
Authentication Fabric SSO för driftsatta appar, så att användare loggar in med sin befintliga Fabric-identitet.
Statisk hosting Dina byggda frontend-filer serveras från en värd-URL, med skyddad eller anonym åtkomst till det statiska innehållet.

Hantering i Fabric-portalen

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

En Fabric-administratör kan tillfälligt blockera andra användare från att ladda din app. Som appägare kan du fortfarande öppna appen. För mer information, se Blockera och avblockera Fabric-appar.

Om du äger eller använder en blockerad app, se vad som händer när en app blockeras.

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.

Tillåtelse Vad den tillåter
Kör och interagera (standard) Öppna och använd det distribuerade programmet. Alla arbetsytans medlemmar får den här nivån som standard.
Redigera (Skriva) Ändra Fabric-appen – distribuera kod med rayfin up, tillämpa schemaändringar, uppdatera inställningar och hantera underordnade tjänster.
Dela vidare Ge andra användare åtkomst till Fabric-appen. Kräver administratörsroll på arbetsytan.

Läs mer om arbetsyteroller.

För delningsarbetsflödet, relaterade objektbehörigheter och åtkomstförfrågningar, se Dela en Fabric-app.

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:

Command Purpose
npm create @microsoft/rayfin@latest Skapa ett nytt projekt från en mall.
npx rayfin up Distribuera projektet till Fabric.
npx rayfin up db apply Tillämpa ändringar i databasschemat.

En fullständig kommandoreferens finns i CLI-referens.

Datamodelldekoratörer

Definiera datamodeller med TypeScript-dekoratörer:

Standardstommen blankapp är en Universal App-arbetsyta. Data är opt-in: aktivera den innan du lägger till entiteter i packages/data/src/, och behåll klientrelaterade kontrakt i packages/shared/src/. Flat templates kan användas istället rayfin/data/. Se Definiera datamodeller.

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

Du kan också ansluta till befintlig data istället för att lagra all data i appens databas. Connectors ger läsåtkomst till en lakehouse via dess SQL Analytics-endpoint samt stöder läs- och skrivoperationer på ett warehouse eller en SQL-databas i Fabric och frågor mot en semantisk modell. Anslutningsåtkomst kräver lämpliga källbehörigheter; den ger inte åtkomst till den underliggande datan. Se Connect Fabric Apps to Fabric data.

För data och tjänster utanför dessa anslutningar, använd funktioner för att anropa externa API:er och stödda Azure- och Fabric-resurser. Externa anslutningar använder appidentitetens behörigheter, medan åtkomst till appens databas via en funktion bevarar anroparens behörigheter. Behåll autentiseringsuppgifter och resurstokens på servern. Se Koppla funktioner till externa resurser.

När du ska använda Fabric-appar

Fabric Apps är perfekt för:

  • Snabb prototypframställning – Gå från idé till live-URL på några minuter med förkonfigurerad infrastruktur.
  • Interna verktyg och dashboards – Bygg autentiserade admingränssnitt utan att skriva backend-kodmall.
  • Datautforskning och visualisering – Använd kopplingar för att fråga stödda Fabric-dataobjekt och visa resultaten i anpassade frontends.
  • AI och agentapplikationer – Tillhandahåller strukturerade backend-tjänster för AI-agenter som behöver ett beständigt 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 inloggningsleverantörer utöver Fabric SSO efter implementering.

Säkerhetsansvar

Fabric tillhandahåller: Fabric Single Sign On (Microsoft Entra ID), säkerhet på radnivå via @role dekoratörer, HTTPS, PKCE samt behörigheter på arbetsyt- och objektnivå.

Du är ansvarig för:

  • Hålla hemligheter, API-nycklar och känsliga data borta från din kod, klientdelstillgångar och lagringsplats. Spara inte hemligheter i frontend-tillgångar, oavsett konfigurerad hostingåtkomst.
  • 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