Fabric API for GraphQL Editor

Fabric API for GraphQL gir et grafisk graphql-utviklingsmiljø i nettleseren, som gjør det mulig for en interaktiv lekeplass å komponere, teste og se de levende resultatene av GraphQL-spørringer og mutasjoner.

Hvis du vil gå til redigeringsprogrammet, åpner du API-en for GraphQL-elementet fra arbeidsområdet i Fabric og velger Spørring nederst til venstre på portalskjermen.

Skriv inn og kjør GraphQL-spørringer direkte på Spørring-fanen . Intellisense-funksjoner er tilgjengelige med en hurtigtast: CTRL + mellomrom (Windows) eller Kommando + mellomrom (macOS). Velg Kjør for å kjøre spørringen og hente data fra datakilden.

Generer kode

Etter å ha testet og prototypet den ønskede GraphQL-operasjonen, genererer API-editoren standardkode for Python eller Node.js basert på spørringen eller mutasjonen som utføres i editoren. Du kan kjøre den genererte koden lokalt for testformål og gjenbruke deler av den i applikasjonsutviklingsprosessen.

Viktig

Den genererte koden bruker interaktiv nettleserlegitimasjon og bør bare brukes til testformål. I produksjon må du alltid registrere et program i Microsoft Entra og bruke de aktuelle client_id og omfangene. Du finner et eksempel fra ende til ende med eksempelkode på Koble programmer.

For å komme i gang kjører du en spørring, velger Generer kode-knappen og velger språket deretter:

Deretter kan du kopiere den genererte koden og lagre den som en fil i en lokal mappe. Avhengig av det valgte språket, følg disse enkle trinnene for å teste lokalt:

Python

1. Opprett et virtuelt miljø ved å kjøre kommandoen python -m venv .venv.

2. Aktiver ved venv å kjøre .venv\Scripts\activate eller source .venv/bin/activate.

3. Installer den nødvendige avhengigheten ved å kjøre pip install azure.identity.

4. Kjør koden med python <filename.py>.

Node.JS

1. Opprett en package.json fil med følgende innhold i samme mappe som filen du lagret:

   {
     "type": "module",
     "dependencies": {}
   }
   

2. Kjør npm install --save @azure/identity eller en lignende kommando i den valgte pakkebehandleren for å installere den nyeste versjonen av identitetsbiblioteket.

3. Kjør koden med node <filename>.js.

Utvikling av spørringer og mutasjoner

Se gjennom dette korte GraphQL-skjemaet. Den definerer en enkelt Post type med spørringer for å lese et enkelt innlegg eller liste opp alle innlegg, og mutasjoner for å opprette, oppdatere eller slette innlegg, og støtter alle CRUDL-brukstilfeller (opprett, les, oppdater, slett, liste).

{
  type Post {
    id: ID!
    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
  }
}

Les dataene som eksponeres via GraphQL ved å bruke en hvilken som helst spørring som er definert i skjemaet. Spørringen getPost ser ut som i dette eksemplet.

query MyQuery {
  getPost(id: "1234") {
    title
    content
    author
  }
}

Svar:

{
  "data": {
    "getPost": {
      "title": "First Post",
      "content": "This is my first post.",
      "author": "Jane Doe"
    }
  }
}

Bruk mutasjoner som createPost å skrive data og lage et innlegg med de nødvendige parameterne.

mutation MyMutation {
  createPost(title: "Second post", content: "This is my second post", author: "Jane Doe", published: false) {
    id
    title
    content
    author
  }
}

Svar:

{
  "data": {
    "createPost": {
      "id": "5678",
      "title": "Second Post",
      "content": "This is my second post.",
      "author": "Jane Doe"
    }
  }
}

Spørringsvariabler

Bruk Spørringsvariabler-ruten på høyre side av Spørring-fanen til å sende parametere som variabler til spørringene eller mutasjonene. Variabler fungerer som variabler i andre programmeringsspråk. Hver variabel deklareres med et navn som brukes for å få tilgang til verdien som er lagret i den. Ved hjelp av det forrige mutasjonseksemplet endrer du det litt for å bruke spørringsvariabler.

mutation MyMutation ($title: String!, $content: String!, $author: String!){
  createPost(title: $title, content: $content, author: $author) {
    id
    title
    content
    author
  }
}

Definer variabler i ruten ved hjelp av eksemplet nedenfor.

{
  "id": "5678",
  "title": "Second Post",
  "content": "This is my second post.",
  "author": "Jane Doe"
}

Variabler gjør mutasjonskoden renere, enklere å lese, teste og endre.

Relatert innhold

• Flere eksempler på spørring og mutasjon
• Struktur-API for GraphQL-skjemavisning og skjemautforsker