Βρείτε απαντήσεις σε συνήθεις ερωτήσεις για το Fabric API για ερωτήσεις GraphQL.
Τι είναι το GraphQL;
Το GraphQL είναι μια γλώσσα ερωτημάτων για API που επιτρέπει στις εφαρμογές να ζητούν ακριβώς τα δεδομένα που χρειάζονται. Τα βασικά οφέλη περιλαμβάνουν τα εξής:
- Ισχυρό σύστημα τύπου - Περιγράφει με σαφήνεια τα διαθέσιμα δεδομένα
- Ακριβής ανάκτηση δεδομένων - Μειώνει την υπερβολική ανάκτηση επιτρέποντας συγκεκριμένα αιτήματα
- Συμβατότητα προς τα πίσω - Διευκολύνει τις ενημερώσεις API χωρίς να σπάει τον υπάρχοντα κώδικα
- Εμπλουτισμένα εργαλεία - Επιτρέπει τη χρήση ενός ευρέος συνόλου εργαλείων προγραμματιστή
Είναι ένας πιο αποτελεσματικός τρόπος επικοινωνίας των εφαρμογών με διακομιστές και βάσεις δεδομένων.
Τι είναι το Microsoft Fabric API για GraphQL;
Το Microsoft Fabric API για GraphQL είναι μια διαχειριζόμενη υπηρεσία που σας δίνει τη δυνατότητα να δημιουργήσετε ένα GraphQL API σε δευτερόλεπτα.
Υποστηριζόμενες πηγές δεδομένων:
- Αποθήκες δεδομένων Microsoft Fabric
- Microsoft Fabric Lakehouses
- Βάσεις δεδομένων κατοπτρισμού Microsoft Fabric
- Βάσεις δεδομένων Microsoft Fabric SQL
- Βάσεις δεδομένων SQL Azure
Παρέχει ένα ενοποιημένο επίπεδο API για την υποβολή ερωτημάτων και τη μετάλλαξη δεδομένων από αυτές τις υποστηριζόμενες προελεύσεις δεδομένων.
Ποιες λειτουργίες GraphQL υποστηρίζονται στο API Fabric για GraphQL;
Μόνο ερωτήματα GraphQL (ανάγνωση) και μεταλλάξεις (εγγραφή) υποστηρίζονται επί του παρόντος. Οι προελεύσεις δεδομένων που εκτίθενται μέσω τελικών σημείων της ανάλυσης SQL υποστηρίζουν μόνο για ανάγνωση, υποστηρίζοντας μόνο Ερωτήματα. Για τις αποθήκες δεδομένων, πρέπει να οριστεί ένα πρωτεύον κλειδί για την αυτόματη δημιουργία μεταλλάξεων.
Πώς μπορώ να προβάλω και επεξεργαστώ επιλύεις στο API Fabric για GraphQL;
Οι επιλύσεις είναι στοιχεία GraphQL που παρέχουν επιχειρηματική λογική για την επίλυση πεδίων στο API και την εκτέλεση λειτουργιών με δεδομένα που βρίσκονται στις προελεύσεις δεδομένων.
Αυτόματη παραγωγή: Το Fabric δημιουργεί αυτόματα προγράμματα επίλυσης κάθε φορά που επισυνάπτετε μια νέα προέλευση δεδομένων ή επιλέγετε νέα αντικείμενα που θα εκτεθούν από μια υπάρχουσα προέλευση δεδομένων.
Προσαρμογή: Προς το παρόν, δεν είναι δυνατή η απευθείας προσαρμογή των αναλυτών. Για προσαρμοσμένη επιχειρηματική λογική στο API για GraphQL, μπορείτε να δημιουργήσετε μια αποθηκευμένη διαδικασία στην προέλευση δεδομένων και να την εμφανίσετε στο GraphQL API.
Το API για την εφαρμογή-πελάτη GraphQL απαιτεί πρόσβαση στην προέλευση δεδομένων για την εκτέλεση ερωτημάτων ή μεταλλάξεων;
Έλεγχος ταυτότητας Microsoft Entra ID: Το API για GraphQL απαιτεί από τις εφαρμογές να χρησιμοποιούν το Microsoft Entra ID για έλεγχο ταυτότητας. Η εφαρμογή-πελάτης σας πρέπει να καταχωρηθεί και να ρυθμιστεί ώστε να εκτελεί κλήσεις API στο Fabric.
Απαιτούμενα δικαιώματα:
- Η εφαρμογή που έχει καταχωρηθεί στο Microsoft Entra απαιτεί δικαιώματα GraphQLApi.Execute.All για την υπηρεσία Power BI. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Δημιουργία εφαρμογής Microsoft Entra στο Azure.
Διαμόρφωση καθολικής σύνδεσης (SSO): Εάν το API έχει ρυθμιστεί ώστε να χρησιμοποιεί SSO, ο χρήστης ή η κύρια υπηρεσία που έχει υποβληθεί σε έλεγχο ταυτότητας απαιτεί πρόσβαση και στα δύο:
- Το GraphQL API (άδεια εκτέλεσης ερωτημάτων και μεταλλάξεων )
- Το αρχείο προέλευσης δεδομένων (πρόσβαση ανάγνωσης ή εγγραφής, ανάλογα με τις ανάγκες)
Επιλογή πρόσβασης σε επίπεδο χώρου εργασίας: Εναλλακτικά, αναθέστε τον χρήστη ή την κύρια υπηρεσία ως μέλος χώρου εργασίας με ρόλο συμβάλλοντα όπου βρίσκονται τόσο το API όσο και τα στοιχεία προέλευσης δεδομένων. Αυτό δίνει την απαιτούμενη πρόσβαση και στα δύο στοιχεία από ένα μόνο μέρος. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Παροχή πρόσβασης στους χρήστες σε χώρους εργασίας.
Διαμόρφωση αποθηκευμένων διαπιστευτηρίων: Εάν το API έχει ρυθμιστεί ώστε να χρησιμοποιεί αποθηκευμένα διαπιστευτήρια, ο χρήστης ή η κύρια υπηρεσία που έχει υποβληθεί σε έλεγχο ταυτότητας χρειάζεται μόνο πρόσβαση στο API (επιλέξτε Εκτέλεση ερωτημάτων και μεταλλάξεων κατά την προσθήκη δικαιωμάτων άμεσης πρόσβασης στο API).
Παραδείγματα: Μπορείτε να βρείτε ένα ολοκληρωμένο παράδειγμα με δείγμα κώδικα τόσο για τις αρχές χρήστη όσο και για τις κύριες υπηρεσίες στη Σύνδεση εφαρμογών.
Πώς μπορώ να ανοίξω ένα δελτίο υποστήριξης για API για GraphQL;
Για να λάβετε βοήθεια από την Υποστήριξη της Microsoft για οποιοδήποτε ζήτημα σχετίζεται με το Fabric API για GraphQL, επισκεφθείτε την τοποθεσία υποστήριξης Fabric και επιλέξτε τη Διαχείριση δεδομένων.
Το API για GraphQL υποστηρίζει ιδιωτική σύνδεση;
Προς το παρόν, το API για GraphQL δεν υποστηρίζει ιδιωτική σύνδεση.
Γιατί η αίτησή μου δεν λειτουργεί σωστά την πρώτη φορά που την εκδώνω και, στη συνέχεια, αποδίδει καλά σε επόμενες αιτήσεις;
Υπάρχουν δύο κύριοι λόγοι για αυτή τη συμπεριφορά «ψυχρής εκκίνησης»:
Προθέρμανση πηγής δεδομένων:
- Η πρώτη αίτηση μπορεί να διαρκέσει περισσότερο, εάν μια προέλευση δεδομένων πρέπει να θερμανθεί από ψυχρή κατάσταση
- Ακόμα κι αν η πηγή δεδομένων δεν είναι κρύα, η ανάκτηση δεδομένων μπορεί να μην είναι τόσο αποτελεσματική την πρώτη φορά που το GraphQL εκδίδει ένα ερώτημα εάν η πηγή δεδομένων δεν έχει φορτώσει τα απαραίτητα δεδομένα στη μνήμη
Προετοιμασία τελικού σημείου API:
- Το πρώτο αίτημα σε ένα API για τελικό σημείο GraphQL μπορεί να διαρκέσει περισσότερο, επειδή το σύστημα πρέπει να φορτώσει το σχήμα και τη διαμόρφωσή σας
- Τα επόμενα αιτήματα είναι πιο γρήγορα γιατί το σύστημα έχει ήδη ζεσταθεί και είναι έτοιμο να εξυπηρετήσει τα αιτήματά σας
Μπορείτε να βρείτε περισσότερες πληροφορίες στις βέλτιστες πρακτικές απόδοσης.
Πώς μπορώ να παρέχω σχόλια ή προτάσεις για το API για GraphQL;
Είναι ευπρόσδεκτα τα σχόλια και οι προτάσεις σας! Μπορείτε να παρέχετε σχόλια μέσω του Fabric Ideas. Η ομάδα μας παρακολουθεί ενεργά τα σχόλια και τις προτάσεις που υποβάλλονται μέσω αυτής της πλατφόρμας. Μπορείτε επίσης να επικοινωνήσετε μαζί μας μέσω υποστήριξης Microsoft Fabric για οποιαδήποτε συγκεκριμένα ερωτήματα ή ζητήματα.