Mengelola hubungan di Fabric API untuk GraphQL

Catatan

Microsoft Fabric API untuk GraphQL sedang dalam pratinjau.

Salah satu fitur paling kuat dalam GraphQL adalah kemampuan untuk membangun hubungan di seluruh jenis, termasuk dukungan untuk hubungan satu-ke-satu (1:1), satu-ke-banyak (1:N), dan banyak-ke-banyak (M:N).

Membuat hubungan satu-ke-satu (1:1) baru

1. Dari panel Penjelajah skema, pilih elipsis di samping jenis dan pilih opsi Kelola hubungan . Layar Kelola hubungan muncul.

   

2. Pilih Hubungan baru. Untuk contoh ini, kami membuat hubungan satu-ke-satu baru antara jenis Produk dan jenis ProductModel , berdasarkan bidang ProductModelID yang ada di kedua jenis. Kami memilih Satu ke satu untuk Kardinalitas, pilih jenis Dari dan Ke , lalu pilih bidang Dari dan Ke untuk hubungan ini.

   

   Catatan

   Anda dapat memilih beberapa bidang di pemilih bidang Dari dan Ke. Fitur ini memungkinkan Anda membuat hubungan yang terdiri dari beberapa bidang.

3. Pilih Buat hubungan. Daftar hubungan Anda sekarang menunjukkan hubungan yang baru dibuat.

   

4. Pilih X di sudut kanan atas untuk menutup layar Kelola hubungan .

Hubungan satu ke banyak (1:N) dan banyak ke banyak (M:N)

Untuk membuat hubungan satu-ke-banyak (1:N), misalnya, antara Produk dan Pesanan, di mana setiap produk dapat dikaitkan dengan beberapa pesanan, pilih Satu ke banyak sebagai kardinalitas. Hubungan ini mencerminkan gagasan bahwa satu produk dapat ditautkan ke beberapa pesanan tetapi setiap pesanan hanya ditautkan ke satu produk.

Untuk hubungan banyak ke banyak (M:N), seperti antara Buku dan Penulis, di mana buku dapat memiliki beberapa penulis dan penulis dapat memiliki beberapa buku, pilih Banyak hingga Banyak sebagai kardinalitas. Anda harus memiliki jenis penautan dalam skema Anda untuk mengakomodasi hubungan semacam ini.

Dialog Hubungan baru memperlihatkan kepada Anda sekumpulan pemilih lain saat Anda memilih Banyak ke banyak sebagai kardinalitas. Dalam contoh Buku dan Penulis, Anda akan memilih jenis penautan seperti BooksAuthors, dan bidang seperti BookId dan AuthorId sebagai penautan dari dan ke bidang.

Pertimbangan untuk hubungan banyak ke banyak

Jika jenis penautan Anda berisi satu atau beberapa bidang yang tidak direferensikan sebagai bidang Dari atau bidang Kepada, API untuk GraphQL secara otomatis menghasilkan empat hubungan satu-ke-banyak, sebagai berikut:

• Hubungan satu ke banyak dari jenis Dari ke jenis Penautan
• Hubungan satu ke banyak dari jenis Penautan ke jenis Dari
• Hubungan satu-ke-banyak dari jenis Kepada ke jenis Penautan
• Hubungan satu-ke-banyak dari jenis Penautan ke jenis Ke

Ini memungkinkan Anda untuk mereferensikan bidang yang tidak ditautkan dalam jenis Penautan dalam kueri atau mutasi apa pun, sekaligus memungkinkan kueri/mutasi yang mereferensikan hubungan ke arah mana pun.

Jika tidak ada bidang yang tidak ditautkan dalam jenis Penautan, hubungan banyak-ke-banyak tunggal akan dibuat, dan kueri atau mutasi apa pun tidak perlu mereferensikan jenis Penautan untuk memanfaatkan hubungan.

Menghapus hubungan

Anda bisa menghapus hubungan dari layar Kelola hubungan dengan memilih kotak centang di samping hubungan lalu memilih Hapus.

Konten terkait

• Fabric API untuk editor GraphQL