Βρείτε απαντήσεις σε συνήθεις ερωτήσεις για το Fabric API για ερωτήσεις GraphQL.
Τι είναι το GraphQL;
Το GraphQL είναι μια γλώσσα ερωτημάτων για API που επιτρέπει στις εφαρμογές να ζητούν ακριβώς τα δεδομένα που χρειάζονται. Τα βασικά οφέλη περιλαμβάνουν τα εξής:
- Ισχυρό σύστημα τύπου - Περιγράφει με σαφήνεια τα διαθέσιμα δεδομένα
- Ακριβής ανάκτηση δεδομένων - Μειώνει την υπερβολική ανάκτηση επιτρέποντας συγκεκριμένα αιτήματα
- Συμβατότητα προς τα πίσω - Διευκολύνει τις ενημερώσεις API χωρίς να σπάει τον υπάρχοντα κώδικα
- Εμπλουτισμένα εργαλεία - Επιτρέπει τη χρήση ενός ευρέος συνόλου developer tools
Είναι ένας πιο αποτελεσματικός τρόπος επικοινωνίας των εφαρμογών με διακομιστές και βάσεις δεδομένων.
Τι είναι το Microsoft Fabric API για το GraphQL;
Το Microsoft Fabric API για GraphQL είναι μια διαχειριζόμενη υπηρεσία που σας δίνει τη δυνατότητα να δημιουργήσετε ένα GraphQL API σε δευτερόλεπτα.
Υποστηριζόμενες πηγές δεδομένων:
- Αποθήκες δεδομένων Microsoft Fabric
- Microsoft Fabric Lakehouses
- Βάσεις δεδομένων κατοπτρισμού Microsoft Fabric
- Βάσεις δεδομένων Microsoft Fabric SQL
- Βάσεις δεδομένων Azure SQL
Παρέχει ένα ενοποιημένο επίπεδο API για την υποβολή ερωτημάτων και τη μετάλλαξη δεδομένων από αυτές τις υποστηριζόμενες προελεύσεις δεδομένων.
Ποιες λειτουργίες GraphQL υποστηρίζονται στο API Fabric για GraphQL;
Μόνο ερωτήματα GraphQL (ανάγνωση) και μεταλλάξεις (εγγραφή) υποστηρίζονται επί του παρόντος. Οι προελεύσεις δεδομένων που εκτίθενται μέσω τελικών σημείων της ανάλυσης SQL υποστηρίζουν μόνο για ανάγνωση, υποστηρίζοντας μόνο Ερωτήματα. Για τις αποθήκες δεδομένων, πρέπει να οριστεί ένα πρωτεύον κλειδί για την αυτόματη δημιουργία μεταλλάξεων.
Πώς μπορώ να προβάλω και επεξεργαστώ επιλύεις στο API Fabric για GraphQL;
Οι επιλύσεις είναι στοιχεία GraphQL που παρέχουν επιχειρηματική λογική για την επίλυση πεδίων στο API και την εκτέλεση λειτουργιών με δεδομένα που βρίσκονται στις προελεύσεις δεδομένων.
Αυτόματη παραγωγή: Το Fabric δημιουργεί αυτόματα προγράμματα επίλυσης κάθε φορά που επισυνάπτετε μια νέα προέλευση δεδομένων ή επιλέγετε νέα αντικείμενα που θα εκτεθούν από μια υπάρχουσα προέλευση δεδομένων.
Προσαρμογή: Προς το παρόν, δεν είναι δυνατή η απευθείας προσαρμογή των αναλυτών. Για προσαρμοσμένη επιχειρηματική λογική στο API για GraphQL, μπορείτε να δημιουργήσετε μια αποθηκευμένη διαδικασία στην προέλευση δεδομένων και να την εμφανίσετε στο GraphQL API.
Απαιτεί το API για την εφαρμογή πελάτη GraphQL access στην πηγή δεδομένων για την εκτέλεση ερωτημάτων ή μεταλλάξεων;
Microsoft Entra ID έλεγχος ταυτότητας: Το API για GraphQL απαιτεί από τις εφαρμογές να χρησιμοποιούν Microsoft Entra ID για έλεγχο ταυτότητας. Η εφαρμογή-πελάτης σας πρέπει να καταχωρηθεί και να ρυθμιστεί ώστε να εκτελεί κλήσεις API στο Fabric.
Απαιτούμενα δικαιώματα:
- Η εφαρμογή που είναι εγγεγραμμένη στο Microsoft Entra απαιτεί δικαιώματα GraphQLApi.Execute.All για το Power BI service. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Δημιουργία εφαρμογής Microsoft Entra στο Azure.
Διαμόρφωση καθολικής σύνδεσης (SSO): Εάν το API έχει ρυθμιστεί ώστε να χρησιμοποιεί SSO, ο χρήστης ή η κύρια υπηρεσία που έχει υποβληθεί σε έλεγχο ταυτότητας απαιτεί access και στα δύο:
- Το GraphQL API (άδεια εκτέλεσης ερωτημάτων και μεταλλάξεων )
- Η προέλευση δεδομένων (access ανάγνωσης ή εγγραφής ανάλογα με τις ανάγκες)
Επιλογή access σε επίπεδο χώρου εργασίας: Εναλλακτικά, αντιστοιχίστε τον χρήστη ή την κύρια υπηρεσία ως μέλος χώρου εργασίας με ρόλο συμβάλλοντα όπου βρίσκονται τόσο τα στοιχεία API όσο και τα στοιχεία προέλευσης δεδομένων. Αυτό δίνει την απαιτούμενη access και στα δύο στοιχεία από ένα μόνο μέρος. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Παροχή access στους χρήστες σε χώρους εργασίας.
Διαμόρφωση αποθηκευμένων διαπιστευτηρίων: Εάν το API έχει ρυθμιστεί ώστε να χρησιμοποιεί αποθηκευμένα διαπιστευτήρια, ο χρήστης ή η κύρια υπηρεσία που έχει υποβληθεί σε έλεγχο ταυτότητας χρειάζεται μόνο access στο API (επιλέξτε Εκτέλεση ερωτημάτων και μεταλλάξεων κατά την προσθήκη δικαιωμάτων άμεσης access στο API).
Παραδείγματα: Μπορείτε να βρείτε ένα ολοκληρωμένο παράδειγμα με δείγμα κώδικα τόσο για τις αρχές χρήστη όσο και για τις κύριες υπηρεσίες στη Σύνδεση εφαρμογών.
How do I open a support ticket for API for GraphQL;
Για να λάβετε βοήθεια από Microsoft Support σχετικά με οποιοδήποτε ζήτημα που σχετίζεται με το Fabric API για GraphQL, επισκεφτείτε την τοποθεσία υποστήριξης Fabric και επιλέξτε την επιλογή Data Engineering.
Το API για GraphQL υποστηρίζει Private Link;
Το API για GraphQL υποστηρίζει μόνο Tenant Level Private Link αυτήν τη στιγμή.
Γιατί η αίτησή μου δεν λειτουργεί σωστά την πρώτη φορά που την εκδώνω και, στη συνέχεια, αποδίδει καλά σε επόμενες αιτήσεις;
Υπάρχουν δύο κύριοι λόγοι για αυτή τη συμπεριφορά «ψυχρής εκκίνησης»:
Προθέρμανση πηγής δεδομένων:
- Η πρώτη αίτηση μπορεί να διαρκέσει περισσότερο, εάν μια προέλευση δεδομένων πρέπει να θερμανθεί από ψυχρή κατάσταση
- Ακόμα κι αν η πηγή δεδομένων δεν είναι κρύα, η ανάκτηση δεδομένων μπορεί να μην είναι τόσο αποτελεσματική την πρώτη φορά που το GraphQL εκδίδει ένα ερώτημα εάν η πηγή δεδομένων δεν έχει φορτώσει τα απαραίτητα δεδομένα στη μνήμη
Προετοιμασία τελικού σημείου API:
- Το πρώτο αίτημα σε ένα API για τελικό σημείο GraphQL μπορεί να διαρκέσει περισσότερο, επειδή το σύστημα πρέπει να φορτώσει το σχήμα και τη διαμόρφωσή σας
- Τα επόμενα αιτήματα είναι πιο γρήγορα γιατί το σύστημα έχει ήδη ζεσταθεί και είναι έτοιμο να εξυπηρετήσει τα αιτήματά σας
Μπορείτε να βρείτε περισσότερες πληροφορίες στις βέλτιστες πρακτικές απόδοσης.
Πώς μπορώ να παρέχω σχόλια ή προτάσεις για το API για GraphQL;
Είναι ευπρόσδεκτα τα σχόλια και οι προτάσεις σας! Μπορείτε να παρέχετε σχόλια μέσω του Fabric Ideas. Η ομάδα μας παρακολουθεί ενεργά τα σχόλια και τις προτάσεις που υποβάλλονται μέσω αυτής της πλατφόρμας. Μπορείτε επίσης να επικοινωνήσετε μαζί μας μέσω Microsoft Fabric Support για τυχόν συγκεκριμένες απορίες ή ανησυχίες.