Bagikan melalui

Batasan Microsoft Fabric API untuk GraphQL

Batasan produk umum saat ini untuk API untuk GraphQL di Microsoft Fabric tercantum dalam artikel ini. Kami terus meningkatkan API untuk GraphQL dengan fitur baru. Untuk informasi selengkapnya tentang masa depan Microsoft Fabric, lihat Fabric Roadmap.

Siapa yang perlu memahami batasan

Memahami batasan API GraphQL sangat penting untuk:

  • Pengembang aplikasi yang merancang aplikasi yang bekerja dalam batasan Fabric GraphQL API
  • Teknisi data merencanakan strategi paparan data dan memahami batas platform
  • Arsitek solusi yang menentukan ruang lingkup solusi berbasis Fabric dan menetapkan ekspektasi teknis yang sesuai
  • Kontributor ruang kerja Fabric memecahkan masalah dan menerapkan solusi untuk batasan saat ini
  • Manajer proyek mengkomunikasikan batasan platform Fabric kepada pemangku kepentingan selama perencanaan proyek

Tinjau batasan ini saat merencanakan implementasi GraphQL API atau memecahkan masalah perilaku API yang tidak terduga.

Operasi sumber data

Sumber data Titik Akhir Analitik SQL hanya mendukung operasi baca. Sumber data yang diakses melalui Titik Akhir Analitik SQL (seperti Lakehouses dan database yang dicerminkan) tidak mendukung mutasi. Anda dapat mengkueri data tetapi tidak dapat membuat, memperbarui, atau menghapus rekaman melalui API GraphQL.

Batas ukuran dan performa

Tabel berikut ini meringkas ukuran kunci, penomoran halaman, dan batasan performa:

Jenis batas Nilai Description Penanganan masalah
Ukuran halaman bawaan 100 item Item maksimum yang dikembalikan per permintaan secara default Gunakan paginasi GraphQL untuk melakukan iterasi melalui set hasil yang lebih besar
Ukuran maksimum halaman 100.000 item Maksimum total item yang dapat diambil melalui pagination Terbitkan beberapa permintaan yang difilter jika Anda memerlukan lebih dari 100 ribu item (pola yang tidak biasa di GraphQL)
Ukuran respons maksimum 64 MB Ukuran maksimum payload respons API Menerbitkan beberapa permintaan yang difilter untuk mengambil data dalam gugus yang lebih kecil
Batas waktu permintaan habis 100 detik Waktu eksekusi maksimum untuk satu permintaan Mengoptimalkan kueri atau memecah operasi kompleks menjadi permintaan yang lebih kecil
Kedalaman kueri maksimum 10 Tingkat Tingkat peredaman maksimum bidang dalam kueri Kurangi pembenaman kueri untuk menghindari masalah kinerja dari pengambilan data yang berlebihan.

Batasan prosedur tersimpan

Prosedur tersimpan di Azure SQL, SQL Database di Fabric, dan Gudang Data memiliki batasan khusus:

  • Penanganan set hasil: Hanya set hasil pertama yang dikembalikan oleh prosedur simpan yang digunakan. Beberapa set hasil tidak didukung.
  • Persyaratan metadata: Hanya prosedur tersimpan yang metadata tataan hasil pertamanya dapat dijelaskan oleh sys.dm_exec_describe_first_result_set yang didukung.
  • Prioritas parameter: Saat parameter prosedur tersimpan ditentukan dalam file konfigurasi dan string kueri URL, nilai string kueri URL lebih diutamakan.
  • Fitur GraphQL Terbatas: Entitas yang didukung oleh prosedur tersimpan memiliki kemampuan yang berkurang dibandingkan dengan entitas tabel atau yang didukung tampilan:
    • Tidak ada dukungan paginasi
    • Tidak ada pemesanan atau pemfilteran
    • Tidak ada pencarian berbasis kunci primer

Masalah yang diketahui

Untuk masalah yang diketahui dalam API untuk GraphQL, kunjungi Masalah Umum Microsoft Fabric.

Konten terkait

  • Last updated on