Fabric API untuk editor GraphQL

Catatan

Microsoft Fabric API untuk GraphQL sedang dalam pratinjau.

Fabric API untuk GraphQL menyediakan lingkungan pengembangan GraphQL dalam browser grafis, yang memungkinkan taman bermain interaktif untuk menyusun, menguji, dan melihat hasil langsung kueri dan mutasi GraphQL Anda.

Untuk membuka editor, buka API untuk item GraphQL di Fabric dan pilih Kueri di sudut kiri bawah layar portal Anda.

Anda dapat mengetik kode langsung pada tab Kueri . Kemampuan Intellisense tersedia dengan pintasan keyboard: CTRL + Space (Windows), atau Command + Space (macOS).

Pengembangan kueri dan mutasi

Tinjau skema GraphQL singkat berikut, yang menentukan satu Post jenis dengan kueri untuk membaca satu postingan atau mencantumkan semua postingan. Ini juga mendefinisikan mutasi untuk membuat, memperbarui, atau menghapus posting yang mendukung semua kasus penggunaan CRUDL (membuat, membaca, memperbarui, menghapus, mencantumkan).

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
}

Anda dapat membaca data yang diekspos melalui GraphQL menggunakan kueri apa pun yang ditentukan dalam skema. Kueri getPost akan terlihat seperti contoh berikut.

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

Respons:

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

Tulis data menggunakan mutasi seperti createPost membuat postingan dengan parameter yang diperlukan.

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

Respons:

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

Variabel kueri

Gunakan panel Variabel kueri di sisi kanan tab Kueri untuk meneruskan parameter apa pun sebagai variabel ke kueri atau mutasi Anda. Variabel bekerja dengan cara yang sama seperti variabel dalam bahasa pemrograman lainnya. Setiap variabel perlu dideklarasikan dengan nama yang digunakan untuk mengakses nilai yang disimpan di dalamnya. Dengan contoh mutasi sebelumnya, Anda dapat memodifikasinya sedikit untuk menggunakan variabel kueri.

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

Tentukan variabel di panel seperti contoh berikut.

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

Variabel membuat kode mutasi lebih bersih dan lebih mudah dibaca, diuji, dan diubah parameternya.

Konten terkait

• Fabric API untuk tampilan skema GraphQL dan penjelajah skema