Microsoft Fabric Apps: wat het is en hoe je ze gebruikt
By Mirko Peters ·
Fabric Apps (preview) laat ontwikkelaars datagedreven apps bouwen op Microsoft Fabric met TypeScript. Deze gids behandelt wat de functie is, de beheerschakelaar, hoe je een app maakt en uitrolt, machtigingen en de huidige beperkingen.
Automatically translated with AI from the original post. Read the English original
Fabric Apps is een Microsoft Fabric-functie, momenteel in preview, om datagedreven applicaties te bouwen. Ontwikkelaars schrijven datamodellen in TypeScript, en Fabric genereert het databaseschema, de GraphQL-API's, aanmelding en hosting. De functie is bedoeld voor ontwikkelaars, niet voor rapportauteurs, en staat los van Power BI-apps.
Belangrijkste punten
- Fabric Apps is een previewfunctie die is gebouwd op de Rayfin SDK. Ontwikkelaars definiëren datamodellen in TypeScript, en Fabric genereert de database, de GraphQL-API, verificatie en hosting.
- Een tenantbeheerder moet Fabric Apps (preview) eerst inschakelen onder Tenantinstellingen in het Fabric-beheerportaal, voor de hele organisatie of voor specifieke beveiligingsgroepen.
- De werkruimte moet met Fabric-capaciteit zijn verbonden. Fabric Apps-services verbruiken capaciteitseenheden daaruit.
- Na het uitrollen verloopt aanmelden uitsluitend via Fabric SSO met Microsoft Entra ID. E-mailadres en wachtwoord werken alleen voor lokale ontwikkeling.
- Microsoft noemt beperkingen zoals geen relaties van veel-op-veel, geen samengestelde sleutels, geen ALM en geen ondersteuning voor private link. Controleer die dus voordat je een ontwerp vastlegt.
Wat Fabric Apps doet
Microsoft Learn beschrijft Fabric Apps als gebouwd op de Rayfin SDK. Je voorziet TypeScript-classes van decorators, bijvoorbeeld @entity(), @text() of @uuid(). Op basis van dat model maakt Fabric:
- databasetabellen, met een SQL-database in Fabric als beheerde opslag
- een GraphQL-endpoint op
/api/graphqlbij de backend-URL van de app - regels voor autorisatie op rijniveau via
@role-decorators - typeveilige clientmethoden
- statische hosting voor de frontend
Wanneer je uitrolt met rayfin up, maakt Fabric onderliggende items onder de app aan: een SQL-database in Fabric, Authentication en Static Content. Elke app heeft één backend-endpoint in de vorm https://<your-app>-app.rayfin.windows.net/, met de paden /api/graphql voor data en /auth voor verificatie.
Andere gedocumenteerde mogelijkheden zijn getypeerde connectors naar een lakehouse, warehouse, SQL-database in Fabric of semantisch model, en getypeerde bestandsopslag met toegangsbeleid.
Waar het bij past
Microsoft noemt deze als goede toepassingen: snelle prototypes, interne tools en dashboards, dataverkenning met Fabric-connectors, en AI- of agent-apps die persistente status nodig hebben. Als mogelijk minder geschikt noemt het apps die complexe transacties in meerdere stappen of opgeslagen procedures nodig hebben, en apps die aangepaste verificatieproviders vereisen.
Stap 1: de tenantinstelling inschakelen
Dit is een beheertaak en moet gebeuren voordat gebruikers het item kunnen maken.
- Meld je aan bij het Fabric-beheerportaal.
- Open Tenantinstellingen.
- Zet onder Fabric Apps (preview) de schakelaar op Ingeschakeld.
- Kies de hele organisatie of specifieke beveiligingsgroepen.
- Selecteer Toepassen.
Het kan enkele minuten duren voordat wijzigingen zijn doorgevoerd.
Stap 2: de werkruimte voorbereiden
De werkruimte moet een Fabric-capaciteit toegewezen krijgen. Kies een capaciteit wanneer je de werkruimte maakt. Om een app te maken heb je het recht Inzender of Beheerder nodig in die werkruimte. Voor lokaal werk installeer je Node.js 20 of hoger.
Stap 3: Het app-item maken
- Selecteer in de linkernavigatie Werkruimten en open je werkruimte.
- Selecteer Nieuw item, zoek naar App en selecteer die.
- Voer een naam in en selecteer Maken.
Het portaal toont dan een opdracht om een project lokaal te downloaden. Die ziet er zo uit:
npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>
Stap 4: Ontwikkelen en implementeren
Pas het project aan of werk samen met GitHub Copilot en test vervolgens tegen de Fabric-backend met npm run dev. Implementeer met npx rayfin up. Om naar een andere werkruimte te implementeren, voeg je --workspace <workspacename> toe. Controleer de backend met npx rayfin up status.
In het voorbeeld in de FAQ staat dat een implementatie met alleen statische inhoud via npx rayfin up staticapp deploy na de eerste implementatie 30 tot 60 seconden duurt. De pagina's die ik heb gelezen, geven geen tijd voor de eerste implementatie. Een implementatie met alleen statische inhoud kan de initiële externe app niet aanmaken, dus voer eerst één keer npx rayfin up uit. Om terug te draaien, check je de eerdere git-commit uit en voer je opnieuw npx rayfin up uit.
Wat je ziet in het Fabric-portaal
Na rayfin up toont het app-item onderliggende items die Fabric heeft aangemaakt op basis van je rayfin.yml-configuratie:
- SQL-database in Fabric: de beheerde database met het schema uit je decorators. In het portaal is die alleen-lezen, dus wijzig het schema via code.
- Authenticatie: aanmelding via Fabric, verlopen via Microsoft Entra ID. Je kunt de geauthenticeerde gebruikers bekijken in de SQL-database.
- Statische inhoud: de gebouwde frontend-assets, geserveerd vanaf een hosting-URL en bij elke implementatie bijgewerkt. In het overzicht staat dat statische hosting toegang tot het Fabric-item kan vereisen of anonieme toegang kan toestaan.
Authenticatie en machtigingen
Learn noemt Fabric SSO voor gepubliceerde apps en e-mail en wachtwoord voor lokale ontwikkeling. Aanmelden met e-mail en wachtwoord werkt niet na implementatie, en voor implementatie moet Fabric-authenticatie zijn ingeschakeld.
Machtigingen voor items staan los van werkruimterollen:
| Machtiging | Staat toe | |---|---| | Uitvoeren en interacteren | De app openen en gebruiken en de backend-API's aanroepen. Alle leden van de werkruimte krijgen die standaard. | | Bewerken (schrijven) | Implementeren, schema wijzigen, instellingen bijwerken, onderliggende services beheren | | Opnieuw delen | Anderen toegang geven. Vereist de beheerdersrol in de werkruimte. |
Een Fabric-beheerder kan andere gebruikers tijdelijk blokkeren om een app te laden, terwijl de eigenaar hem nog wel kan openen.
Een deel van de beveiliging blijft bij jou. Microsoft adviseert geheimen uit code en frontend-assets te houden, en je code bepaalt wat aangemelde gebruikers zien en kunnen doen.
Beperkingen om eerst te controleren
De FAQ noemt de volgende huidige beperkingen:
- geen veel-op-veel-relaties en geen samengestelde primaire sleutels (elke entiteit heeft één UUID-veld met de naam
idnodig) - geen aangepaste verificatieproviders
- geen beheer van meerdere omgevingen standaard
- geen bescherming van uitgaande toegang voor de werkruimte
- geen privélinks op tenantniveau of werkruimteniveau
- geen application lifecycle management (ALM)
count()is niet beschikbaar op de fluent GraphQL-client
Datamodellen worden geschreven in TypeScript met decorators.
Veelvoorkomende problemen
Microsoft noemt een ontbrekende productiebuild als de meest voorkomende oorzaak van buildfouten, dus voer eerst npm run build uit. Bij fouten met capaciteit of machtigingen controleer je of de werkruimte capaciteit heeft en of je items in die werkruimte kunt maken of wijzigen. Bij schemafouten bekijk je de wijzigingen sinds de laatste geslaagde implementatie. De pagina over probleemoplossing zegt dat de appcode de bron van waarheid is. Wijzig het externe schema niet via het Fabric-portaal of SQL-hulpprogramma's, want het verwijderen of wijzigen van een bestaande kolom kan de app en de implementatie breken. Maak schemawijzigingen in code en pas ze toe met npx rayfin up db apply.
Gerelateerd
Bronnen
- Overzicht Fabric Apps (preview)
- Je eerste Fabric Apps-project maken
- Veelgestelde vragen over Fabric Apps
- Problemen met Fabric Apps oplossen
Veelgestelde vragen
Zijn Fabric Apps algemeen beschikbaar?
Nee. Microsoft Learn markeert Fabric Apps als previewfunctie en vermeldt dat de functie nog niet in alle regio's beschikbaar is. In de pagina's die voor dit artikel zijn gelezen, staat geen datum voor algemene beschikbaarheid.
Wie kan een Fabric-app maken?
Volgens Microsoft Learn heb je de machtiging Inzender of Beheerder nodig in een Fabric-werkruimte met Fabric-capaciteit, en moet een tenantbeheerder de tenantinstelling Fabric Apps (preview) hebben ingeschakeld. Voor lokale ontwikkeling is Node.js 20 of later vereist.
Welke aanmeldmethoden ondersteunen uitgerolde Fabric Apps?
Microsoft Learn zegt dat uitgerolde apps uitsluitend Fabric SSO gebruiken, dus eenmalige aanmelding via Microsoft Entra. Aanmelden met e-mailadres en wachtwoord is alleen beschikbaar voor lokale ontwikkeling, en je kunt niet uitrollen zonder dat verificatie is ingeschakeld.
Kan een Fabric-app een bestaande database gebruiken?
Nee. De veelgestelde vragen van Microsoft Learn melden dat Fabric Apps het schema beheert op basis van je TypeScript-modellen en niet kan verwijzen naar een database met een vooraf gedefinieerd schema. Om een bestaand lakehouse, warehouse of SQL-database in Fabric te bereiken, voeg je een connector toe.
Leggen de Microsoft-pagina's de prijzen van Fabric Apps uit?
Nee. In de gelezen pagina's staan geen prijzen. Het overzicht vermeldt alleen dat de werkruimte Fabric-capaciteit nodig heeft en dat Fabric Apps-services capaciteitseenheden uit die capaciteit verbruiken. De veelgestelde vragen zeggen dat de prestaties afhangen van je Fabric-capaciteit.