Δημιουργήστε ένα API για GraphQL στο Fabric και προσθέστε δεδομένα
Ξεκινήστε με το API Fabric για GraphQL δημιουργώντας ένα API και, στη συνέχεια, συνδέοντας μια προέλευση δεδομένων για να εκθέσετε τα δεδομένα που επιλέξατε μέσω του API. Το Fabric δημιουργεί αυτόματα το σχήμα GraphQL με βάση τα δεδομένα σας και οι εφαρμογές είναι έτοιμες να συνδεθούν σε λίγα λεπτά.
Προαπαιτούμενα στοιχεία
Δημιουργία API για GraphQL
Για να δημιουργήσετε ένα API για GraphQL:
Από την αρχική σελίδα της πύλης Fabric, επιλέξτε Διαχείριση δεδομένων από τη λίστα φόρτων εργασίας.
Επιλέξτε API για GraphQL (Προεπισκόπηση).
Εναλλακτικά, επιλέξτε Νέο>API για GraphQL (Προεπισκόπηση) από οποιονδήποτε χώρο εργασίας στη Διαχείριση δεδομένων.
Εισαγάγετε ένα Όνομα για το στοιχείο σας και επιλέξτε Δημιουργία.
Τώρα έχετε ένα πλήρως λειτουργικό API για να αποκτήσετε πρόσβαση στα δεδομένα σας στο Fabric.
Σύνδεση σε μια προέλευση δεδομένων και δημιουργία του σχήματός σας
Σε αυτό το σημείο, το API είναι έτοιμο, αλλά δεν εμφανίζει δεδομένα. Τα API για GraphQL ορίζονται σε ένα σχήμα οργανωμένο όσον αφορά τους τύπους και τα πεδία, σε ένα σύστημα ισχυρού τύπου. Το Fabric δημιουργεί αυτόματα το απαραίτητο σχήμα GraphQL με βάση τα δεδομένα που επιλέγετε για να εκθέσει σε προγράμματα-πελάτες GraphQL.
Στο νέο API σας, επιλέξτε μια προέλευση δεδομένων για έκθεση επιλέγοντας Επιλογή προέλευσης δεδομένων.
Στη συνέχεια, επιλέξτε τη συνδεσιμότητα για το API σας:
Εδώ μπορείτε να καθορίσετε τον τρόπο με τον οποίο τα προγράμματα-πελάτες API μπορούν να έχουν πρόσβαση στο API για την εκτέλεση αιτήσεων GraphQL με βάση δύο ξεχωριστές επιλογές:
- Καθολική σύνδεση (SSO): χρησιμοποιήστε διαπιστευτήρια προγράμματος-πελάτη για να συνδεθείτε σε προελεύσεις δεδομένων, το οποίο σημαίνει ότι ο εξουσιοδοτημένος χρήστης API πρέπει να έχει πρόσβαση στην υποκείμενη προέλευση δεδομένων. Για παράδειγμα, εάν εκθέτετε δεδομένα Lakehouse στα προγράμματα-πελάτες API σας, ο εξουσιοδοτημένος χρήστης πρέπει να έχει πρόσβαση τόσο στο API όσο και στο Lakehouse. Πιο συγκεκριμένα δικαιώματα Εκτέλεσης στο GraphQL API (επιλογή Εκτέλεση ερωτημάτων και μεταλλάξεων κατά την προσθήκη δικαιωμάτων άμεσης πρόσβασης) και αντίστοιχα δικαιώματα ανάγνωσης ή εγγραφής στην προέλευση δεδομένων της επιλογής. Εναλλακτικά, ο χρήστης μπορεί να προστεθεί ως μέλος του χώρου εργασίας με ρόλο συμβάλλοντα, όπου βρίσκονται τόσο το API όσο και τα στοιχεία προέλευσης δεδομένων, το οποίο θα παρέχει την απαιτούμενη πρόσβαση και στα δύο στοιχεία από μία μόνο θέση. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Παροχή πρόσβασης στους χρήστες σε χώρους εργασίας.
- Αποθηκευμένα διαπιστευτήρια: χρησιμοποιήστε αποθηκευμένα διαπιστευτήρια για να συνδεθείτε σε προελεύσεις δεδομένων, το οποίο σημαίνει ότι ο εξουσιοδοτημένος χρήστης API δεν απαιτεί άμεση πρόσβαση στην προέλευση δεδομένων. Ένα αποθηκευμένο διαπιστευτήριο χρησιμοποιείται από κοινού για πρόσβαση στα δεδομένα μεταξύ του API και των υποκείμενων πινάκων στην προέλευση δεδομένων. Για παράδειγμα, εάν εκθέτετε δεδομένα lakehouse στα προγράμματα-πελάτες API σας, ο εξουσιοδοτημένος χρήστης χρειάζεται απλώς να έχει άμεση πρόσβαση στο API (επιλογή Εκτέλεση ερωτημάτων και μεταλλάξεων κατά την προσθήκη δικαιωμάτων άμεσης πρόσβασης) και όχι στο Lakehouse. Ένα αποθηκευμένο διαπιστευτήριο χρησιμοποιείται για τη σύνδεση του API στην προέλευση δεδομένων και κοινοποιείται από όλους τους χρήστες API με έλεγχο ταυτότητας. Αυτή η επιλογή απαιτείται εάν εκθέτετε μια προέλευση δεδομένων Azure, όπως μια βάση δεδομένων AZure SQL μέσω GraphQL. Αφού επιλέξετε OK, θα σας ζητηθεί να δημιουργήσετε ένα νέο αποθηκευμένο διαπιστευτήριο αφού επιλέξετε μια προέλευση δεδομένων στο επόμενο βήμα, εάν δεν υπάρχει ήδη αποθηκευμένο διαπιστευτήριο για αυτό.
Όταν επιλεγούν, αυτές οι επιλογές επιβάλλονται για όλες τις προελεύσεις δεδομένων που προστίθενται στη συνέχεια στο API. Δεν είναι δυνατή η συνδυασμός διαπιστευτηρίων καθολικής σύνδεσης και αποθήκευσης στο ίδιο API. Επιπλέον, ενώ μπορείτε να χρησιμοποιήσετε κύρια ονόματα χρηστών (UPN) ή κύρια ονόματα υπηρεσίας (SPN) για να συνδεθείτε στο API σας, οι οντότητες υπηρεσίας υποστηρίζουν μόνο καθολική σύνδεση (SSO) προς το παρόν. Οι οντότητες χρηστών μπορούν να αξιοποιήσουν είτε το SSO είτε τα αποθηκευμένα διαπιστευτήρια, ανάλογα με τις απαιτήσεις ασφαλείας σας.
Σημείωμα
Το API για GraphQL απαιτεί από τις εφαρμογές-πελάτες να χρησιμοποιούν το Microsoft Entra για τον έλεγχο ταυτότητας. Η εφαρμογή-πελάτης σας πρέπει να καταχωρηθεί και ρυθμιστεί επαρκώς για την εκτέλεση κλήσεων API εναντίον του Fabric. Η εφαρμογή που έχει καταχωρηθεί στο Microsoft Entra απαιτεί δικαιώματα Item.Execute.All API για την υπηρεσία Power BI. Μπορείτε να βρείτε μια ολοκληρωμένη εκμάθηση με οδηγίες και δείγμα κώδικα για τις κύριες αρχές χρήστη και τις αρχές υπηρεσίας στη Σύνδεση εφαρμογών.
Εμφανίζεται το κέντρο δεδομένων OneLake. επιλέξτε την προέλευση δεδομένων στην οποία θέλετε να συνδεθείτε. Για το παρακάτω παράδειγμα, επιλέγουμε ένα τελικό σημείο ανάλυσης SQL AdventureWorks που συνδέεται με μια κατοπτρικό βάση δεδομένων. Επιλέξτε Φίλτρο για να δείτε μόνο συγκεκριμένους τύπους προελεύσεων δεδομένων Fabric ή κάντε αναζήτηση με μια συγκεκριμένη λέξη-κλειδί. Όταν είστε έτοιμοι, επιλέξτε Σύνδεση.
Εμφανίζεται η οθόνη Λήψη δεδομένων , όπου μπορείτε να επιλέξετε τα αντικείμενα που θέλετε να εμφανίζονται στο σχήμα GraphQL.
Επιλέξτε τα πλαίσια ελέγχου δίπλα στους μεμονωμένους πίνακες ή τις αποθηκευμένες διαδικασίες που θέλετε να εκθέσετε στο API. Για να επιλέξετε όλα τα αντικείμενα σε έναν φάκελο, επιλέξτε το πλαίσιο ελέγχου με το όνομα της προέλευσης δεδομένων στο επάνω μέρος.
Επιλέξτε Φόρτωση για να ξεκινήσετε τη διαδικασία δημιουργίας σχήματος GraphQL.
Το σχήμα δημιουργείται και μπορείτε να ξεκινήσετε την δημιουργία ερωτημάτων GraphQL (ανάγνωση, λίστα) ή μεταλλάξεων (δημιουργία, ενημέρωση, διαγραφή) για να αλληλεπιδράσετε με τα δεδομένα σας.
Το API σας για GraphQL είναι τώρα έτοιμο για αποδοχή συνδέσεων και αιτήσεων. Μπορείτε να χρησιμοποιήσετε το πρόγραμμα επεξεργασίας API για να δοκιμάσετε και πρωτότυπα ερωτήματα GraphQL και την Εξερεύνηση σχημάτων για να επαληθεύσετε τους τύπους δεδομένων και τα πεδία που εμφανίζονται στο API.
Σύνοψη δικαιωμάτων
Ο παρακάτω πίνακας συνοψίζει τις διαφορετικές υποστηριζόμενες διατάξεις και τα ελάχιστα απαιτούμενα δικαιώματα για προγράμματα-πελάτες που αποκτούν πρόσβαση στο API GraphQL:
| Κλήση API | Συνδεσιμότητα προέλευσης δεδομένων | Απαιτούμενα δικαιώματα API GraphQL | Απαιτούμενα δικαιώματα προέλευσης δεδομένων | Εμβέλεια εφαρμογής Entra |
|---|---|---|---|---|
| Κύρια χρήστη (UPN) | Καθολική σύνδεση (SSO) | Εκτέλεση ερωτημάτων και μεταλλάξεων σε επίπεδο API | Κατάλληλα δικαιώματα ανάγνωσης/εγγραφής που εκχωρούνται στο UPN στην προέλευση δεδομένων | Item.Execute.All |
| Κύρια υπηρεσία (SPN) | Καθολική σύνδεση (SSO) | Εκτέλεση ερωτημάτων και μεταλλάξεων σε επίπεδο API | Κατάλληλα δικαιώματα ανάγνωσης/εγγραφής που εκχωρούνται στο SPN στην προέλευση δεδομένων | Item.Execute.All |
| Κύρια χρήστη (UPN) | Αποθηκευμένα διαπιστευτήρια | Εκτέλεση ερωτημάτων και μεταλλάξεων σε επίπεδο API | Κατάλληλα δικαιώματα ανάγνωσης/εγγραφής που εκχωρούνται στα αποθηκευμένα διαπιστευτήρια (σύνδεση) στην προέλευση δεδομένων | Item.Execute.All |
| Κύρια υπηρεσία (SPN) | Αποθηκευμένα διαπιστευτήρια | Προς το παρόν δεν υποστηρίζεται | Προς το παρόν δεν υποστηρίζεται | Προς το παρόν δεν υποστηρίζεται |