Limitazioni dell'API Di Microsoft Fabric per GraphQL
Questo articolo illustra in dettaglio le limitazioni correnti nell'API di Microsoft Fabric per GraphQL.
Limitazioni
Le attuali limitazioni generali dei prodotti per l'API per GraphQL in Microsoft Fabric sono elencate in questo articolo. Stiamo migliorando costantemente l'API per GraphQL con nuove funzionalità. Per altre informazioni sul futuro di Microsoft Fabric, vedere Fabric Roadmap.
- Qualsiasi origine dati che sfrutta un endpoint di Analisi SQL per l'accesso ai dati supporta solo le operazioni di lettura. Ad esempio, le mutazioni non sono disponibili per i Lakehouses o i database con mirroring.
- La dimensione di pagina predefinita corrente è 100, il che significa che ogni richiesta restituirà un massimo di 100 elementi nella risposta. Se il set di risultati è maggiore di 100, scorrere i risultati usando paginazione GraphQL.
- La dimensione massima della paginazione è 100.000. Ciò significa che è presente un numero massimo fisso di elementi restituiti da una richiesta e che è possibile scorrere. Se è necessario restituire più di 100.000 elementi per l'applicazione, inviare più richieste. Comprendere che questo modello non è comune in GraphQL.
- La dimensione massima di risposta supportata è 64 MB. Ciò significa che qualsiasi richiesta API con dimensioni di risposta superiori a 64 MB restituisce un errore. Per ovviare a questa limitazione, è possibile eseguire più richieste filtrate.
- Limitazioni per le stored procedure (si applica a SQL di Azure, al database SQL in Fabric e ai data warehouse):
- Solo il primo set di risultati restituito dalla stored procedure viene usato dall'API per GraphQL.
- Sono supportate unicamente quelle stored procedure i cui metadati per il primo set di risultati sono descritti da sys.dm_exec_describe_first_result_set.
- Quando un parametro di stored procedure viene specificato sia nel file di configurazione che nella stringa di query URL, il parametro nella stringa di query URL ha la precedenza.
- Le entità supportate da una stored procedure non dispongono di tutte le funzionalità fornite automaticamente per le entità supportate da tabelle o viste.
- Le entità supportate da stored procedure non supportano l'impaginazione, l'ordinamento o il filtro. Né tali entità supportano la restituzione di elementi specificati dai valori di chiave primaria.
- Il timeout della richiesta è attualmente di 100 secondi. Ciò significa che se si esegue una richiesta che genera una query di origine dati che richiede più di 100 secondi per il completamento, la richiesta potrebbe non riuscire ed eseguire un errore.
Problemi noti
Per i problemi noti nell'API per GraphQL, visitare la sezione Problemi Noti di Microsoft Fabric.