Trovare le risposte alle domande frequenti sull'API Fabric per GraphQL.
Che cos'è GraphQL?
GraphQL è un linguaggio di query per le API che consente alle app di richiedere esattamente i dati necessari. Usa un sistema di tipi sicuri per descrivere chiaramente i dati disponibili, riduce il sovraccarico consentendo richieste precise, semplifica gli aggiornamenti delle API senza interrompere il codice esistente e consente l'uso di un ampio set di strumenti di sviluppo. È un modo più efficiente per le applicazioni di comunicare con server e database.
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.
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 affinché le mutazioni vengano generate automaticamente.
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 ID 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 autorizzazioni graphQLApi.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 offrono 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.
L'API per GraphQL supporta il collegamento privato?
L'API per GraphQL non supporta attualmente il collegamento privato. Tuttavia, microsoft prevede di supportare questa funzionalità in futuro e fornirà gli aggiornamenti man mano che diventano disponibili.
È stato abilitato il collegamento privato per il tenant di Fabric. Perché gli elementi GraphQL non funzionano?
Se l'impostazione del tenant "Blocca l'accesso a Internet pubblico" è abilitata ( ovvero l'accesso pubblico è disabilitato), gli elementi o gli elementi non supportati vengono disabilitati automaticamente, inclusa l'API per GraphQL. Ciò significa che non è possibile accedere agli elementi creati in precedenza, né crearne di nuovi. L'unico modo per accedere a questi elementi consiste nel consentire l'accesso pubblico.
Perché la richiesta ha prestazioni scarse la prima volta che la si emette, quindi offre prestazioni buone per le richieste successive?
Esistono due motivi principali per questo comportamento. Prima di tutto, la prima richiesta potrebbe richiedere più tempo se un'origine dati deve essere riscaldata in caso di freddo. Anche se l'origine dati non è fredda, il recupero dei dati potrebbe non essere altrettanto efficiente la prima volta che GraphQL esegue una query, se l'origine dati non dispone dei dati necessari caricati in memoria. Il secondo motivo è che la prima richiesta a un endpoint Api per GraphQL potrebbe richiedere più tempo perché il sistema deve caricare lo schema e la configurazione per poter accettare le richieste. Si tratta di un costo monouso e le richieste successive sono più veloci perché il sistema è già caldo e pronto per soddisfare le richieste. Altre informazioni sono disponibili nelle procedure consigliate per le prestazioni.
Come è possibile fornire commenti e suggerimenti o suggerimenti per l'API per GraphQL?
Siamo lieti di ricevere commenti e suggerimenti. È possibile fornire commenti e suggerimenti tramite Fabric Ideas. Il nostro team monitora attivamente il feedback e i suggerimenti inviati tramite questa piattaforma. È anche possibile contattare Microsoft tramite supporto tecnico Microsoft Fabric per eventuali query o problemi specifici.