Mikä on Fabric Apps (Preview)?

Fabric Apps (esikatselu) auttaa sinua rakentamaan dataohjattuja sovelluksia Microsoft Fabric -sovellukselle yhdistämällä datamallit, generoidut API:t, tunnistautumisen ja hostingin yhteen kehitystyönkulkuun. Määrittelet tietomallisi TypeScriptissä, ja Fabric Apps käyttää niitä tuottaakseen sovelluksesi tarvitsemat taustaosat. Fabric Apps tukee TypeScript kielenä datamalleille, asiakaskoodille ja sovelluslogiikaleelle.

Important

Tämä ominaisuus on esikatseluvaiheessa.

Tärkeimmät ominaisuudet

Fabric Apps tarjoaa seuraavat ominaisuudet:

• Datamallit API:ksi – Koristele TypeScript-luokat , @entity()@text(), @uuid(), ja muilla sisustajilla. Fabric Apps luo tietokantaskeemat ja GraphQL-päätepisteet automaattisesti.
• Tyyppiturvalliset asiakkaat – Asiakas-SDK validoi kyselyt ja mutaatiot ennen kuin ne saavuttavat taustajärjestelmän, ja havaitsee virheitä kehityksen aikana.
• Sisäänrakennettu tunnistautuminen – Istuntojen hallinta, tokenien käsittely ja todennusprosessit sisältyvät mukana. Määritä Fabric SSO käyttöönotetuille sovelluksille tai käytä sähköpostia ja salasanaa paikallisen kehityksen aikana.
• Staattinen isännöinti – Rakenna ja palvele frontend-sovellustasi yhdessä backend-API:idesi kanssa yhdellä käyttöönottokomennolla.
• Paikallinen kehitys – Aja koko pino paikallisesti Dockerilla nopeaa iterointia varten, ja ota Microsoft Fabric käyttöön, kun se on valmis tuotantoon. Scaffold-projektit, kehitä GitHub Copilot -ohjelmalla ja otetaan käyttöön Fabric-järjestelmässä Rayfin CLI:n avulla.

Tuetut alueet

Fabric-sovelluksia ei vielä ole saatavilla kaikilla alueilla. Katso tuetut alueet Fabric-sovellukselle saadaksesi lisätietoja.

Edellytykset

Fabric-kapasiteetti

Työtilassasi täytyy olla Fabric-kapasiteetti määritettynä. Kun luot uutta työtilaa, valitse Fabric-kapasiteetti, johon liitetään. Fabric Apps -palvelut käyttävät kapasiteettiyksiköitä määritetystä kapasiteetista.

Vuokralaisten ylläpitoasetukset

Fabric-vuokralaisen ylläpitäjän on otettava Fabric Apps -työkuorma käyttöön ennen kuin käyttäjät voivat luoda kohteita.

1. Kirjaudu Fabric hallintaportaaliin.
2. Siirry Vuokralaisasetuksiin.
3. Kohdasta Fabric Apps (preview) vaihda asetus Enabled.
4. Valitse, otetaanko se käyttöön koko organisaatiolle vai tietyille turvallisuusryhmille.
5. Valitse Käytä.

Muutosten leviäminen voi kestää muutaman minuutin.

Näin se toimii

Fabric-sovellus toimii hallittuna palveluna Microsoft Fabric -järjestelmässä, jossa on palveluita, jotka määrittävät taustajärjestelmän, kuten sovellusten isännöinti, tietokanta, GraphQL-rajapinnat ja todennus. Fabric hoitaa isännöinnin, verkottumisen ja skaalaamisen. Tunnistautuminen käyttää yksinomaan Fabric SSO:ta (Microsoft Entra ID single sign-on) – muita autentikointipalveluntarjoajia ei ole saatavilla käyttöönoton jälkeen.

Kun otat sovelluksesi käyttöön rayfin up:lla, Fabric luo lapsipalveluita rayfin.yml-konfiguraatiosi perusteella. Nämä lastensuojelut näkyvät lapsituotteina Fabric-sovelluksessa Fabric-portaalissa.

Lastenhoito	Mitä se tarjoaa	Portaalin ominaisuudet
SQL-tietokanta Fabricissa	Hallittu SQL-tietokanta, jossa skeemasi on sovellettu TypeScript-tietomallien koristelijoilta.	Näytä tietokanta, suorita kyselyt kyselyeditorilla, kopioi yhteysmerkkijono. Tietokanta on portaalissa vain luku -tilassa—skeemamuutokset täytyy tulla koodistasi kautta.rayfin up
Todennus	Fabric-välittäjän tunnistautuminen Microsoft Entra ID:n (SSO) avulla. Käyttäjät kirjautuvat sisään olemassa olevan Fabric-identiteettinsä kautta.	Katso autentikoidut käyttäjät SQL-tietokannassa.
Staattinen sisältö	Rakennetut frontend-assetit (HTML, CSS, JS) palvelivat julkisella URL-osoitteella OneLake-tallennustilalla.	Katso hosting-URL. Resurssit päivittyvät jokaisella käyttöönotolla.

App backend URL

Jokaisella Fabric-sovelluksella on yksi päätepiste, joka tarjoaa pääsyn kaikkiin palveluihin:

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

Päätepiste avaa polun jokaiselle palvelulle:

Polku	Huolto
/api/graphql	Data API (GraphQL) — käytetään luku- ja kirjoitusoperaatioihin RayfinClient
/auth	Tunnistautumispalvelu
/storage	Tiedostojen tallennustila

