Nota
L'accesso a questa pagina richiede l'autorizzazione. Puoi provare ad accedere o a cambiare directory.
L'accesso a questa pagina richiede l'autorizzazione. Puoi provare a cambiare directory.
Le attuali limitazioni generali dei prodotti per l'API per GraphQL in Microsoft Fabric sono elencate in questo articolo. Stiamo migliorando continuamente l'API per GraphQL con nuove funzionalità. Per altre informazioni sul futuro di Microsoft Fabric, vedere Fabric Roadmap.
Chi deve comprendere le limitazioni
Comprendere le limitazioni dell'API GraphQL è fondamentale per:
- Sviluppatori di applicazioni che progettano applicazioni che funzionano all'interno dei vincoli dell'API GraphQL di Fabric
- Ingegneri dei dati che pianificano strategie di esposizione dei dati e comprensione dei limiti della piattaforma
- Architetti delle soluzioni che definiscono l'ambito delle soluzioni basate su Fabric e impostano aspettative tecniche appropriate
- Collaboratori del workspace Fabric per la risoluzione dei problemi e l'implementazione di soluzioni alternative alle limitazioni correnti.
- Project Manager che comunica i vincoli della piattaforma Fabric agli stakeholder durante la pianificazione del progetto
Esaminare queste limitazioni durante la pianificazione delle implementazioni dell'API GraphQL o la risoluzione dei problemi relativi al comportamento imprevisto dell'API.
Operazioni dell'origine dati
Le origini dati degli endpoint di Analisi SQL supportano solo le operazioni di lettura. Le origini dati a cui si accede tramite endpoint di analisi SQL (ad esempio Lakehouse e database con mirroring) non supportano le mutazioni. È possibile eseguire query sui dati, ma non è possibile creare, aggiornare o eliminare record tramite l'API GraphQL.
Limiti di dimensioni e prestazioni
La tabella seguente riepiloga le dimensioni della chiave, la paginazione e i vincoli di prestazioni:
| Tipo limite | Value | Description | Soluzione |
|---|---|---|---|
| Dimensioni pagina predefinite | 100 elementi | Numero massimo di elementi restituiti per richiesta per impostazione predefinita | Usare l'impaginazione GraphQL per scorrere set di risultati di dimensioni maggiori |
| Dimensioni massime della pagina | 100.000 elementi | Numero massimo di elementi che è possibile recuperare tramite la paginazione | Inviare più richieste filtrate se sono necessari più di 100.000 elementi (modello non comune in GraphQL) |
| Dimensioni massime della risposta | 64 MB | Dimensioni massime del payload della risposta dell'API | Inviare più richieste filtrate per recuperare i dati in blocchi più piccoli |
| Timeout richiesta | 100 secondi | Tempo massimo di esecuzione per una singola richiesta | Ottimizzare le query o suddividere operazioni complesse in richieste più piccole |
| La profondità massima della query | 10 livelli | Livello massimo di annidamento dei campi in una query | Ridurre l'annidamento delle query per evitare problemi di prestazioni dal recupero eccessivo dei dati |
Limitazioni delle procedure memorizzate
Le stored procedures in Azure SQL, SQL Database in Fabric e Data Warehouses hanno vincoli specifici.
- Gestione dei set di risultati: viene utilizzato solo il primo set di risultati restituito dalla stored procedure. Non sono supportati più set di risultati.
-
Requisiti dei metadati: sono supportate solo stored procedure i cui primi metadati del set di risultati possono essere descritti da
sys.dm_exec_describe_first_result_set. - Precedenza dei parametri: quando si specifica un parametro di stored procedure sia nel file di configurazione che nella stringa di query URL, il valore della stringa di query URL ha la precedenza.
-
Funzionalità di GraphQL limitate: le entità supportate dalle stored procedure hanno funzionalità ridotte rispetto alle entità basate su tabella o vista:
- Nessun supporto per la paginazione
- Nessun ordinamento o filtro
- Nessuna ricerca basata su chiave primaria
Problemi noti
Per i problemi noti nell'API per GraphQL, visitare la sezione Problemi Noti di Microsoft Fabric.