Cosa sono le Fabric Apps?

Fabric Apps è costruito sull'SDK di Rayfin e consente agli sviluppatori di creare applicazioni basate sui dati su Fabric utilizzando un flusso di lavoro di sviluppo unificato. Gli sviluppatori definiscono modelli di dati in TypeScript e Fabric App genera automaticamente API, gestisce l'autenticazione, fornisce l'hosting e si integra con i servizi di Fabric. Fabric App supporta TypeScript per modelli di dati, codice client e logica dell'applicazione. Altre informazioni sono disponibili nella panoramica di Rayfin SDK.

Funzionalità principali

Fabric App offre queste funzionalità:

  • Modelli dati in API – Decora le classi TypeScript con @entity(), @text(), @uuid() e altri decoratori. Fabric App genera automaticamente schemi di database ed endpoint GraphQL.
  • Funzioni lato server - Esegui la logica TypeScript sul server e chiamala dal tuo frontend tramite il client digitato. Accedi ai dati dell'app, lavora con segreti e chiama API esterne. Vedi Usa le funzioni nelle app Fabric.
  • Porta i tuoi dati con i connettori - Aggiungi accesso tipizzato a un lakehouse, data warehouse, database SQL in Fabric o modello semantico esistente. Le operazioni supportate dipendono dal connettore. Vedi Collegare le app Fabric ai dati Fabric.
  • Archiviazione file - Definisci cartelle tipizzate, controlla l'accesso con policy autenticate e carica, scarica, elenca ed elimina file in Fabric. Vedi Archivia e gestisci i file.
  • Client a sicurezza di tipo – L'SDK del client valida query e mutazioni prima che arrivino al backend, rilevando errori durante lo sviluppo.
  • Autenticazione integrata – Sono inclusi la gestione delle sessioni, la gestione dei token e i flussi di autenticazione. Configurare Fabric SSO per le applicazioni distribuite o usare la posta elettronica e la password durante lo sviluppo locale.
  • Hosting statico – Costruisci e servi la tua applicazione frontend insieme alle API backend. Richiedere l'accesso agli elementi Fabric o consentire l'accesso anonimo agli asset ospitati.
  • Flusso di lavoro di sviluppo - Crea la struttura dei progetti, sviluppa con GitHub Copilot o altri agenti di programmazione e distribuisci su Fabric usando la CLI Rayfin. Utilizza i servizi basati su Fabric durante lo sviluppo o Docker per i servizi locali supportati. L'archiviazione dei file utilizza lo storage Fabric sia nello sviluppo che nel deployment.

Regioni supportate

Per la disponibilità regionale, consulta Disponibilità di Fabric per area geografica.

Prerequisiti

Licenza e area di lavoro

I requisiti dello spazio di lavoro dipendono dall'opzione di licenza della tua app:

  • Per un'app con capacità supportata, assegna capacità Fabric o una capacità di prova attiva di Fabric all'area di lavoro. I servizi app consumano unità di capacità da quella capacità.
  • Per l'esperienza Power BI Pro, utilizza un'area di lavoro Pro. Non è necessario assegnare la capacità Fabric. Si applicano i limiti di Power BI Pro.

Per i requisiti di licenza, vedi Scegli un'opzione di licenza per le app Fabric. Per creare un'app con una delle due opzioni, segui Crea un'app dal portale.

Impostazioni di amministrazione del tenant

Un amministratore tenant Fabric deve abilitare il carico di lavoro app Fabric prima che gli utenti possano creare elementi.

  1. Accedere al portale di amministrazione di Fabric.
  2. Passa a Impostazioni del tenant.
  3. In Fabric Apps, imposta l'impostazione su Abilitato.
  4. Scegliere se abilitare per l'intera organizzazione o gruppi di sicurezza specifici.
  5. Seleziona Applica.

La propagazione delle modifiche potrebbe richiedere alcuni minuti.

Come funziona

Un'app Fabric unisce hosting frontend e servizi backend gestiti. Il tuo frontend utilizza il client Rayfin per accedere alle API dei dati, invocare funzioni, gestire file e interrogare i dati collegati. Fabric gestisce l'hosting, la rete e il ridimensionamento. Le app distribuite utilizzano Fabric SSO (Microsoft Entra ID single sign-on) per l'autenticazione utente; altri provider di accesso non sono disponibili dopo la distribuzione.

Screenshot che mostra il servizio gestito e i componenti dell'app Fabric.

Quando si distribuisce con la CLI Rayfin, Fabric predispone o aggiorna i servizi abilitati in rayfin.yml. Scegli i servizi di cui la tua app ha bisogno:

Service Elementi forniti
API Data e GraphQL Dati strutturati di app in un database SQL in Fabric, con schemi e API generati dai tuoi modelli dati TypeScript e dalle regole di autorizzazione.
Functions Logica TypeScript lato server esposta tramite endpoint HTTP richiamabili, con chiamate client tipate e accesso ai dati dell'app e ai servizi esterni.
L'archiviazione dei file Storage supportato da OneLake per documenti, immagini e allegati, con cartelle tipizzate e regole di accesso autenticate. Lo storage richiede il servizio Data.
Authentication Fabric SSO per le app distribuite, così gli utenti accedono con la loro identità Fabric esistente.
Hosting statico I tuoi file frontend compilati sono serviti da un URL di hosting, con accesso protetto o anonimo al contenuto statico.

