Mi az Fabric-alkalmazások (előzetes verzió)?

Fabric Alkalmazások (előzetes verzió) adatvezérelt alkalmazásokat hozhat létre Microsoft Fabric az adatmodellek, a létrehozott API-k, a hitelesítés és az üzemeltetés egyetlen fejlesztési munkafolyamatban való kombinálásával. Az adatmodelleket TypeScriptben határozhatja meg, és Fabric alkalmazások az alkalmazás által igényelt háttéregységek létrehozásához használják őket. A Fabric Apps a TypeScriptet támogatja az adatmodellek, az ügyféloldali kód és az alkalmazáslogika nyelveként.

Important

Ez a funkció előzetes verzióban érhető el.

Legfontosabb funkciók

Fabric Alkalmazások a következő képességeket nyújtják:

• Adatmodellek API-khoz – TypeScript-osztályok dekorálása , @entity(), @text()és más dekorátorok használatával@uuid(). Fabric Alkalmazások automatikusan létrehoznak adatbázissémákat és GraphQL-végpontokat.
• Típusbiztos ügyfelek – Az ügyféloldali SDK ellenőrzi a lekérdezéseket és a mutációkat, mielőtt elérnék a háttérrendszert, és észlelik a fejlesztés során előforduló hibákat.
• Beépített hitelesítés – A munkamenet-kezelés , a jogkivonatkezelés és a hitelesítési folyamatok is szerepelnek benne. Konfigurálja Fabric SSO-t az üzembe helyezett alkalmazásokhoz, vagy használjon e-mailt és jelszót a helyi fejlesztés során.
• Statikus üzemeltetés – Egyetlen üzembehelyezési paranccsal hozhatja létre és szolgálhatja ki az előtéralkalmazást a háttér API-k mellett.
• Helyi fejlesztés – Futtassa helyben a teljes stacket Dockerrel a gyors iterációhoz, majd helyezze üzembe a Microsoft Fabricben, amikor készen áll az éles környezetre. Projektvázak létrehozása, fejlesztés a GitHub Copilottal, és telepítés a Fabricre a Rayfin CLI használatával.

Támogatott régiók

Fabric Alkalmazások még nem érhetők el minden régióban. További információért tekintse meg a támogatott régiókat Fabric alkalmazáshoz.

Prerequisites

Szövetkapacitás

A munkaterülethez hozzá kell rendelni Fabric kapacitást. Új munkaterület létrehozásakor válasszon ki egy Fabric kapacitást, amellyel társítani szeretné. Fabric Apps-szolgáltatások kapacitásegységeket használnak fel a hozzárendelt kapacitásból.

Bérlői rendszergazdai beállítások

A Fabric bérlői rendszergazdának engedélyeznie kell a Fabric Apps számítási feladatát, mielőtt a felhasználók elemeket hozhatnak létre.

1. Jelentkezzen be a Fabric felügyeleti portálra.
2. Navigáljon a bérlői beállításokhoz.
3. A Fabric Alkalmazások (előzetes verzió) területen állítsa a beállítást Enabled értékre.
4. Adja meg, hogy a teljes szervezethez vagy adott biztonsági csoportokhoz engedélyezve legyen-e.
5. Válassza az Alkalmazás lehetőséget.

A módosítások propagálása eltarthat néhány percig.

Hogyan működik?

Egy Fabric-alkalmazás felügyelt szolgáltatásként fut a Microsoft Fabricben, egy olyan szolgáltatáscsomaggal, amely meghatározza a háttérrendszert, például az alkalmazásüzemeltetést, az adatbázist, a GraphQL API-kat és a hitelesítést. Fabric kezeli az üzemeltetést, a hálózatkezelést és a skálázást. A hitelesítés kizárólag Fabric egyszeri bejelentkezést (Microsoft Entra ID egyszeri bejelentkezést) használ – az üzembe helyezés után más hitelesítésszolgáltatók nem érhetők el.

Amikor az alkalmazást a rayfin up használatával telepíti, Fabric a rayfin.yml konfigurációja alapján hoz létre gyermekszolgáltatásokat. Ezek a gyermekszolgáltatások gyermekelemként jelennek meg a Fabric portál Fabric alkalmazásában.

Gyermekszolgáltatás	Mit nyújt?	A portál képességei
SQL-adatbázis a Fabricben	Menedzselt SQL-adatbázis, amelynek sémája a TypeScript-adatmodell dekorátorai alapján kerül alkalmazásra.	Adatbázis megtekintése, lekérdezések futtatása a lekérdezésszerkesztővel, kapcsolati karakterlánc másolása. Az adatbázis a portálon csak olvasható – a sémamódosításokat a kódból, rayfin up használatával kell elvégezni.
Authentication	Fabric közvetített hitelesítés Microsoft Entra ID (SSO) használatával. A felhasználók a meglévő Fabric identitásukon keresztül jelentkeznek be.	Hitelesített felhasználók megtekintése az SQL-adatbázisban.
Statikus tartalom	Az elkészült frontend-erőforrásai (HTML, CSS, JS) nyilvános URL-en érhetők el a OneLake-tároló használatával.	Az üzemeltetési URL-cím megtekintése. Az eszközök minden üzembe helyezéskor frissülnek.

Alkalmazás háttérrendszerének URL-címe

Minden Fabric alkalmazás egyetlen végpontot tartalmaz, amely minden szolgáltatáshoz hozzáférést biztosít:

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

A végpont minden szolgáltatáshoz elérhetővé tesz egy elérési utat:

Útvonal	Service
/api/graphql	Data API (GraphQL) – olvasási és írási műveletekhez használható RayfinClient
/auth	Hitelesítési szolgáltatás
/storage	Fájl tárolás