Hallinta Fabric-portaalissa

Käyttöönoton jälkeen voit hallita Fabric-sovellustasi suoraan Fabric-portaalissa.

Näytä kohteen ominaisuudet

Avaa Fabric-sovellus portaalissa nähdäksesi:

• App Backend URL — Tätä päätepistettä käytetään kaikille sovelluksen käyttämille backend-palveluille.
• Sovelluksen URL — Julkinen URL, jossa staattinen sisältösi isännöidään. Fabric SSO vaaditaan sovelluksen käyttämiseen.

Hallinnoi lapsikohteita

Valitse Fabric-sovellus nähdäksesi sen lastenpalvelut:

• SQL-tietokanta Fabric — Avaa Fabric SQL-tietokanta-alkion objektiresurssienhallinnan tarkasteluun. Voit ajaa lukukyselyitä dataasi vastaan. Skeeman muutokset tulisi aina tehdä kansion rayfin/data alla olevassa koodissa. Skeemaristiriitoja voi syntyä, jos skeemaa muutetaan suoraan SQL-tietokannassa, mikä voi rikkoa sovelluksen.

Kohteen käyttöoikeudet

Työtilan roolit eivät syrjäytä kohdetason oikeuksia. Sovelluksen jakamiseen organisaatiossasi tarvitaan Run and Interact -oikeudet (Read and Execute) sovelluksen ajamiseen ja backend-API:n käynnistämiseen.

Käyttöoikeus	Mitä se sallii
Aja ja vuorovaikutus (oletus)	Avaa ja käytä käytössä olevaa sovellusta. Kaikki työtilan jäsenet saavat tämän tason oletuksena.
Muokkaa (kirjoita)	Muokkaa Fabric-sovellusta—ota käyttöön koodi rayfin up:lla, sovella skeemamuutoksia, päivitä asetuksia ja hallinnoi lapsipalveluita.
Jaa uudelleen	Anna muille käyttäjille pääsy Fabric-sovellukseen. Vaatii ylläpitäjän roolin työtilassa.

Lue lisää työtilarooleista.

Kehitys Rayfin CLI:n kanssa

Komentokeskus rakentaa uusia projekteja, käynnistää paikallisen infrastruktuurin, synkronoi skeemamuutokset ja ottaa käyttöön Fabric. Asenna se .npm create @microsoft/rayfin@latest

Keskeiset komennot:

Komento	Käyttötarkoitus
npm create @microsoft/rayfin@latest	Luo uusi projekti mallipohjasta.
npx rayfin up	Lähetä projektisi Fabric-palveluun.
npx rayfin up db apply	Sovella tietokantaskeeman muutoksia.

Täydellisen komentoviitteen löydät CLI-viitteestä.

Tietomallien sisustajat

Määrittele tietomallit TypeScript-koristelijoilla:

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 analysoi näitä sisustajia ja tuottaa:

• Tietokantataulukon määritelmät
• GraphQL API -päätepisteet
• Rivitason valtuutussäännöt
• Tyyppiturvalliset asiakasmenetelmät

Milloin käyttää Fabric Appsia

Fabric Apps on ihanteellinen:

• Nopea prototyyppi – Siirry ideasta live-URL-osoitteeseen minuuteissa ennalta konfiguroidulla infrastruktuurilla.
• Sisäiset työkalut ja hallintapaneelit – Rakenna autentikoidut ylläpitäjän rajapinnat ilman backend-standardien kirjoittamista.
• Datan tutkimus ja visualisointi – Kysy Fabric dataa GraphQL:n kautta ja näytä se mukautetuissa käyttöliittymässä.
• Tekoäly- ja agenttisovellukset – Tarjoa jäsenneltyjä taustapalveluita tekoälyagenteille, jotka tarvitsevat pysyvää tilaa.

Fabric-sovellukset eivät välttämättä sovi seuraaviin tarkoituksiin:

• Sovellukset, jotka vaativat monimutkaisia monivaiheisia transaktioita tai tallennettuja prosesseja.
• Sovellukset, jotka vaativat räätälöityjä todennuspalveluita Fabric SSO:n ja sähköpostin/salasanan lisäksi.

Turvallisuusvastuut

Fabric tarjoaa: Fabric Single Sign on (Microsoft Entra ID), rivitason turvallisuuden @role sisustajien kautta, HTTPS, PKCE sekä työtila- ja tuotetason käyttöoikeudet.

Olet vastuussa seuraavista:

• Salaisuudet, API-avaimet ja arkaluonteiset tiedot pidetään poissa koodistasi, frontend-asseteistä ja arkistosta. Staattinen sisältö tarjotaan julkisesta URL-osoitteesta.
• Se, mitä sovelluksesi paljastaa Fabric SSO:n kautta, ohjaa kirjautumista, koska koodisi ohjaa, mitä todennetut käyttäjät näkevät ja tekevät.
• Myöntämällä vain ne oikeudet, joita käyttäjät tarvitsevat sovelluksen käyttöönottoon tai hallintaan.
• Oikeudellinen ja vaatimustenmukaisuuden vastuullisuus sovelluksesi keräämästä, käsittelemästä ja tallentamasta datasta.

Seuraavat vaiheet

• Luo ensimmäinen Fabric Apps -projektisi
• Määrittele tietomalleja koristelijoiden avulla
• Deploy Microsoft Fabric
• Todentamisen määrittäminen