Κοινοποίηση μέσω

Περιορισμοί του API Microsoft Fabric για GraphQL

Οι τρέχοντες γενικοί περιορισμοί προϊόντων για το API για GraphQL στο Microsoft Fabric παρατίθενται σε αυτό το άρθρο. Βελτιώνουμε συνεχώς το API για το GraphQL με νέες δυνατότητες. Για περισσότερες πληροφορίες σχετικά με το μέλλον του Microsoft Fabric, ανατρέξτε στο θέμα Fabric Roadmap.

Ποιος πρέπει να κατανοήσει τους περιορισμούς

Η κατανόηση των περιορισμών του GraphQL API είναι ζωτικής σημασίας για:

  • Προγραμματιστές εφαρμογών που σχεδιάζουν εφαρμογές που λειτουργούν εντός περιορισμών Fabric GraphQL API
  • Μηχανικοί δεδομένων που σχεδιάζουν στρατηγικές έκθεσης δεδομένων και κατανοούν τα όρια της πλατφόρμας
  • Αρχιτέκτονες λύσεων που προσδιορίζουν λύσεις που βασίζονται σε ύφασμα και θέτουν τις κατάλληλες τεχνικές προσδοκίες
  • Οι συμβάλλοντες χώρου εργασίας Fabric αντιμετωπίζουν προβλήματα και υλοποιούν λύσεις για τους τρέχοντες περιορισμούς
  • Οι διαχειριστές έργων κοινοποιούν τους περιορισμούς της πλατφόρμας Fabric στους ενδιαφερόμενους κατά τον σχεδιασμό του έργου

Ελέγξτε αυτούς τους περιορισμούς όταν σχεδιάζετε υλοποιήσεις GraphQL API ή αντιμετωπίζετε προβλήματα απροσδόκητης συμπεριφοράς API.

Λειτουργίες προέλευσης δεδομένων

Οι προελεύσεις δεδομένων τελικού σημείου SQL Analytics υποστηρίζουν μόνο λειτουργίες ανάγνωσης. Οι προελεύσεις δεδομένων στις οποίες έχετε πρόσβαση μέσω των τελικών σημείων ανάλυσης SQL (όπως τα Lakehouses και οι βάσεις δεδομένων κατοπτρισμού) δεν υποστηρίζουν μεταλλάξεις. Μπορείτε να υποβάλετε ερωτήματα για δεδομένα, αλλά δεν μπορείτε να δημιουργήσετε, να ενημερώσετε ή να διαγράψετε εγγραφές μέσω του GraphQL API.

Όρια μεγέθους και απόδοσης

Ο παρακάτω πίνακας συνοψίζει τους περιορισμούς μεγέθους, σελιδοποίησης και απόδοσης κλειδιού:

Τύπος ορίου Τιμή Περιγραφή Λύση
Προεπιλεγμένο μέγεθος σελίδας 100 είδη Μέγιστος αριθμός επιστρεφόμενων τεκμηρίων ανά αίτημα από προεπιλογή Χρησιμοποιήστε τη σελιδοποίηση GraphQL για να επαναλάβετε μεγαλύτερα σύνολα αποτελεσμάτων
Μέγιστο μέγεθος σελιδοποίησης 100.000 είδη Μέγιστος αριθμός συνολικών στοιχείων που μπορούν να ανακτηθούν μέσω σελιδοποίησης Έκδοση πολλαπλών φιλτραρισμένων αιτημάτων εάν χρειάζεστε περισσότερα από 100 στοιχεία (ασυνήθιστο μοτίβο στο GraphQL)
Μέγιστο μέγεθος απόκρισης 64 MB Μέγιστο μέγεθος ωφέλιμου φορτίου απόκρισης API Έκδοση πολλαπλών φιλτραρισμένων αιτήσεων για ανάκτηση δεδομένων σε μικρότερα τμήματα
Χρονικό όριο αίτησης 100 δευτερόλεπτα Μέγιστος χρόνος εκτέλεσης για ένα μόνο αίτημα Βελτιστοποιήστε τα ερωτήματα ή χωρίστε τις σύνθετες λειτουργίες σε μικρότερα αιτήματα
Μέγιστο βάθος ερωτήματος 10 επίπεδα Μέγιστο επίπεδο ένθεσης πεδίων σε ένα ερώτημα Μειώστε την ένθεση ερωτημάτων για να αποφύγετε προβλήματα επιδόσεων από την υπερβολική ανάκτηση δεδομένων

Περιορισμοί αποθηκευμένης διαδικασίας

Οι αποθηκευμένες διαδικασίες στο Azure SQL, στη βάση δεδομένων SQL στο Fabric και στις αποθήκες δεδομένων έχουν συγκεκριμένους περιορισμούς:

  • Χειρισμός συνόλου αποτελεσμάτων: Χρησιμοποιείται μόνο το πρώτο σύνολο αποτελεσμάτων που επιστρέφεται από την αποθηκευμένη διαδικασία. Δεν υποστηρίζονται πολλά σύνολα αποτελεσμάτων.
  • Απαιτήσεις μεταδεδομένων: Υποστηρίζονται μόνο αποθηκευμένες διαδικασίες των οποίων μπορούν να περιγραφούν τα μεταδεδομένα του sys.dm_exec_describe_first_result_set πρώτου συνόλου αποτελεσμάτων.
  • Προτεραιότητα παραμέτρου: Όταν μια παράμετρος αποθηκευμένης διαδικασίας καθορίζεται τόσο στο αρχείο ρύθμισης παραμέτρων όσο και στη συμβολοσειρά ερωτήματος URL, η τιμή συμβολοσειράς ερωτήματος URL έχει προτεραιότητα.
  • Περιορισμένες δυνατότητες GraphQL: Οι οντότητες που υποστηρίζονται από αποθηκευμένες διαδικασίες έχουν μειωμένες δυνατότητες σε σύγκριση με οντότητες που υποστηρίζονται από πίνακα ή προβολή:
    • Δεν υπάρχει υποστήριξη σελιδοποίησης
    • Χωρίς παραγγελία ή φιλτράρισμα
    • Δεν υπάρχουν αναζητήσεις βάσει πρωτεύοντος κλειδιού

Γνωστά προβλήματα

Για γνωστά ζητήματα στο API για GraphQL, επισκεφθείτε γνωστών ζητημάτων του Microsoft Fabric.

Σχετικό περιεχόμενο

  • Last updated on