M365Con 2027 – conferenza online gratuita · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Microsoft Fabric Apps: cosa sono e come usarle

Di ·

Fabric Apps (anteprima) permette agli sviluppatori di creare app basate sui dati su Microsoft Fabric con TypeScript. Questa guida spiega cos'è la funzionalità, l'interruttore di amministrazione, come creare e distribuire un'app, le autorizzazioni e i limiti attuali.

Tradotto automaticamente con l'IA dal post originale. Leggi l'originale in inglese

Fabric Apps è una funzionalità di Microsoft Fabric, attualmente in anteprima, per creare applicazioni basate sui dati. Gli sviluppatori scrivono i modelli dei dati in TypeScript e Fabric genera lo schema del database, le API GraphQL, l'accesso e l'hosting. È pensata per gli sviluppatori, non per gli autori di report, e non coincide con le app di Power BI.

Punti chiave

  • Fabric Apps è una funzionalità in anteprima basata sull'SDK Rayfin. Gli sviluppatori definiscono i modelli dei dati in TypeScript e Fabric genera il database, l'API GraphQL, l'autenticazione e l'hosting.
  • Un amministratore del tenant deve prima abilitare Fabric Apps (anteprima) in Impostazioni tenant nell'interfaccia di amministrazione di Fabric, per l'intera organizzazione o per gruppi di sicurezza specifici.
  • All'area di lavoro deve essere assegnata una capacità Fabric. I servizi di Fabric Apps consumano da essa unità di capacità.
  • Dopo la distribuzione, l'accesso avviene esclusivamente tramite Fabric SSO con Microsoft Entra ID. Email e password funzionano solo per lo sviluppo locale.
  • Microsoft elenca limiti come l'assenza di relazioni molti-a-molti, di chiavi composte, di ALM e di supporto a private link, quindi verificali prima di impegnarti su una progettazione.

Cosa fa Fabric Apps

Microsoft Learn descrive Fabric Apps come basata sull'SDK Rayfin. Si decorano le classi TypeScript, per esempio con @entity(), @text() o @uuid(). Da questo modello Fabric produce:

  • tabelle del database, con un database SQL in Fabric come archivio gestito
  • un endpoint GraphQL in /api/graphql sull'URL di backend dell'app
  • regole di autorizzazione a livello di riga tramite i decoratori @role
  • metodi client con tipizzazione sicura
  • hosting statico per il frontend

Quando distribuisci con rayfin up, Fabric crea elementi figlio sotto l'app: un database SQL in Fabric, Authentication e Static Content. Ogni app ha un unico endpoint di backend nel formato https://<your-app>-app.rayfin.windows.net/, con i percorsi /api/graphql per i dati e /auth per l'autenticazione.

Tra le altre funzionalità documentate ci sono i connettori tipizzati verso un lakehouse, un warehouse, un database SQL in Fabric o un modello semantico, e l'archiviazione tipizzata dei file con criteri di accesso.

Quando è adatta

Microsoft indica come casi adatti: prototipazione rapida, strumenti interni e dashboard, esplorazione dei dati con i connettori di Fabric, e app di IA o agent che richiedono uno stato persistente. Indica come possibili casi non adatti: app che richiedono transazioni complesse a più passaggi o stored procedure, e app che richiedono provider di autenticazione personalizzati.

Passaggio 1: abilita l'impostazione tenant

Si tratta di un'attività amministrativa, da completare prima che gli utenti possano creare l'elemento.

  1. Accedi all'interfaccia di amministrazione di Fabric.
  2. Apri Impostazioni tenant.
  3. In Fabric Apps (anteprima), imposta l'interruttore su Abilitato.
  4. Scegli l'intera organizzazione oppure gruppi di sicurezza specifici.
  5. Seleziona Applica.

Le modifiche potrebbero richiedere alcuni minuti per essere applicate.

Passaggio 2: prepara l'area di lavoro

L'area di lavoro deve avere una capacità Fabric assegnata. Scegli una capacità quando crei l'area di lavoro. Per creare un'app servono le autorizzazioni di Collaboratore o Amministratore al suo interno. Per il lavoro in locale, installa Node.js 20 o versione successiva.

Passaggio 3: crea l'elemento app

  1. Nella navigazione a sinistra, seleziona Aree di lavoro e apri la tua area di lavoro.
  2. Seleziona Nuovo elemento, cerca App e selezionala.
  3. Inserisci un nome e seleziona Crea.

Il portale mostra quindi un comando per scaricare localmente un progetto. Ha questa forma:

npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>

Passaggio 4: sviluppa e distribuisci

Modifica il progetto oppure lavora con GitHub Copilot, quindi testalo sul backend di Fabric con npm run dev. Esegui il deployment con npx rayfin up. Per distribuire in un'altra area di lavoro, aggiungi --workspace <workspacename>. Verifica il backend con npx rayfin up status.

Il commento di esempio nelle Domande frequenti indica che un deployment solo di contenuti statici con npx rayfin up staticapp deploy richiede da 30 a 60 secondi dopo il deployment iniziale. Le pagine lette non indicano alcun tempo per il primo deployment. Un deployment solo statico non può creare l'app remota iniziale, quindi esegui prima una volta npx rayfin up. Per tornare indietro, passa al commit git precedente ed esegui di nuovo npx rayfin up.

