Trovare le risposte alle domande frequenti sull'API Fabric per GraphQL.
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ò di cui hanno bisogno e niente di più, semplifica l'evoluzione delle API nel tempo e abilita 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, Database con mirroring di Microsoft Fabric, Microsoft Fabric database SQL e database SQL di Azure. Fornisce un livello di API unificata per l'esecuzione di query e la mutazione dei dati da queste origini dati supportate. L'API Fabric per GraphQL attualmente è in anteprima.
Quali operazioni di GraphQL sono supportate nell'API Fabric per GraphQL?
Attualmente sono supportate solo query (lettura) e mutazioni (scrittura) di GraphQL. Le origini dati esposte tramite Endpoint di Analisi SQL sono di sola lettura, pertanto supportano solo query. Nel caso dei data warehouse, è necessario definire una chiave primaria per generare automaticamente le mutazioni.
Come visualizzare e modificare i resolver nell'API Fabric per GraphQL?
I resolver sono componenti di GraphQL che forniscono la logica di business per risolvere i campi nell'API ed eseguire operazioni con i dati residenti 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 Microsoft Entra richiede le autorizzazioni Item.Execute.All per il servizio Power BI. Per altre informazioni, vedere Creare un’app di Microsoft Entra in Azure. Oltre a Microsoft Entra, se l'API è configurata per l'uso dell'accesso Single Sign-On (SSO), l'utente autenticato o l'entità servizio nell'app che chiama l'API GraphQL richiede l'accesso sia all'API GraphQL che all'origine dati. In particolare , eseguire query e mutazioni autorizzazione nell'API GraphQL e l'accesso in lettura o scrittura richiesto nell'origine dati di scelta di conseguenza. Un'altra opzione consiste nell'avere l'utente o l'entità servizio come membro dell'area di lavoro con un ruolo collaboratore in cui si trovano sia l'API che gli elementi dell'origine dati, che fornirà l'accesso necessario a entrambi gli elementi da un'unica posizione. Per altre informazioni, vedere Concedere agli utenti l'accesso alle aree di lavoro. In alternativa, se l'API è configurata per l'uso di credenziali salvate, l'utente autenticato o l'entità servizio deve semplicemente avere accesso all'API (selezionare 'opzione Esegui query e mutazioni quando si aggiungono autorizzazioni di accesso diretto all'API). È possibile trovare un esempio end-to-end con codice di esempio per le entità utente e le entità servizio in Connettere applicazioni.
Come aprire un ticket di supporto per l'API per GraphQL?
Per ottenere assistenza dal supporto tecnico Microsoft su qualsiasi problema correlato all'API Fabric per GraphQL, visitare il sito di supporto di Fabric e scegliere l'opzione Ingegneria dei dati.
Quali aree non sono ancora supportate dall'API per GraphQL?
L'API per GraphQL non è attualmente supportata nell'area Stati Uniti occidentali 3.