Bagikan melalui

Batasan Microsoft Fabric API untuk GraphQL

  • Artikel

Artikel ini merinci batasan saat ini di Microsoft Fabric API untuk GraphQL.

Keterbatasan

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.

  • Sumber data apa pun yang memanfaatkan Titik Akhir Analitik SQL untuk akses hanya mendukung operasi baca terhadapnya. Misalnya, mutasi tidak tersedia untuk Lakehouses atau database cermin.
  • Ukuran halaman default saat ini adalah 100, yang berarti bahwa setiap permintaan akan mengembalikan maksimum 100 elemen dalam balasan. Jika kumpulan hasil Anda lebih besar dari 100, lakukan iterasi melalui hasil menggunakan paginasi GraphQL .
  • Ukuran penomoran halaman maksimum adalah 100.000. Ini berarti ada batas maksimum tetap jumlah elemen yang akan dikembalikan oleh permintaan dan yang bisa Anda iterasi. Jika Anda perlu mengembalikan lebih dari 100K elemen untuk aplikasi Anda, terbitkan beberapa permintaan. Pahami bahwa pola ini tidak umum di GraphQL.
  • Ukuran balasan maksimum yang kami dukung adalah 64MB. Itu berarti bahwa setiap permintaan API dengan ukuran balasan yang lebih besar dari 64MB mengembalikan kesalahan. Untuk mengatasi batasan ini, Anda dapat mengeluarkan beberapa permintaan yang difilter.
  • Batasan untuk Prosedur Tersimpan (Berlaku untuk Azure SQL, SQL Database di Fabric, dan Gudang Data):
    • Hanya set hasil pertama yang dikembalikan oleh prosedur tersimpan yang digunakan oleh API GraphQL.
    • Hanya prosedur tersimpan yang metadatanya untuk set hasil pertama yang dijelaskan oleh sys.dm_exec_describe_first_result_set didukung.
    • Saat parameter prosedur tersimpan ditentukan baik dalam file konfigurasi maupun dalam string kueri URL, parameter dalam string kueri URL lebih diutamakan.
    • Entitas yang didukung oleh prosedur tersimpan tidak memiliki semua kemampuan yang secara otomatis disediakan untuk entitas yang didukung oleh tabel atau tampilan.
    • Entitas yang didukung oleh prosedur tersimpan tidak mendukung penomoran halaman, pengurutan, atau pemfilteran. Entitas tersebut juga tidak mendukung pengembalian item yang ditentukan oleh nilai kunci utama.
  • Batas waktu permintaan saat ini adalah 100 detik. Ini berarti bahwa jika Anda mengeluarkan permintaan yang menghasilkan kueri sumber data yang memerlukan waktu lebih dari 100 detik untuk diselesaikan, permintaan Anda mungkin gagal dan menghasilkan kesalahan.

Masalah yang diketahui

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

Konten terkait