Čo je to Fabric Apps (Náhľad)?

Fabric Apps (náhľad) vám pomáha vytvárať dátovo riadené aplikácie na Microsoft Fabric kombinovaním dátových modelov, generovaných API, autentifikácie a hostingu v jednom vývojovom workflow. Svoje dátové modely definujete v TypeScripte a Fabric Apps ich používa na generovanie backendových komponentov, ktoré vaša aplikácia potrebuje. Fabric Apps podporuje TypeScript ako jazyk pre dátové modely, klientsky kód a aplikačnú logiku.

Dôležité

Táto funkcia je vo verzii Preview.

Kľúčové funkcie

Fabric Apps poskytuje tieto možnosti:

Dátové modely k API – Ozdobte triedy TypeScriptu , @entity()@text(), @uuid(), a ďalšími dekorátormi. Fabric Apps automaticky generuje databázové schémy a koncové body GraphQL.
Type-safe klienti – SDK klienta overuje dotazy a mutácie ešte predtým, než sa dostanú na backend, pričom počas vývoja zachytáva chyby.
Vstavaná autentifikácia – Správa relácií, spracovanie tokenov a autentifikačné toky sú zahrnuté. Nakonfigurujte Fabric SSO pre nasadené aplikácie alebo používajte e-mail a heslo počas lokálneho vývoja.
Statický hosting – Postavte a slúžite svoju frontendovú aplikáciu spolu s backendovými API jedným príkazom na nasadenie.
Lokálny vývoj – Spustiť celý stack lokálne s Dockerom pre rýchlu iteráciu, potom nasadiť na Microsoft Fabric, keď bude pripravený na produkciu. Scaffold projekty, vývoj s GitHub Copilot a nasadenie do Fabric pomocou Rayfin CLI.

Podporované regióny

Fabric aplikácie zatiaľ nie sú dostupné vo všetkých regiónoch. Viac informácií nájdete v podporovaných regiónoch pre Fabric App.

Predpoklady

Kapacita tkaniny

Váš pracovný priestor musí mať priradenú kapacitu Fabric. Pri vytváraní nového pracovného priestoru vyberte Fabric kapacitu, ktorú s ním priradíte. Služby Fabric Apps spotrebovávajú kapacitné jednotky z pridelenej kapacity.

Nastavenia administrátora nájomcu

Administrátor nájomcu Fabric musí povoliť záťaž Fabric Apps predtým, než môžu používatelia vytvárať položky.

Prihláste sa do Fabric administrátorského portálu.
Prejdite do nastavení nájomcu.
V sekcii Fabric Apps (náhľad) prepnite nastavenie na Enabled.
Vyberte si, či povolíte pre celú organizáciu alebo pre konkrétne bezpečnostné skupiny.
Vyberte Použiť.

Zmeny môžu trvať niekoľko minút, kým sa rozšíria.

Ako to funguje

Aplikácia Fabric beží ako spravovaná služba v Microsoft Fabric s balíkom služieb, ktoré definujú backend, ako sú hosting aplikácií, databáza, GraphQL API a autentifikácia. Fabric spravuje hosting, sieťovanie a škálovanie. Autentifikácia používa výhradne Fabric SSO (Microsoft Entra ID single sign-on) – po nasadení nie sú k dispozícii žiadni iní poskytovatelia autentifikacie.

Keď nasadíte svoju aplikáciu s rayfin up, Fabric vytvorí detské služby na základe vašej konfigurácie rayfin.yml. Tieto detské služby sa zobrazujú ako detské položky v aplikácii Fabric v portáli Fabric.

Starostlivosť o deti	Čo poskytuje	Možnosti portálu
Databáza SQL v službe Fabric	Spravovaná SQL databáza s vašou schémou aplikovanou od TypeScript data model decorators.	Zobraziť databázu, spúšťať dotazy v editore dotazov, kopírovať connection string. Databáza je v portáli len na čítanie – zmeny schémy musia pochádzať z vášho kódu cez `rayfin up`.
Overovanie	Fabric sprostredkovaná autentifikácia pomocou Microsoft Entra ID (SSO). Používatelia sa prihlasujú cez svoju existujúcu Fabric identitu.	Zobraziť overených používateľov v SQL databáze.
Statický obsah	Vaše vytvorené frontend assety (HTML, CSS, JS) boli poskytované na verejnej URL cez OneLake storage.	Zobraziť hostingovú URL. Zdroje sa aktualizujú pri každom nasadení.

Backend URL aplikácie

Každá Fabric aplikácia má jeden endpoint, ktorý poskytuje prístup ku všetkým službám:

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

Koncový bod vystavuje cestu pre každú službu:

Cesta	Služba
`/api/graphql`	Dátové API (GraphQL) — používané `RayfinClient` pre operácie čítania a zápisu
`/auth`	Autentifikačná služba
`/storage`	Ukladanie súborov