Felügyelet a Fabric portálon

Az üzembe helyezés után az Fabric alkalmazást közvetlenül a Fabric portálon kezelheti.

Elemtulajdonságok megtekintése

Nyissa meg a Fabric alkalmazást a portálon a következő megtekintéséhez:

• Alkalmazás háttérrendszerÉNEK URL-címe – Ez a végpont az alkalmazás által használt összes háttérszolgáltatáshoz használatos.
• Alkalmazás URL-címe – Az a nyilvános URL-cím, ahol a statikus tartalom található. A Fabric egyszeri bejelentkezése szükséges az alkalmazás eléréséhez.

Gyermekelemek kezelése

Válassza ki a Fabric alkalmazást a gyermekszolgáltatások megtekintéséhez:

• SQL-adatbázis Fabric – Megnyitja a Fabric SQL Database-elemet az objektumkezelő megtekintéséhez. Olvasási lekérdezéseket futtathat az adatokon. A sémamódosításokat mindig a mappában rayfin/data lévő kódban kell végrehajtani. Sémaütközések akkor fordulhatnak elő, ha a séma közvetlenül módosul az SQL Database-ben, és megszakíthatja az alkalmazást.

Elemengedélyek

A munkaterületi szerepkörök nem helyettesítik az elemszintű engedélyeket. Ha meg szeretne osztani egy alkalmazást a szervezet egyik munkatársával, futtatási és interakciós engedélyre (olvasásra és végrehajtásra) van szüksége az alkalmazás futtatásához és a háttér API-k meghívásához.

Engedély	Mit tesz lehetővé?
Futtatás és interakció (alapértelmezett)	Nyissa meg és használja az üzembe helyezett alkalmazást. Alapértelmezés szerint minden munkaterület-tag megkapja ezt a szintet.
Szerkesztés (írás)	Módosítsa a Fabric alkalmazást – telepítse a kódot a rayfin up használatával, alkalmazza a sémamódosításokat, frissítse a beállításokat és kezelje a gyermekszolgáltatásokat.
Újramegosztás	Hozzáférést biztosíthat más felhasználóknak a Fabric alkalmazáshoz. Rendszergazdai szerepkört igényel a munkaterületen.

További információ a munkaterületi szerepkörökről.

Fejlesztés a Rayfin parancssori felülettel

A parancssori felület új projekteket hoz létre, elindítja a helyi infrastruktúrát, szinkronizálja a sémamódosításokat, és üzembe helyezi a Fabric. Telepítse a(z) npm create @microsoft/rayfin@latest használatával.

Fő parancsok:

Parancs	Alkalmazás célja
npm create @microsoft/rayfin@latest	Új projekt létrehozása sablonból.
npx rayfin up	Telepítse projektjét a Fabricbe.
npx rayfin up db apply	Adatbázisséma-módosítások alkalmazása.

A parancsok teljes referenciájának megtekintéséhez tekintse meg a parancssori felületre vonatkozó hivatkozást.

Adatmodell-dekorátorok

Adatmodellek definiálása TypeScript-dekorátorok használatával:

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 elemzi ezeket a dekorátorokat, és létrehozza a következőt:

• Adatbázistábla-definíciók
• GraphQL API-végpontok
• Sorszintű engedélyezési szabályok
• Típusbiztos ügyfélmódszerek

Mikor érdemes használni a Fabric-alkalmazásokat?

Fabric Alkalmazások a következőkhöz ideálisak:

• Gyors prototípus-készítés – Lépés az ötlettől az élő URL-címig percek alatt előre konfigurált infrastruktúrával.
• Belső eszközök és irányítópultok – Hozzon létre hitelesítéssel védett adminisztrációs felületeket anélkül, hogy backend-sablonkódot kellene írnia.
• Adatfeltárás és vizualizáció – Fabric-adatok lekérdezése GraphQL-en keresztül, és megjelenítésük egyéni felhasználói felületeken.
• AI- és ügynökalkalmazások – Strukturált háttérszolgáltatásokat biztosít az állandó állapotot igénylő AI-ügynökök számára.

Fabric Alkalmazások nem feltétlenül alkalmasak a következő célokra:

• Összetett többlépéses tranzakciókat vagy tárolt eljárásokat igénylő alkalmazások.
• Olyan alkalmazások, amelyek Fabric egyszeri bejelentkezésen és e-mailen/jelszón túl egyéni hitelesítésszolgáltatókat igényelnek.

Biztonsági felelősségek

A Fabric a következőket biztosítja: egyszeri bejelentkezést a Microsoft Entra ID-val, sorszintű biztonságkezelést a(z) @role dekorátorokkal, HTTPS-t, PKCE-t, valamint munkaterület- és elemszintű jogosultságokat.

Ön a felelős a következőért:

• Titkos kulcsok, API-kulcsok és bizalmas adatok megtartása a kódból, az előtérbeli objektumokból és az adattárból. A statikus tartalom nyilvános URL-címről lesz kiszolgálva.
• Amit az alkalmazás Fabric SSO-val tesz elérhetővé, az szabályozza a bejelentkezést, mivel a kód szabályozza, hogy a hitelesített felhasználók mit látnak és tegyenek.
• Csak a közreműködők engedélyeinek megadása szükséges az alkalmazás üzembe helyezéséhez vagy kezeléséhez.
• Az alkalmazás által gyűjtött, feldolgozható és tárolt adatok jogi és megfelelőségi elszámoltathatósága.

Következő lépések

• Az első Fabric Apps-projekt létrehozása
• Adatmodellek definiálása dekorátorokkal
• Üzembe helyezés a Microsoft Fabric
• Hitelesítés konfigurálása