Zdieľať cez

Rozhranie API služby Fabric pre editor GraphQL

Rozhranie API služby Fabric pre GraphQL poskytuje grafické vývojové prostredie GraphQL v prehliadači, ktoré umožňuje interaktívnemu ihrisku vytvárať, testovať a zobrazovať živé výsledky vašich dotazov a mutácií GraphQL.

Ak chcete prejsť do editora, otvorte rozhranie API pre položku GraphQL z jej pracovného priestoru v službe Fabric a vyberte položku Dotaz v ľavom dolnom rohu obrazovky portálu.

Snímka obrazovky zobrazujúca miesto, kde sa v ľavom dolnom rohu obrazovky Fabric zobrazí možnosť Dotaz.

Zadajte a spustite dotazy GraphQL priamo na karte Dotaz. Funkcie IntelliSense sú k dispozícii pomocou klávesovej skratky: CTRL + medzerník (Windows) alebo Command + medzerník (macOS). Výberom položky Spustiť spustíte dotaz a načítate údaje zo zdroja údajov.

Snímka obrazovky editora rozhrania API, ktorá zobrazuje kartu Dotaz rozdelenú na tably Spustiť, Premenné dotazu a Výsledky.

Generovať kód

Po otestovaní a prototypovaní požadovanej operácie GraphQL editor API vygeneruje štandardný kód Python alebo Node.js na základe dotazu alebo mutácie vykonanej v editore. Vygenerovaný kód môžete spustiť lokálne na testovacie účely a jeho časti opätovne použiť v procese vývoja aplikácie.

Dôležité

Vygenerovaný kód používa interaktívne poverenia prehliadača a mal by sa používať iba na testovacie účely. V produkčnom prostredí vždy zaregistrujte aplikáciu v aplikácii Microsoft Entra a použite príslušné client_id a rozsahy. Komplexný príklad so vzorovým kódom nájdete v časti Pripojenie aplikácií.

Ak chcete začať, spustite dotaz, vyberte tlačidlo Generovať kód a podľa toho vyberte jazyk:

Snímka obrazovky editora API zobrazujúca možnosť generovania kódu.

Potom môžete vygenerovaný kód skopírovať a uložiť ako súbor v lokálnom priečinku. V závislosti od zvoleného jazyka postupujte podľa týchto jednoduchých krokov na lokálne testovanie:

Python

  1. Vytvorte virtuálne prostredie spustením príkazu python -m venv .venv.

  2. Aktivujte spustením venv.venv\Scripts\activate alebo source .venv/bin/activate.

  3. Nainštalujte požadovanú závislosť spustením pip install azure.identity.

  4. Spustite kód pomocou python <filename.py>.

Node.JS

  1. V rovnakom priečinku ako súbor, ktorý ste uložili, vytvorte package.json súbor s nasledujúcim obsahom:

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

  2. Spustite npm install --save @azure/identity alebo podobný príkaz vo zvolenom správcovi balíkov a nainštalujte najnovšiu verziu knižnice identít.

  3. Spustite kód pomocou node <filename>.js.

Vývoj dotazov a mutácií

Prečítajte si túto krátku schému GraphQL. Definuje jeden Post typ s dotazmi na prečítanie jedného príspevku alebo zoznam všetkých príspevkov a mutáciami na vytváranie, aktualizáciu alebo odstraňovanie príspevkov, ktoré podporujú všetky prípady použitia CRUDL (vytvorenie, čítanie, aktualizácia, odstránenie, zoznam).

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

Prečítajte si údaje vystavené prostredníctvom GraphQL pomocou ľubovoľného dotazu definovaného v schéme. Dotaz getPost vyzerá ako v tomto príklade.

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

Odpoveď:

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

Použite mutácie, napríklad createPost na zápis údajov a vytvorenie príspevku s požadovanými parametrami.

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

Odpoveď:

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

Premenné dotazu

Tablu Premenné dotazu na pravej strane karty Dotaz použite na odovzdanie parametrov ako premenných do dotazov alebo mutácií. Premenné fungujú ako premenné v iných programovacích jazykoch. Každá premenná je deklarovaná s názvom používaným na prístup k hodnote v nej uloženej. Pomocou predchádzajúceho príkladu mutácie ho mierne upravíte tak, aby používal premenné dotazu.

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

Definujte premenné na table pomocou nasledujúceho príkladu.

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

Premenné robia mutačný kód čistejším, ľahšie čitateľným, testujúcim a upraviteľným.

Súvisiaci obsah

  • Last updated on