Condividi tramite

Creare un'API per GraphQL in Fabric e aggiungere dati

  • Articolo

Nota

L'API Microsoft Fabric per GraphQL è disponibile in anteprima.

Per iniziare a usare l'API fabric per GraphQL, creare un'API e quindi collegare un'origine dati per esporre i dati scelti tramite l'API. Fabric compila automaticamente lo schema GraphQL in base ai dati e le applicazioni sono pronte per la connessione in pochi minuti.

Prerequisiti

Creazione di un'API per GraphQL

Per creare un'API per GraphQL:

  1. Nel portale infrastruttura selezionare Ingegneria dei dati dal commutatore del carico di lavoro nella parte inferiore della barra di spostamento. Se ci si trova nella casa fabric, è anche possibile selezionare la scheda Ingegneria dei dati.

    Screenshot dell'opzione Ingegneria dei dati nel commutatore del carico di lavoro.

  2. Selezionare API per GraphQL (anteprima).

    Screenshot del riquadro API, che si seleziona per creare un nuovo elemento dell'API.

    In alternativa, selezionare Nuova>API per GraphQL (anteprima) da qualsiasi area di lavoro in Ingegneria dei dati.

    Screenshot della barra degli strumenti dell'area di lavoro, che mostra dove selezionare l'opzione Nuovo.

  3. Immettere un nome per l'elemento e selezionare Crea.

    Screenshot della finestra di dialogo Nuova API per GraphQL, che mostra dove immettere il nome e selezionare Crea.

È ora disponibile un'API completamente funzionale per accedere ai dati in Fabric.

Connessione a un'origine dati e compilare lo schema

A questo punto, l'API è pronta, ma non espone dati. Le API per GraphQL sono definite in uno schema organizzato in termini di tipi e campi, in un sistema fortemente tipizzato. Fabric genera automaticamente lo schema GraphQL necessario in base ai dati che si sceglie di esporre ai client GraphQL.

  1. Nella nuova API scegliere un'origine dati da esporre scegliendo Seleziona origine dati.

    Screenshot dell'opzione Seleziona origine dati.

  2. Viene visualizzato l'hub dati OneLake; scegliere l'origine dati a cui connettersi. Nell'esempio seguente viene scelto un endpoint di analisi SQL AdventureWorks collegato a un database con mirroring. Selezionare Filtro per visualizzare solo tipi specifici di origini dati di Fabric o eseguire ricerche in base a una parola chiave specifica. Quando si è pronti, selezionare Connessione.

    Screenshot dell'hub dati OneLake, che mostra le opzioni disponibili per l'origine dati per un'area di lavoro.

  3. Viene visualizzata la schermata Recupera dati , in cui è possibile scegliere gli oggetti da esporre nello schema GraphQL.

    Screenshot della schermata Recupera dati che mostra l'elenco Scegli dati.

  4. Selezionare le caselle di controllo accanto alle singole tabelle o stored procedure da esporre nell'API. Per selezionare tutti gli oggetti in una cartella, selezionare la casella di controllo con il nome dell'origine dati nella parte superiore.

    Screenshot dell'elenco Scegli dati con una cartella selezionata, che seleziona automaticamente tutti gli elementi all'interno di tale cartella.

  5. Selezionare Carica per avviare il processo di generazione dello schema GraphQL.

  6. Lo schema viene generato ed è possibile avviare la creazione di prototipi di query GraphQL (lettura, elenco) o mutazioni (creazione, aggiornamento, eliminazione) per interagire con i dati.

    Screenshot della schermata Esplora schemi.

L'API per GraphQL è ora pronta per accettare connessioni e richieste. È possibile usare l'editor api per testare e creare prototipi di query GraphQL e Esplora schemi per verificare i tipi di dati e i campi esposti nell'API.

Contenuto correlato