Bagikan melalui

Fabric API untuk tampilan skema GraphQL dan penjelajah skema

  • Artikel

Catatan

Microsoft Fabric API untuk GraphQL sedang dalam pratinjau.

Skema GraphQL, yang didasarkan pada GraphQL Schema Definition Language (SDL), menentukan format data yang diekspos dalam API. Ini adalah lapisan abstraksi yang memberikan fleksibilitas kepada konsumen sambil menyembunyikan detail implementasi backend. Skema didasarkan pada kumpulan jenis objek yang berisi bidang.

Tampilan skema

Anda dapat mengakses tampilan skema dengan memilih Skema di sudut kiri bawah layar Pengembangan Data. Tampilan menunjukkan versi berbasis teks GraphQL SDL dengan jenis, bidang, dan operasi yang dihasilkan.

Gambar berikut adalah contoh tampilan skema, termasuk daftar objek yang luas yang tersedia dalam skema ini.

Catatan

Tampilan skema bersifat baca-saja. Anda hanya dapat mengubah objek di penjelajah Skema.

Cuplikan layar tampilan skema API, yang menyertakan penjelajah Skema di panel kiri.

Penjelajah skema

Penjelajah skema terletak di panel di sebelah kiri, dan juga tersedia saat Anda menggunakan editor dalam tampilan kueri. Penjelajah memungkinkan pengguna untuk dengan cepat memvisualisasikan jenis dan bidang yang tersedia, serta kueri dan mutasi, yang ditentukan dalam API.

Semua jenis GraphQL yang tersedia dari objek yang Anda pilih saat Anda menyambungkan ke sumber data muncul di daftar Penjelajah skema. Jenis muncul di bawah nama sumber data tempat mereka berasal. Dalam gambar berikut, Anda melihat jenis SalesOrderDetail yang berasal dari tabel SalesOrderDetail di titik akhir analitik AdventureWorks SQL.

Cuplikan layar panel Penjelajah skema, memperlihatkan daftar tipe yang diperluas yang tersedia di bawah contoh sumber data bernama SalesOrderDetail.

Selain jenis, Fabric API untuk GraphQL secara otomatis menghasilkan kueri dan mutasi untuk objek baru yang Anda pilih untuk diekspos.

Dalam contoh AdventureWorks kami, memperluas daftar kueri menunjukkan kueri yang dihasilkan secara otomatis untuk sumber data.

Cuplikan layar panel Penjelajah skema, memperlihatkan daftar kueri yang dihasilkan secara otomatis.

Untuk melihat mutasi yang dihasilkan secara otomatis oleh API, perluas simpul mutasi di pohon penjelajah Skema.

Cuplikan layar panel Penjelajah skema, memperlihatkan daftar mutasi yang dihasilkan secara otomatis.

Mengubah objek menggunakan penjelajah Skema

Anda dapat menggunakan penjelajah Skema untuk memodifikasi objek setelah API membuatnya untuk Anda. Dalam contoh berikut, kami memilih elipsis di samping jenis SalesOrderDetail yang berasal dari database AdventureWorks kami:

Cuplikan layar penjelajah Skema dengan elipsis dipilih, memperlihatkan opsi menu yang tersedia.

Pilihan berikut tersedia:

  • Memperbarui skema - Memungkinkan Anda memperbarui skema dengan objek baru dari sumber data.
  • Ganti nama - Mengubah nama objek. HARAP DICATAT: Perubahan ini hanya memengaruhi skema API, dan tidak berpengaruh pada objek sumber data asli dari mana ia berasal.
  • Hapus dari skema - Menghapus objek secara efektif dari skema GraphQL sehingga Anda tidak dapat lagi mereferensikannya.
  • Mengelola hubungan - Membawa Anda ke pengalaman manajemen hubungan. Untuk informasi selengkapnya, lihat Mengelola hubungan di Fabric API untuk GraphQL.
  • Properti - Menampilkan informasi tambahan tentang objek.

Konten terkait