Temukan jawaban atas pertanyaan Fabric API yang umum diajukan untuk GraphQL.
Apa itu GraphQL?
GraphQL adalah bahasa kueri untuk API yang memungkinkan aplikasi meminta data yang mereka butuhkan. Ini menggunakan sistem jenis yang kuat untuk menjelaskan data yang tersedia dengan jelas, mengurangi pengambilan berlebihan dengan memungkinkan permintaan yang tepat, membuat pembaruan API lebih mudah tanpa merusak kode yang ada, dan memungkinkan penggunaan serangkaian alat pengembang yang luas. Ini adalah cara yang lebih efisien bagi aplikasi untuk berkomunikasi dengan server dan database.
Apa itu Microsoft Fabric API untuk GraphQL?
Microsoft Fabric API untuk GraphQL adalah layanan terkelola yang memungkinkan Anda membuat API GraphQL dalam hitungan detik untuk mengakses data dari sumber data Anda seperti Microsoft Fabric Data Warehouses, Microsoft Fabric Lakehouses, Microsoft Fabric Mirrored Databases, Microsoft Fabric SQL Databases, dan Azure SQL Databases. Ini menyediakan lapisan API terpadu untuk mengkueri dan bermutasi data dari sumber data yang didukung ini.
Operasi GraphQL apa yang didukung di Fabric API untuk GraphQL?
Hanya kueri GraphQL (baca) dan mutasi (tulis) yang didukung saat ini. Sumber data yang diekspos melalui Titik Akhir Analitik SQL bersifat baca-saja sehingga hanya mendukung Kueri. Dalam kasus Gudang Data, kunci utama perlu didefinisikan agar Mutasi dibuat secara otomatis.
Bagaimana cara melihat dan mengedit resolver di Fabric API untuk GraphQL?
Resolver adalah komponen GraphQL yang menyediakan logika bisnis untuk menyelesaikan bidang di API dan melakukan operasi dengan data yang berada di sumber data. Fabric secara otomatis menghasilkan resolver setiap kali Anda melampirkan sumber data baru atau memilih objek baru untuk diekspos dari sumber data yang ada. Saat ini, penyelesai penyelesai tidak dapat disesuaikan. Untuk logika bisnis yang disesuaikan di API untuk GraphQL, Anda dapat membuat prosedur tersimpan di sumber data dan mengeksposnya di API GraphQL.
Apakah API untuk aplikasi klien GraphQL memerlukan akses ke sumber data untuk melakukan kueri atau mutasi?
API untuk GraphQL mengharuskan aplikasi menggunakan ID Microsoft Entra untuk autentikasi. Aplikasi klien Anda harus didaftarkan dan dikonfigurasi secara memadai untuk menjalankan panggilan API terhadap Fabric. Aplikasi yang terdaftar di Microsoft Entra memerlukan izin GraphQLApi.Execute.All untuk layanan Power BI. Untuk informasi selengkapnya, lihat Membuat aplikasi Microsoft Entra di Azure. Selain Microsoft Entra, jika API dikonfigurasi untuk menggunakan akses menyeluruh (SSO), pengguna atau perwakilan layanan yang diautentikasi dalam aplikasi yang memanggil API GraphQL memerlukan akses ke API GraphQL dan sumber data. Lebih khusus Jalankan izin Kueri dan Mutasi di API GraphQL dan akses baca atau tulis yang diperlukan dalam sumber data pilihan yang sesuai. Opsi lain adalah memiliki pengguna atau perwakilan layanan sebagai anggota ruang kerja dengan peran kontributor di mana API dan item sumber data berada, yang memberikan akses yang diperlukan ke kedua item dari satu tempat. Untuk informasi selengkapnya, lihat Memberi pengguna akses ke ruang kerja. Atau, jika API dikonfigurasi untuk menggunakan kredensial yang disimpan, pengguna atau perwakilan layanan yang diautentikasi hanya perlu memiliki akses ke API (Pilih opsi Jalankan Kueri dan Mutasi saat menambahkan izin akses langsung ke API). Anda dapat menemukan contoh end-to-end dengan kode sampel untuk perwakilan pengguna dan perwakilan layanan di Connect Applications.
Bagaimana cara membuka tiket dukungan untuk API untuk GraphQL?
Untuk mendapatkan bantuan dari Dukungan Microsoft tentang masalah apa pun yang terkait dengan Fabric API untuk GraphQL, kunjungi situs Dukungan Fabric kami dan pilih opsi Rekayasa Data.
Apakah API untuk GraphQL mendukung Private Link?
API untuk GraphQL saat ini tidak mendukung Private Link. Namun, kami berencana untuk mendukung fitur ini di masa mendatang dan akan memberikan pembaruan saat tersedia.
Saya mengaktifkan Private Link untuk penyewa Fabric saya. Mengapa item GraphQL saya tidak berfungsi?
Jika pengaturan penyewa "Blokir akses internet publik" diaktifkan (artinya, akses publik dinonaktifkan), artefak atau item yang tidak didukung secara otomatis dinonaktifkan, termasuk API untuk GraphQL. Ini berarti bahwa item yang dibuat sebelumnya tidak dapat diakses, juga tidak dapat dibuat item baru. Satu-satunya cara untuk mengakses item ini adalah dengan mengizinkan akses publik.
Mengapa permintaan saya berkinerja buruk saat pertama kali saya mengeluarkannya, lalu berkinerja baik pada permintaan berikutnya?
Ada dua alasan utama untuk perilaku ini. Pertama, permintaan pertama mungkin memakan waktu lebih lama jika sumber data perlu dihangatkan jika dingin. Bahkan jika sumber data tidak dingin, pengambilan data mungkin tidak seefisien pertama kali GraphQL mengeluarkan kueri, jika sumber data tidak memiliki data yang diperlukan yang dimuat dalam memori. Alasan kedua adalah bahwa permintaan pertama ke API untuk titik akhir GraphQL mungkin memakan waktu lebih lama karena sistem perlu memuat skema dan konfigurasi Anda agar siap menerima permintaan. Ini adalah biaya satu kali, dan permintaan berikutnya lebih cepat karena sistem sudah dihangatkan dan siap untuk melayani permintaan Anda. Anda dapat menemukan informasi selengkapnya dalam praktik terbaik performa.
Bagaimana cara memberikan umpan balik atau saran untuk API untuk GraphQL?
Kami menyambut umpan balik dan saran Anda! Anda dapat memberikan umpan balik melalui Fabric Ideas. Tim kami secara aktif memantau umpan balik dan saran yang dikirimkan melalui platform ini. Anda juga dapat menghubungi kami melalui Dukungan Microsoft Fabric untuk kueri atau kekhawatiran tertentu.