Cosa vedi nel portale Fabric

Dopo rayfin up, l'elemento app mostra gli elementi figli che Fabric ha creato dalla configurazione in rayfin.yml:

  • Database SQL in Fabric: il database gestito con lo schema definito dai tuoi decorator. Nel portale è di sola lettura, quindi modifica lo schema tramite codice.
  • Autenticazione: accesso gestito da Fabric tramite Microsoft Entra ID. Puoi visualizzare gli utenti autenticati nel database SQL.
  • Contenuto statico: gli asset compilati del frontend, serviti da un URL di hosting e aggiornati a ogni deployment. La panoramica indica che l'hosting statico può richiedere l'accesso all'elemento Fabric oppure consentire l'accesso anonimo.

Autenticazione e autorizzazioni

Learn elenca l'SSO di Fabric per le app distribuite e l'email e password per lo sviluppo locale. L'accesso con email e password non funziona dopo il deployment, e il deployment richiede che l'autenticazione Fabric sia abilitata.

Le autorizzazioni per gli elementi sono separate dai ruoli dell'area di lavoro:

| Autorizzazione | Consente | |---|---| | Esecuzione e interazione | Aprire e usare l'app e richiamare le relative API di backend. Tutti i membri dell'area di lavoro la ottengono per impostazione predefinita. | | Modifica (Scrittura) | Eseguire il deployment, modificare lo schema, aggiornare le impostazioni, gestire i servizi figlio | | Ricondivisione | Concedere ad altri l'accesso. Richiede il ruolo di amministratore nell'area di lavoro. |

Un amministratore di Fabric può bloccare temporaneamente il caricamento dell'app ad altri utenti, mentre il proprietario può comunque aprirla.

La sicurezza resta in parte a tua carico. Microsoft consiglia di tenere i segreti fuori dal codice e dagli asset del frontend, e il tuo codice decide cosa possono vedere e fare gli utenti autenticati.

Limiti da verificare per primi

Le Domande frequenti elencano questi limiti attuali:

  • nessuna relazione molti-a-molti e nessuna chiave primaria composta (ogni entità richiede un unico campo UUID chiamato id)
  • nessun provider di autenticazione personalizzato
  • nessuna gestione multi-ambiente predefinita
  • nessuna protezione dell'accesso in uscita a livello di area di lavoro
  • nessun private link a livello di tenant o di area di lavoro
  • nessuna gestione del ciclo di vita dell'applicazione (ALM)
  • count() non è disponibile sul client GraphQL fluent

I modelli di dati sono scritti in TypeScript con decorator.

Problemi tipici

Microsoft indica la mancanza di una build di produzione come la causa più comune degli errori di build, quindi esegui prima npm run build. Per gli errori di capacità o autorizzazione, verifica che l'area di lavoro abbia una capacità e che tu possa creare o modificare elementi al suo interno. Per gli errori di schema, controlla le modifiche apportate dall'ultimo deployment riuscito. La pagina di risoluzione dei problemi indica che il codice dell'app è la fonte di riferimento. Non modificare lo schema remoto dal portale Fabric o con strumenti SQL, perché rimuovere o alterare una colonna esistente può compromettere l'app e il relativo deployment. Apporta le modifiche allo schema nel codice e applicale con npx rayfin up db apply.

Correlati

Fonti

FAQ

Fabric Apps è disponibile a livello generale?

No. Microsoft Learn indica Fabric Apps come funzionalità in anteprima e precisa che non è ancora disponibile in tutte le aree geografiche. Nelle pagine consultate per questo articolo non è indicata una data di disponibilità generale.

Chi può creare un'app Fabric?

Secondo Microsoft Learn, serve l'autorizzazione Collaboratore o Amministratore in un'area di lavoro Fabric con capacità Fabric, e un amministratore del tenant deve aver abilitato l'impostazione tenant Fabric Apps (anteprima). Per lo sviluppo locale è richiesto Node.js 20 o versione successiva.

Quali metodi di accesso supportano le app Fabric distribuite?

Microsoft Learn precisa che le app distribuite usano esclusivamente Fabric SSO, ovvero l'accesso singolo di Microsoft Entra. L'accesso con indirizzo email e password è disponibile solo per lo sviluppo locale, e non è possibile distribuire un'app senza l'autenticazione abilitata.

Un'app Fabric può usare un database esistente?

No. Le domande frequenti di Microsoft Learn spiegano che Fabric Apps gestisce lo schema a partire dai modelli TypeScript e non può puntare a un database con uno schema predefinito. Per accedere a un lakehouse, un warehouse o un database SQL esistenti in Fabric, occorre aggiungere un connettore.

Le pagine Microsoft spiegano i prezzi di Fabric Apps?

No. Le pagine consultate non riportano alcun prezzo. La panoramica si limita a indicare che l'area di lavoro richiede capacità Fabric e che i servizi di Fabric Apps consumano unità di capacità da essa, mentre le domande frequenti precisano che le prestazioni dipendono dalla capacità Fabric.

Entità in questo articolo

Temi di questo articolo:

Microsoft Fabric Apps – Strumento di analisi e BI di Microsoft Microsoft Fabric – Strumento di analisi e BI di Microsoft Fabric capacity – Concetto Fabric tenant settings – Concetto

Articoli correlati

Altri articoli su Microsoft Fabric:

RSS