Trovare le risposte alle domande frequenti dell'API fabric per GraphQL.
Nota
L'API Microsoft Fabric per GraphQL è disponibile in anteprima.
Che cos'è GraphQL?
GraphQL è un linguaggio di query open source per le API e un runtime per soddisfare tali query con i dati esistenti. GraphQL fornisce una descrizione completa e comprensibile dei dati nell'API con un sistema fortemente tipizzato, offre ai client la possibilità di richiedere esattamente ciò che hanno bisogno e niente di più, semplifica l'evoluzione delle API nel tempo e consente potenti strumenti di sviluppo.
Che cos'è l'API Microsoft Fabric per GraphQL?
L'API Microsoft Fabric per GraphQL è un servizio gestito che consente di creare un'API GraphQL in pochi secondi per accedere ai dati dalle origini dati, ad esempio Microsoft Fabric Data Warehouse, Microsoft Fabric Lakehouses e Database con mirroring di Microsoft Fabric. Fornisce un livello API unificato per l'esecuzione di query e la modifica dei dati da queste origini dati supportate. L'API di infrastruttura per GraphQL è attualmente in anteprima.
Quali operazioni GraphQL sono supportate nell'API fabric per GraphQL?
Attualmente sono supportate solo le query GraphQL (lettura) e le mutazioni (scrittura). Le origini dati esposte tramite endpoint di analisi SQL sono di sola lettura, pertanto supportano solo le query. Nel caso dei data warehouse, è necessario definire una chiave primaria per generare automaticamente le mutazioni.
Come è possibile visualizzare e modificare i resolver nell'API fabric per GraphQL?
I resolver sono componenti GraphQL che forniscono la logica di business per risolvere i campi nell'API ed eseguire operazioni con i dati che risiedono nelle origini dati. Fabric genera automaticamente i resolver ogni volta che si collega una nuova origine dati o si selezionano nuovi oggetti da esporre da un'origine dati esistente. Attualmente non è possibile personalizzare i resolver. Per la logica di business personalizzata nell'API per GraphQL, è possibile creare una stored procedure nell'origine dati ed esporla nell'API GraphQL.
L'API per l'applicazione client GraphQL richiede l'accesso all'origine dati per eseguire query o mutazioni?
L'API per GraphQL richiede alle applicazioni di usare Microsoft Entra per l'autenticazione. L'applicazione client deve essere registrata e configurata in modo adeguato per eseguire chiamate API su Fabric. L'app registrata in Entra richiede le autorizzazioni api Item.Execute.All e Datamart.ReadWrite.All per il servizio Power BI (Importante: gli ambiti potrebbero cambiare durante l'anteprima pubblica). Per altre informazioni, vedere Creare un'app Microsoft Entra in Azure. Oltre a Entra, l'utente autenticato nell'app che chiama l'API GraphQL deve essere un membro dell'area di lavoro con un ruolo collaboratore in cui si trovano sia l'API che gli elementi dell'origine dati. Per altre informazioni, vedere Concedere agli utenti l'accesso alle aree di lavoro. Le entità servizio non sono attualmente supportate. È possibile trovare un esempio end-to-end con codice di esempio in Connect Applications (Connetti applicazioni).
Ricerca per categorie aprire un ticket di supporto per l'API per GraphQL?
Per ottenere assistenza da supporto tecnico Microsoft su qualsiasi problema correlato all'API infrastruttura per GraphQL, visitare il sito di supporto dell'infrastruttura e scegliere l'opzione Ingegneria dei dati.