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.

Contenuto correlato

• API di infrastruttura per la visualizzazione dello schema GraphQL ed Esplora schemi