Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 buildprima della distribuzione. L'errore di distribuzione più comune è un build di produzione mancante. Al termine della compilazione, eseguirenpx 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.