API di infrastruttura per l'editor GraphQL
Nota
L'API Microsoft Fabric per GraphQL è disponibile in anteprima.
L'API fabric per GraphQL fornisce un ambiente di sviluppo GraphQL grafico in browser, che consente a un playground interattivo di comporre, testare e visualizzare i risultati live delle query e delle mutazioni GraphQL.
Per passare all'editor, aprire l'elemento API per GraphQL in Fabric e selezionare Query nell'angolo inferiore sinistro della schermata del portale.
È possibile digitare il codice direttamente nella scheda Query . Le funzionalità di IntelliSense sono disponibili con una scelta rapida da tastiera: CTRL + Spazio (Windows) o Comando + Spazio (macOS).
Sviluppo di query e mutazioni
Esaminare lo schema GraphQL seguente, che definisce un singolo Post
tipo con query per leggere un singolo post o elencare tutti i post. Definisce anche le mutazioni per creare, aggiornare o eliminare post che supportano tutti i casi d'uso CRUDL (creazione, lettura, aggiornamento, eliminazione, elenco).
type Post {
id: ID!
title: String!
content: String!
author: String!
published: Boolean
}
type Query {
getPost(id: ID!): Post
getAllPosts: [Post]
}
type Mutation {
createPost(title: String!, content: String!, author: String!): Post
updatePost(id: ID!, title: String, content: String, author: String, published: Boolean): Post
deletePost(id: ID!): Boolean
}
È possibile leggere i dati esposti tramite GraphQL usando qualsiasi query definita nello schema. La getPost
query dovrebbe essere simile all'esempio seguente.
query MyQuery {
getPost(id: "1234") {
title
content
author
}
}
Risposta:
{
"data": {
"getPost": {
"title": "First Post",
"content": "This is my first post.",
"author": "Jane Doe"
}
}
}
Scrivere dati usando mutazioni come createPost
creare un post con i parametri obbligatori.
mutation MyMutation {
createPost(title: "Second post", content: "This is my second post", author: "Jane Doe", published: false) {
id
title
content
author
}
}
Risposta:
{
"data": {
"createPost": {
"id": "5678",
"title": "Second Post",
"content": "This is my second post.",
"author": "Jane Doe"
}
}
}
Variabili di query
Usare il riquadro Variabili di query sul lato destro della scheda Query per passare qualsiasi parametro come variabili alle query o alle mutazioni. Le variabili funzionano allo stesso modo delle variabili in qualsiasi altro linguaggio di programmazione. Ogni variabile deve essere dichiarata con un nome usato per accedere al valore archiviato. Con l'esempio di mutazione precedente, è possibile modificarlo leggermente per usare le variabili di query.
mutation MyMutation ($title: String!, $content: String!, $author: String!){
createPost(title: $title, content: $content, author: $author) {
id
title
content
author
}
}
Definire le variabili nel riquadro come nell'esempio seguente.
{
"id": "5678",
"title": "Second Post",
"content": "This is my second post.",
"author": "Jane Doe"
}
Le variabili rendono il codice di mutazione più semplice da leggere, testare e modificare i parametri.