Správa v portáli Fabric

Po nasadení môžete spravovať svoju Fabric aplikáciu priamo v Fabric portáli.

Zobraziť vlastnosti predmetu

Otvorte aplikáciu Fabric v portáli a pozrite si:

App Backend URL — Tento endpoint sa používa pre všetky backendové služby používané aplikáciou.
URL aplikácie — Verejná URL, kde je váš statický obsah hostovaný. Na prístup k aplikácii je potrebné Fabric SSO.

Správa detských položiek

Vyberte aplikáciu Fabric a pozrite si jej detské služby:

SQL databáza v Fabric — Otvorí položku Fabric SQL Database na zobrazenie objektového prieskumníka. Môžeš spúšťať čítané dotazy na svojich dátach. Zmeny schémy by sa mali vždy robiť v kóde v priečinku rayfin/data . Konflikty schémy môžu vzniknúť, ak sa schéma zmení priamo v SQL databáze, a môžu aplikáciu pokaziť.

Povolenia pre položku

Úlohy v pracovnom priestore neprekrývajú oprávnenia na úrovni položiek. Na zdieľanie aplikácie s niekým vo vašej organizácii potrebujú povolenie na spustenie a interakciu (čítanie a vykonávanie) na spustenie aplikácie a vyvolanie backend API.

Povolenie	Čo to umožňuje
Spustiť a interagovať (predvolené)	Otvorte a používajte nasadenú aplikáciu. Všetci členovia pracovného priestoru dostávajú túto úroveň štandardne.
Upraviť (napísať)	Upravujte Fabric aplikáciu – nasadzujte kód pomocou `rayfin up`, aplikujte zmeny schémy, aktualizujte nastavenia a spravujte podriadené služby.
Opakované zdieľanie	Umožniť ostatným používateľom prístup k aplikácii Fabric. Vyžaduje administrátorskú úlohu v pracovnom priestore.

Zistite viac o pracovných pozíciách.

Vývoj s Rayfin CLI

CLI podporuje nové projekty, spúšťa lokálnu infraštruktúru, synchronizuje zmeny schémy a nasadzuje sa do Fabric. Nainštalujte ho pomocou npm create @microsoft/rayfin@latest.

Kľúčové príkazy:

Príkaz	Purpose
`npm create @microsoft/rayfin@latest`	Vytvorte nový projekt zo šablóny.
`npx rayfin up`	Nasadte svoj projekt na Fabric.
`npx rayfin up db apply`	Aplikujte zmeny v databázovej schéme.

Pre kompletný odkaz na príkazy pozri referenciu CLI.

Dekorátori dátových modelov

Definujte dátové modely pomocou dekorátorov TypeScript:

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 analyzuje týchto dekoratérov a generuje:

Definície databázových tabuliek
Endpointy GraphQL API
Pravidlá autorizácie na úrovni riadkov
Typovo bezpečné klientské metódy

Kedy používať Fabric Apps

Fabric Apps je ideálny pre:

Rýchle prototypovanie – Prejdite od nápadu k živej URL za pár minút s prednastavenou infraštruktúrou.
Interné nástroje a dashboardy – Vytvárajte autentifikované administrátorské rozhrania bez písania backendových šablón.
Prieskum a vizualizácia dát – Dotazujte Fabric dáta cez GraphQL a zobrazte ich v vlastných frontendoch.
AI a aplikácie agentov – Poskytujú štruktúrované backendové služby pre AI agentov, ktorí potrebujú trvalý stav.

Fabric Apps nemusia byť vhodné pre:

Aplikácie vyžadujúce zložité viacstupňové transakcie alebo uložené procedúry.
Aplikácie vyžadujúce vlastné autentifikačné služby nad rámec Fabric SSO a e-mailu/hesla.

Bezpečnostné zodpovednosti

Fabric poskytuje: Fabric Single Sign on (Microsoft Entra ID), bezpečnosť na úrovni riadkov prostredníctvom @role dekorátorov, HTTPS, PKCE a oprávnenia na úrovni pracovného priestoru a položky.

Ste zodpovedný za:

Udržiavanie tajomstiev, API kľúčov a citlivých údajov mimo vášho kódu, frontendových aktív a repozitára. Statický obsah je zobrazovaný z verejnej URL adresy.
To, čo vaša aplikácia zverejňuje cez Fabric SSO, riadi prihlásenie, pretože váš kód kontroluje, čo autentifikovaní používatelia vidia a robia.
Udeľovanie len oprávnení, ktoré prispievatelia potrebujú na nasadenie alebo správu aplikácie.
Právna a súladová zodpovednosť za dáta, ktoré vaša aplikácia zbiera, spracováva a ukladá.

Ďalšie kroky

Pripomienky

Bola táto stránka užitočná?

Last updated on 2026-06-02