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
- Perangkat alat yang kaya - Memungkinkan penggunaan serangkaian peralatan pengembang yang luas
Ini adalah cara yang lebih efisien bagi aplikasi untuk berkomunikasi dengan server dan database.
Apa itu API Microsoft Fabric untuk GraphQL?
Microsoft Fabric API untuk GraphQL adalah layanan terkelola yang memungkinkan Anda membuat API GraphQL dalam hitungan detik.
Sumber data yang didukung:
- Microsoft Fabric Gudang Data
- Microsoft Fabric Lakehouses
- Microsoft Fabric Database Cermin
- Microsoft Fabric Database SQL
- 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 access ke sumber data untuk melakukan kueri atau mutasi?
Microsoft Entra ID authentication: API untuk GraphQL mengharuskan aplikasi menggunakan Microsoft Entra ID 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 Power BI service. Untuk informasi selengkapnya, lihat Buat aplikasi Microsoft Entra di Azure.
Konfigurasi masuk tunggal (SSO): Jika API dikonfigurasi untuk menggunakan SSO, pengguna atau perwakilan layanan yang diautentikasi memerlukan akses ke kedua tugas berikut:
- API GraphQL (Izin Jalankan Kueri dan Mutasi )
- Sumber data (baca atau tulis akses sesuai kebutuhan)
Opsi akses tingkat Workspace: Sebagai alternatif, tetapkan pengguna atau perwakilan layanan sebagai anggota workspace dengan peran kontributor di mana item API dan sumber data berada. Ini memberikan akses yang diperlukan untuk kedua item dari satu lokasi. Untuk informasi selengkapnya, lihat Memberikan pengguna akses ke ruang kerja.
Konfigurasi kredensial yang disimpan: Jika API dikonfigurasi untuk menggunakan kredensial yang disimpan, pengguna atau perwakilan layanan yang diautentikasi hanya memerlukan access ke API (pilih Kueri dan Mutasi saat menambahkan izin access langsung ke API).
Contoh: Anda dapat menemukan contoh end-to-end dengan kode sampel untuk perwakilan pengguna dan perwakilan layanan di Connect Applications.
Bagaimana saya membuka tiket dukungan API GraphQL?
Untuk mendapatkan bantuan dari Microsoft Support tentang masalah apa pun yang terkait dengan Fabric API untuk GraphQL, kunjungi situs dukungan Fabric kami dan pilih opsi Data Engineering.
Apakah API untuk GraphQL mendukung Private Link?
API untuk GraphQL hanya mendukung Tenant Level Private Link saat ini.
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 masalah tertentu.