Περιορισμοί του API Microsoft Fabric για GraphQL
Αυτό το άρθρο περιγράφει τους τρέχοντες περιορισμούς στο Microsoft Fabric API για GraphQL.
Περιορισμούς
Οι τρέχοντες γενικοί περιορισμοί προϊόντων για το API για GraphQL στο Microsoft Fabric παρατίθενται σε αυτό το άρθρο. Βελτιώνουμε συνεχώς το API για GraphQL με νέες δυνατότητες. Για περισσότερες πληροφορίες σχετικά με το μέλλον του Microsoft Fabric, ανατρέξτε στο θέμα Fabric Roadmap.
- Οποιαδήποτε προέλευση δεδομένων που αξιοποιεί ένα τελικό σημείο της ανάλυσης SQL για πρόσβαση υποστηρίζει μόνο λειτουργίες ανάγνωσης σε αυτό. Για παράδειγμα, οι μεταλλάξεις δεν είναι διαθέσιμες για lakehouses ή βάσεις δεδομένων κατοπτρισμού.
- Το τρέχον προεπιλεγμένο μέγεθος σελίδας είναι 100, το οποίο σημαίνει ότι κάθε αίτηση θα επιστρέψει έως και 100 στοιχεία στην απάντηση. Εάν το σύνολο αποτελεσμάτων σας είναι μεγαλύτερο από 100, επαναλάβετε τα αποτελέσματα χρησιμοποιώντας σελιδοποίηση GraphQL.
- Το μέγιστο μέγεθος σελιδοποίησης είναι 100.000. Αυτό σημαίνει ότι υπάρχει ένας σταθερός μέγιστος αριθμός στοιχείων που θα επιστρέψει μια αίτηση και μπορείτε να επαναλάβετε. Εάν θέλετε να επιστρέψετε περισσότερα από 100 χιλ. στοιχεία για την εφαρμογή σας, υποβάλετε πολλές αιτήσεις. Κατανοήστε ότι αυτό το μοτίβο δεν είναι σύνηθες στο GraphQL.
- Το μέγιστο μέγεθος απάντησης που υποστηρίζουμε είναι 64 MB. Αυτό σημαίνει ότι κάθε αίτηση API με μέγεθος απάντησης μεγαλύτερο από 64 MB επιστρέφει σφάλμα. Για να επιλύσετε αυτόν τον περιορισμό, μπορείτε να δημιουργήσετε πολλαπλές φιλτραρισμένες αιτήσεις.
- Περιορισμοί για αποθηκευμένες διαδικασίες (Ισχύει για azure SQL, βάση δεδομένων SQL στο Fabric και αποθήκες δεδομένων):
- Μόνο το πρώτο σύνολο αποτελεσμάτων που επιστρέφεται από την αποθηκευμένη διαδικασία χρησιμοποιείται από το API για GraphQL.
- Υποστηρίζονται μόνο εκείνες οι αποθηκευμένες διαδικασίες των οποίων τα μετα-δεδομένα για το πρώτο σύνολο αποτελεσμάτων περιγράφονται από sys.dm_exec_describe_first_result_set.
- Όταν καθορίζεται μια παράμετρος αποθηκευμένης διαδικασίας τόσο στο αρχείο ρύθμισης παραμέτρων όσο και στη συμβολοσειρά ερωτήματος διεύθυνσης URL, η παράμετρος στη συμβολοσειρά ερωτήματος διεύθυνσης URL έχει προτεραιότητα.
- Οι οντότητες που υποστηρίζονται από μια αποθηκευμένη διαδικασία δεν παρέχουν αυτόματα όλες τις δυνατότητες για οντότητες που υποστηρίζονται από πίνακες ή προβολές.
- Οι αποθηκευμένες οντότητες που υποστηρίζονται στη διαδικασία δεν υποστηρίζουν σελιδοποίηση, ταξινόμηση ή φιλτράρισμα. Ούτε οι οντότητες αυτές υποστηρίζουν την επιστροφή στοιχείων που καθορίζονται από τιμές πρωτεύοντος κλειδιού.
- Το χρονικό όριο αίτησης είναι αυτήν τη στιγμή 100 δευτερόλεπτα. Αυτό σημαίνει ότι εάν υποβάλετε μια αίτηση που δημιουργεί ένα ερώτημα προέλευσης δεδομένων που απαιτεί περισσότερο από 100 δευτερόλεπτα για να ολοκληρωθεί, η αίτησή σας ενδέχεται να αποτύχει και να εμφανιστεί σφάλμα.
Γνωστά προβλήματα
Για γνωστά ζητήματα στο API για GraphQL, επισκεφθείτε γνωστών ζητημάτων του Microsoft Fabric.