Editor de la API de Fabric para GraphQL

Nota:

La API de Microsoft Fabric para GraphQL está en versión preliminar.

La API de Fabric para GraphQL proporciona un entorno de desarrollo gráfico de GraphQL en el explorador, que permite que un área de juegos interactiva cree, pruebe y vea los resultados en directo de las consultas y mutaciones de GraphQL.

Para ir al editor, abra el elemento API para GraphQL en Fabric y seleccione Consultar en la esquina inferior izquierda de la pantalla del portal.

Puede escribir código directamente en la pestaña Consulta. Las funcionalidades de IntelliSense están disponibles con una función rápida de teclado: CTRL + Espacio (Windows) o Comando + Espacio (macOS).

Desarrollo de consultas y mutaciones

Revise el siguiente esquema corto de GraphQL, que define un único tipo con consultas Post para leer una publicación o enumerar todas las publicaciones. También define las mutaciones para crear, actualizar o eliminar publicaciones que admiten todos los casos de uso de CRUDL (creación, lectura, actualización, eliminación y enumeración por sus iniciales en inglés).

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
}

Puede leer los datos expuestos a través de GraphQL mediante cualquier consulta definida en el esquema. La consulta getPost debe tener un aspecto similar al ejemplo siguiente.

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

Respuesta:

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

Escriba datos mediante mutaciones como createPost para crear una publicación con los parámetros necesarios.

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

Respuesta:

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

Variables de consulta

Use el panel Variables de consulta en el lado derecho de la pestaña Consulta para pasar los parámetros como variables a las consultas o mutaciones. Las variables funcionan de la misma manera que las variables en cualquier otro lenguaje de programación. Cada variable debe declararse con un nombre que se usa para tener acceso al valor almacenado en ella. Con el ejemplo de mutación anterior, puede modificarlo ligeramente para utilizar las variables de consulta.

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

Defina las variables en el panel como en el ejemplo siguiente.

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

Las variables hacen que el código de mutación sea más limpio y fácil la lectura, prueba y modificación de parámetros.

Contenido relacionado

• Vista de esquema y explorador de esquemas de la API de Fabric para GraphQL