domande frequenti sulle app Fabric

Questo articolo risponde alle domande comuni sulle app di Microsoft Fabric.

General

Che cos'è Fabric App?

Fabric Apps è una piattaforma back-end che consente agli sviluppatori TypeScript di compilare e distribuire applicazioni guidate dai dati più velocemente. Definisci i modelli di dati usando i decorator TypeScript e Fabric Apps genera automaticamente API GraphQL, schemi di database e client con sicurezza dei tipi.

Chi deve usare Fabric App?

Fabric App è ideale per gli sviluppatori che creano:

  • Strumenti e dashboard interni
  • Applicazioni di esplorazione e visualizzazione dei dati
  • Prototipi rapidi
  • Applicazioni di intelligenza artificiale e agente che richiedono uno stato permanente

Quali database sono supportati?

Fabric Apps supporta SQL Server: impostazione predefinita per le distribuzioni di Fabric.

È possibile usare app Fabric con database esistenti?

No. Fabric App gestisce lo schema del database in base ai modelli di dati TypeScript. Non è possibile puntarlo a un database esistente con uno schema predefinito.

Development

Come si installa l'interfaccia della riga di comando?

È possibile installare l'interfaccia della riga di comando di Rayfin con npm. Poiché si tratta di un pacchetto npm che è possibile aggiornare con npm update.

npm i @microsoft/rayfin-cli

È possibile usare app Fabric senza TypeScript?

No. I modelli di dati devono essere definiti mediante i decorator di TypeScript. L'applicazione front-end può usare JavaScript, ma il back-end richiede TypeScript per le definizioni di modello.

Quali framework front-end sono supportati?

Fabric App funziona con qualsiasi framework front-end in grado di effettuare richieste HTTP:

  • React
  • Vue
  • Angular
  • Svelte
  • Vanilla JavaScript/TypeScript

Il client SDK fornisce API con controllo dei tipi per tutti i framework.

Authentication

Quali metodi di autenticazione sono supportati?

Ambiente Metodi supportati
Sviluppo locale Microsoft Entra SSO e posta elettronica/password
Distribuito in Fabric solo SSO Microsoft Entra

Note

L'autenticazione tramite posta elettronica e password non funziona dopo la distribuzione in Fabric. Non è possibile distribuire un'app in Fabric a meno che non sia abilitata l'autenticazione.

È possibile usare provider di autenticazione personalizzati?

No. Fabric Apps supporta solo l'accesso Single Sign-On (SSO) di Microsoft Entra e l'autenticazione tramite e-mail/password. Non è possibile integrare altri provider.

Deployment

È possibile distribuire un'app senza l'autenticazione abilitata?

No. Fabric richiede l'abilitazione dell'autenticazione fabric prima di distribuire un'app Fabric.

È possibile eseguire la distribuzione in più ambienti (sviluppo, gestione temporanea, produzione)?

È possibile gestire manualmente aree di lavoro separate Fabric e distribuirla in elementi diversi.

Quanto tempo richiede la distribuzione?

La distribuzione iniziale richiede in genere 2-5 minuti. Le distribuzioni successive con npx rayfin up staticapp deploy (solo contenuto statico) richiedono 30-60 secondi.

Posso eseguire il rollback di una distribuzione?

Ridistribuire la versione precedente controllando il commit git precedente ed eseguendo npx rayfin up.

Come si esegue il debug degli errori di distribuzione?

  • Errori di compilazione : eseguire npm run build prima della distribuzione. L'errore di distribuzione più comune è un build di produzione mancante. Al termine della compilazione, eseguire npx rayfin up.
  • Errori di capacità o di autorizzazione — Verificare che l'area di lavoro disponga della capacità Fabric assegnata e di avere l'autorizzazione per creare o modificare elementi nell'area di lavoro.
  • Errori dello schema del database: se l'errore si verifica durante l'applicazione dello schema del database, esaminare le modifiche apportate dopo l'ultima distribuzione riuscita e risolvere eventuali conflitti.

Modelli di dati

È possibile usare chiavi primarie composite?

No. Ogni entità deve usare un singolo campo UUID denominato id come chiave primaria.

Sono supportate le relazioni molti-a-molti?

No. Usare invece un'entità di join esplicita con due decoratori di navigazione @one().

È possibile scrivere query SQL personalizzate?

Non esiste alcun supporto per le query SQL dirette. Tutti gli accessi ai dati passano attraverso le API GraphQL generate.

Prestazioni e scalabilità

Quali sono i limiti di prestazioni?

Le prestazioni dipendono dalla capacità di Fabric. Contattare l'amministratore Fabric per i limiti specifici della capacità.

È possibile memorizzare nella cache i risultati delle query?

Yes. Implementa il caching lato client nella tua applicazione frontend. Il backend non dispone di una cache integrata.

Come si ottimizzano le prestazioni delle query?

  • Selezionare solo i campi necessari
  • Usare la paginazione per set di risultati di grandi dimensioni
  • Includere campi di entità correlati in una singola query anziché effettuare più richieste

Security

Come vengono protetti i dati?

  • L'autenticazione è necessaria per impostazione predefinita (configurabile per entità)
  • I criteri di sicurezza a livello di riga filtrano i dati in base alle attestazioni JWT
  • Tutte le comunicazioni usano HTTPS nelle distribuzioni di Fabric

Limitations

Quali sono le limitazioni correnti?

  • count() non è disponibile nel client Fluent GraphQL
  • Le relazioni molti-a-molti non sono supportate
  • Le chiavi primarie composite non sono supportate
  • I provider di autenticazione personalizzati non sono supportati
  • La gestione di più ambienti non è disponibile per impostazione predefinita

Per le soluzioni alternative, vedere Risolvere i problemi delle app Fabric.

È possibile esportare i dati?

Yes. È anche possibile connettersi direttamente al database SQL se si dispone del stringa di connessione.

Contenuti correlati

  • Last updated on