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. I vantaggi principali includono:
- Sistema di tipi sicuri - Descrive chiaramente i dati disponibili
- Recupero preciso dei dati : riduce il sovraccarico consentendo richieste specifiche
- Compatibilità con le versioni precedenti : semplifica gli aggiornamenti dell'API senza interrompere il codice esistente
- Strumenti avanzati : 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 Di Microsoft Fabric per GraphQL è un servizio gestito che consente di creare un'API GraphQL in pochi secondi.
Origini dati supportate:
- Data warehouse di Microsoft Fabric
- Microsoft Fabric Lakehouses
- Database con mirroring di Microsoft Fabric
- Database SQL di Microsoft Fabric
- 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. Per i 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.
Generazione automatica: 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.
Personalizzazione: Attualmente non è possibile personalizzare direttamente 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?
Autenticazione dell'ID Microsoft Entra: L'API per GraphQL richiede alle applicazioni di usare Microsoft Entra ID per l'autenticazione. L'applicazione client deve essere registrata e configurata per eseguire chiamate API su Fabric.
Autorizzazioni necessarie:
- 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.
Configurazione dell'accesso Single Sign-On (SSO): Se l'API è configurata per l'uso dell'accesso SSO, l'utente autenticato o l'entità servizio richiede l'accesso a entrambi:
- API GraphQL (Permesso Esegui Query e Mutazioni)
- Origine dati (accesso in lettura o scrittura in base alle esigenze)
Opzione di accesso a livello di area di lavoro: In alternativa, assegnare l'utente o l'entità servizio come membro dell'area di lavoro con un ruolo di collaboratore in cui si trovano sia l'API che gli elementi dell'origine dati. In questo modo si ottiene l'accesso necessario a entrambi gli elementi da un'unica posizione. Per altre informazioni, vedere Concedere agli utenti l'accesso alle aree di lavoro.
Configurazione delle credenziali salvate: Se l'API è configurata per l'uso delle credenziali salvate, l'utente autenticato o l'entità servizio deve accedere solo all'API (selezionare l'opzione Esegui query e mutazioni quando si aggiungono autorizzazioni di accesso diretto all'API).
Esempi: È 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.
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 di avvio a freddo:
Riscaldamento dell'origine dati:
- La prima richiesta potrebbe richiedere più tempo se un'origine dati deve essere riscaldata da uno stato a freddo
- Anche se l'origine dati non è fredda, il recupero dei dati potrebbe non essere così efficiente la prima volta che GraphQL esegue una query se l'origine dati non dispone dei dati necessari caricati in memoria
Inizializzazione dell'endpoint API:
- La prima richiesta a un endpoint GraphQL per un'API potrebbe richiedere più tempo perché il sistema deve caricare lo schema e la configurazione
- Le richieste successive sono più veloci perché il sistema è già riscaldato e pronto a 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.