Gestione nel portale di Fabric

Dopo la distribuzione, è possibile gestire l'app Fabric direttamente nel portale di Fabric.

Un amministratore Fabric può bloccare temporaneamente altri utenti dal caricare la tua app. Come proprietario dell'app, puoi comunque aprire l'app. Per maggiori informazioni, vedi Blocca e sblocca le app Fabric.

Se possiedi o usi un'app bloccata, guarda cosa succede quando un'app viene bloccata.

Autorizzazioni per gli elementi

I ruoli dell'area di lavoro non sostituiscono le autorizzazioni a livello di elemento. Per condividere un'app con un utente dell'organizzazione, è necessaria l'autorizzazione Esegui ed interagisci (lettura ed esecuzione) per eseguire l'app e richiamare le API back-end.

Autorizzazione Cosa permette
Esegui e interagisci (predefinito) Aprire e usare l'applicazione distribuita. Per impostazione predefinita, tutti i membri dell'area di lavoro ricevono questo livello.
Modifica (Scrivi) Modifica l'app Fabric: distribuisci il codice con rayfin up, applica modifiche allo schema, aggiorna le impostazioni e gestisci i servizi figlio.
Condividi di nuovo Concedere ad altri utenti l'accesso all'app Fabric. Richiede il ruolo di amministratore nell'area di lavoro.

Altre informazioni sui ruoli dell'area di lavoro.

Per il flusso di lavoro di condivisione, i permessi degli elementi correlati e le richieste di accesso, vedi Condividi un'app Fabric.

Sviluppo con la CLI di Rayfin

L'interfaccia della riga di comando esegue lo scaffolding di nuovi progetti, avvia l'infrastruttura locale, sincronizza le modifiche dello schema e distribuisce in Fabric. Installalo con npm create @microsoft/rayfin@latest.

Comandi chiave:

Comando Purpose
npm create @microsoft/rayfin@latest Creare un nuovo progetto da un modello.
npx rayfin up Distribuisci il tuo progetto su Fabric.
npx rayfin up db apply Applicare le modifiche dello schema del database.

Per un riferimento completo ai comandi, vedere riferimento della CLI.

Decoratori del modello di dati

Definisci i modelli di dati utilizzando i decorator TypeScript:

Lo scaffold predefinito blankapp è uno spazio di lavoro Universal App. I dati sono opt-in: abilitalo prima di aggiungere entità a packages/data/src/, e mantieni i contratti rivolti al cliente in packages/shared/src/. Si possono invece usare modelli piatti rayfin/data/. Vedere Definire i modelli di dati.

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({ max: 255 }) user_id!: string;
}

Puoi anche connetterti ai dati esistenti invece di archiviare tutti i dati nel database dell'app. I connettori forniscono accesso in lettura a un lakehouse tramite il suo endpoint di analisi SQL, supportano operazioni di lettura e scrittura su un magazzino o database SQL in Fabric, e effettuano query su un modello semantico. L'accesso al connettore richiede le autorizzazioni sorgente appropriate; non concede l'accesso ai dati sottostanti. Vedi Collegare le app Fabric ai dati Fabric.

Per dati e servizi esterni a questi connettori, utilizza funzioni per chiamare API esterne e risorse Azure e Fabric supportate. Le connessioni esterne utilizzano i permessi dell'identità dell'app, mentre l'accesso al database dell'app tramite una funzione preserva i permessi del chiamante. Conserva le credenziali e i token delle risorse sul server. Vedi Collega Funzioni a risorse esterne.

Quando usare le app Fabric

Fabric Apps è ideale per:

  • Prototipazione rapida – Passa dall'idea all'URL live in pochi minuti con infrastrutture preconfigurate.
  • Strumenti interni e dashboard – Crea interfacce amministrative autenticate senza scrivere un boilerplate backend.
  • Esplorazione e visualizzazione dei dati – Usa connettori per interrogare gli elementi di dati Fabric supportati e visualizzare i risultati in frontend personalizzati.
  • IA e applicazioni per agenti – Forniscono servizi backend strutturati per agenti AI che necessitano di stato persistente.

Fabric Le app potrebbero non essere adatte per:

  • Applicazioni che richiedono transazioni complesse articolate in più fasi o stored procedure.
  • App che richiedono provider di accesso diversi da Fabric SSO dopo la distribuzione.

Responsabilità di sicurezza

Fabric offre: Single Sign-On di Fabric (Microsoft Entra ID), sicurezza a livello di riga tramite @role decoratori, HTTPS, PKCE e autorizzazioni a livello di area di lavoro e di elemento.

Sei responsabile di:

  • Tenere segreti, chiavi API e dati sensibili fuori dal tuo codice, dalle risorse del frontend e dal repository. Non memorizzare segreti negli asset frontend, indipendentemente dall'accesso all'hosting configurato.
  • Ciò che la tua app espone tramite i controlli Fabric SSO determina l'accesso, poiché il codice controlla ciò che gli utenti autenticati vedono e possono fare.
  • Concedere ai collaboratori solo le autorizzazioni necessarie per distribuire o gestire l'app.
  • Responsabilità legale e conformità per i dati raccolti, elaborati e archiviati dall'app.

Passaggi successivi