Domande frequenti sull’API Fabric per 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
• Strumentazione completa - Consente l'uso di un ampio set di strumenti per sviluppatori

È un modo più efficiente per le applicazioni di comunicare con server e database.

Microsoft Fabric API per GraphQL è un servizio gestito che consente di creare un'API GraphQL in pochi secondi.

Origini dati supportate:

• Microsoft Fabric data warehouse
• Microsoft Fabric Lakehouses
• Database replicati di Microsoft Fabric
• Database SQL di Microsoft Fabric
• database Azure SQL

Fornisce un livello API unificato per l'esecuzione di query e la modifica dei dati provenienti da queste origini dati supportate.

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.

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.

Microsoft Entra ID authentication: 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 Power BI service. Per altre informazioni, vedere Creare un'app Microsoft Entra in Azure.

configurazione di Single Sign-On (SSO): Se l'API è configurata per l'uso dell'SSO, l'utente autenticato o l'entità servizio richiede l'accesso a entrambi:

• API GraphQL (Permesso Esegui Query e Mutazioni)
• L'origine dati (l'accesso in lettura o scrittura in base alle esigenze)

Opzione di accesso a livello di spazio di lavoro: In alternativa, assegnare l'utente o l'entità servizio come membro dello spazio di lavoro con un ruolo di contributor in cui si trovano sia l'API che gli elementi dell'origine dati. In questo modo dà l'accesso richiesto agli elementi da un'unica posizione. Per altre informazioni, vedere Dare accesso agli utenti 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 richiede solo access all'API (selezionare Esegui query e mutazioni opzione quando si aggiungono autorizzazioni access dirette 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.

Per ottenere assistenza da Microsoft Support su qualsiasi problema correlato all'API infrastruttura per GraphQL, visitare il sito Fabric Support site e scegliere l'opzione Data Engineering.

L'API per GraphQL al momento supporta solo il Tenant-Level Private Link.

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.

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 Microsoft Fabric per eventuali domande o problemi specifici.

Contenuto correlato

Cos'è Microsoft Fabric API per GraphQL?