Поделиться через


API Fabric для редактора GraphQL

Примечание.

API Microsoft Fabric для GraphQL находится в предварительной версии.

API Fabric для GraphQL предоставляет графическую среду разработки GraphQL в браузере, которая позволяет интерактивной игровой площадке создавать, тестировать и просматривать динамические результаты запросов и мутаций GraphQL.

Чтобы перейти к редактору, откройте элемент API для GraphQL в Fabric и выберите "Запрос " в левом нижнем углу экрана портала.

Снимок экрана, показывающий, где отображается параметр

Вы можете ввести код непосредственно на вкладке "Запрос ". Возможности Intellisense доступны с помощью сочетания клавиш: CTRL+ ПРОБЕЛ (Windows) или Command + Пробел (macOS).

Снимок экрана: экран редактора API, на котором есть вкладка

Разработка запросов и мутаций

Просмотрите следующую короткую схему GraphQL, которая определяет один тип с запросами для чтения одной Post записи или списка всех записей. Он также определяет изменения для создания, обновления или удаления записей, поддерживающих все варианты использования CRUDL (создание, чтение, обновление, удаление, список).

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
}

Данные, предоставляемые с помощью GraphQL, можно считывать с помощью любого запроса, определенного в схеме. Запрос getPost должен выглядеть следующим образом.

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

Ответ.

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

Запись данных с помощью изменений, таких как createPost создание записи с необходимыми параметрами.

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

Ответ.

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

Переменные запроса

Используйте область переменных запроса справа от вкладки "Запрос", чтобы передать все параметры в качестве переменных в запросы или изменения. Переменные работают так же, как переменные в любом другом языке программирования. Каждая переменная должна быть объявлена с именем, которое используется для доступа к значению, хранящееся в нем. В предыдущем примере мутации можно немного изменить его, чтобы использовать переменные запроса.

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

Определите переменные в области, как показано в следующем примере.

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

Переменные упрощают чтение, тестирование и изменение параметров кода мутаций.