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