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. Keuntungan utamanya meliputi:
- Sistem jenis yang kuat - Menjelaskan data yang tersedia dengan jelas
- Pengambilan data yang tepat - Mengurangi pengambilan berlebihan dengan mengizinkan permintaan tertentu
- Kompatibilitas mundur - Membuat pembaruan API lebih mudah tanpa merusak kode yang ada
- Peralatan yang lengkap - Memungkinkan penggunaan alat pengembang dengan jangkauan 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.
Sumber data yang didukung:
- Gudang Data Microsoft Fabric
- Microsoft Fabric Lakehouses
- Microsoft Fabric Mirrored Databases
- Microsoft Fabric SQL Databases
- Azure SQL Database
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. Untuk 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.
Pembuatan otomatis: Fabric secara otomatis menghasilkan resolver setiap kali Anda melampirkan sumber data baru atau memilih objek baru untuk diekspos dari sumber data yang ada.
Kustomisasi: Saat ini, tidak mungkin untuk menyesuaikan resolver secara langsung. 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?
Autentikasi ID Microsoft Entra: API untuk GraphQL mengharuskan aplikasi menggunakan ID Microsoft Entra untuk autentikasi. Aplikasi klien Anda harus didaftarkan dan dikonfigurasi untuk menjalankan panggilan API terhadap Fabric.
Izin yang diperlukan:
- 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.
Konfigurasi akses menyeluruh (SSO): Jika API dikonfigurasi untuk menggunakan SSO, pengguna atau perwakilan layanan yang diautentikasi memerlukan akses ke keduanya:
- API GraphQL (Izin Jalankan Kueri dan Mutasi )
- Sumber data (akses baca atau tulis sesuai kebutuhan)
Opsi akses tingkat ruang kerja: Atau, tetapkan pengguna atau perwakilan layanan sebagai anggota ruang kerja dengan peran kontributor di mana API dan item sumber data berada. Ini memberikan akses yang diperlukan ke kedua item dari satu tempat. Untuk informasi selengkapnya, lihat Memberi pengguna akses ke ruang kerja.
Konfigurasi kredensial tersimpan: Jika API dikonfigurasi untuk menggunakan kredensial yang disimpan, pengguna atau perwakilan layanan yang diautentikasi hanya memerlukan akses ke API (pilih opsi Jalankan Kueri dan Mutasi saat menambahkan izin akses langsung ke API).
Contoh: 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.
Mengapa permintaan saya berkinerja buruk saat pertama kali saya mengeluarkannya, lalu berkinerja baik pada permintaan berikutnya?
Ada dua alasan utama untuk perilaku "cold start" ini:
Pemanasan sumber data:
- Permintaan pertama mungkin memakan waktu lebih lama jika sumber data perlu dihangatkan dari keadaan 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
Inisialisasi titik akhir API:
- Permintaan pertama ke API untuk titik akhir GraphQL mungkin memakan waktu lebih lama karena sistem perlu memuat skema dan konfigurasi Anda
- Permintaan berikutnya lebih cepat karena sistem sudah dihangatkan dan siap 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.