Fabric API til GraphQL-editor

Fabric-API'en til GraphQL indeholder et grafisk GraphQL-udviklingsmiljø i browseren, som gør det muligt for en interaktiv legeplads at skrive, teste og se liveresultaterne af dine GraphQL-forespørgsler og -mutationer.

Hvis du vil gå til editoren, skal du åbne API'en til GraphQL-elementet fra arbejdsområdet i Fabric og vælge Forespørgsel i nederste venstre hjørne af portalskærmen.

Skriv og udfør GraphQL-forespørgsler direkte under fanen Forespørgsel . Intellisense-funktioner er tilgængelige med en tastaturgenvej: CTRL + mellemrum (Windows) eller Kommando + mellemrum (macOS). Vælg Kør for at udføre forespørgslen og hente data fra datakilden.

Generér kode

Efter at have testet og lavet prototyper af den ønskede GraphQL-operation, genererer API-editoren standardkode til Python eller Node.js baseret på den forespørgsel eller mutation, der udføres i editoren. Du kan køre den genererede kode lokalt til testformål og genbruge dele af den i applikationsudviklingsprocessen.

Vigtigt

Den genererede kode bruger interaktive browserlegitimationsoplysninger og bør kun bruges til testformål. I produktionen skal du altid registrere et program i Microsoft Entra og bruge de relevante client_id områder og områder. Du kan finde et eksempel fra ende til anden med eksempelkode i Connect Applications.

For at komme i gang skal du udføre en forespørgsel, vælge knappen Generer kode og vælge sproget i overensstemmelse hermed:

Du kan derefter kopiere den genererede kode og gemme den som en fil i en lokal mappe. Afhængigt af det valgte sprog skal du følge disse enkle trin for at teste lokalt:

Python

1. Opret et virtuelt miljø ved at køre kommandoen python -m venv .venv.

2. Aktiver ved venv at køre .venv\Scripts\activate eller source .venv/bin/activate.

3. Installer den nødvendige afhængighed ved at køre pip install azure.identity.

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

Node.JS

1. Opret en package.json fil med følgende indhold i den samme mappe som den fil, du har gemt:

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

2. Kør npm install --save @azure/identity eller en lignende kommando i din valgte pakkehåndtering for at installere den nyeste version af identitetsbiblioteket.

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

Udvikling af forespørgsler og mutationer

Gennemgå dette korte GraphQL-skema. Den definerer en enkelt Post type med forespørgsler til at læse et enkelt indlæg eller liste over alle indlæg og mutationer til at oprette, opdatere eller slette indlæg, der understøtter alle CRUDL-brugssager (oprette, læse, opdatere, slette, 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
  }
}

Læs de data, der eksponeres via GraphQL, ved hjælp af en forespørgsel, der er defineret i skemaet. Forespørgslen getPost ser ud som i dette eksempel.

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

Svar:

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

Brug mutationer som createPost at skrive data og oprette et indlæg med de nødvendige parametre.

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"
    }
  }
}

Forespørgselsvariabler

Brug ruden Forespørgselsvariabler i højre side af fanen Forespørgsel til at overføre parametre som variabler til dine forespørgsler eller mutationer. Variabler fungerer som variabler i andre programmeringssprog. Hver variabel er deklareret med et navn, der bruges til at få adgang til den værdi, der er gemt i den. Ved hjælp af det forrige mutationseksempel kan du ændre det en smule for at bruge forespørgselsvariabler.

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

Definer variabler i ruden ved hjælp af følgende eksempel.

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

Variabler gør mutationskoden renere, lettere at læse, teste og ændre.

Relateret indhold

• Flere eksempler på forespørgsler og mutationer
• Fabric API til GraphQL-skemavisning og skemaoversigt