Δημιουργήστε ένα API για GraphQL στο Fabric και προσθέστε δεδομένα

Ξεκινήστε με το API Fabric για GraphQL δημιουργώντας ένα API και, στη συνέχεια, συνδέοντας μια προέλευση δεδομένων για να εκθέσετε τα δεδομένα που επιλέξατε μέσω του API. Το Fabric δημιουργεί αυτόματα το σχήμα GraphQL με βάση τα δεδομένα σας και οι εφαρμογές είναι έτοιμες να συνδεθούν σε λίγα λεπτά.

Ποιος πρέπει να δημιουργήσει GraphQL API

Η δημιουργία API GraphQL στο Fabric έχει σχεδιαστεί για:

Μηχανικοί δεδομένων που εκθέτουν δεδομένα Fabric lakehouse και αποθήκης μέσω σύγχρονων API για κατανάλωση εφαρμογών
Οι συμβάλλοντες χώρου εργασίας Fabric που θέλουν να δημιουργήσουν γρήγορα API πρόσβασης δεδομένων χωρίς να γράψουν κώδικα παρασκηνίου
Προγραμματιστές BI που δημιουργούν προσαρμοσμένες εφαρμογές ανάλυσης που χρειάζονται πρόσβαση μέσω προγραμματισμού σε δεδομένα Fabric
Προγραμματιστές ενοποίησης που δημιουργούν επίπεδα πρόσβασης δεδομένων για προσαρμοσμένες εφαρμογές και αυτοματοποιημένες ροές εργασίας
Ομάδες ανάπτυξης που προτιμούν την ευέλικτη, ασφαλή προσέγγιση του GraphQL έναντι των άμεσων συνδέσεων βάσεων δεδομένων

Χρησιμοποιήστε αυτόν τον οδηγό όταν θέλετε να δημιουργήσετε ένα νέο API GraphQL που εκθέτει τα δεδομένα της λίμνης, της αποθήκης ή της βάσης δεδομένων Fabric σε εφαρμογές.

Προαπαιτούμενα στοιχεία

Για να δημιουργήσετε ένα API για το GraphQL, χρειάζεστε:

Τα δικαιώματά σας:

Γίνετε μέλος του χώρου εργασίας Fabric όπου θέλετε να δημιουργήσετε το API
Να έχετε τουλάχιστον τον ρόλο Συμβάλλοντα σε αυτόν τον χώρο εργασίας (ή υψηλότερο: Διαχειριστής, Μέλος)

Οργανωτική ρύθμιση:

Ένας διαχειριστής Fabric ή ένας διαχειριστής εκχωρημένων πόρων πρέπει να ενεργοποιήσει τη ρύθμιση μισθωτή "Οι χρήστες μπορούν να δημιουργήσουν στοιχεία Fabric"
Ο χώρος εργασίας πρέπει να υποστηρίζεται από εκχωρημένους πόρους Fabric (εκχωρημένοι πόροι Premium, δοκιμαστική έκδοση ή Fabric)

Πρόσβαση στην προέλευση δεδομένων (για επόμενα βήματα):

Διαβάστε τα δικαιώματα στις πηγές δεδομένων που σκοπεύετε να εκθέσετε μέσω του GraphQL API
Τα δικαιώματα μπορούν να εκχωρηθούν μέσω δικαιωμάτων ιδιότητας μέλους χώρου εργασίας ή άμεσης προέλευσης δεδομένων
Σε αυτόν τον οδηγό, χρησιμοποιούμε ένα τελικό σημείο ανάλυσης SQL της AdventureWorks που συνδέεται με μια βάση δεδομένων κατοπτρισμού ως παράδειγμα προέλευσης δεδομένων. Για να λάβετε το δείγμα δεδομένων AdventureWorks, ανατρέξτε στο θέμα Φόρτωση δείγματος δεδομένων AdventureWorks στη βάση δεδομένων SQL.

Δημιουργία API για GraphQL

Για να δημιουργήσετε ένα API για GraphQL:

Μεταβείτε στην πύλη Fabric στη διεύθυνση https://fabric.microsoft.com και εισέλθετε με τον εταιρικό λογαριασμό σας.
Επιλέξτε έναν χώρο εργασίας στον οποίο θέλετε να δημιουργήσετε το API και, στη συνέχεια, επιλέξτε Νέο στοιχείο. Στον πίνακα που ανοίγει, στην περιοχή Ανάπτυξη δεδομένων, επιλέξτε API για GraphQL.
Εισαγάγετε ένα όνομα για το νέο σας στοιχείο API για GraphQL και επιλέξτε Δημιουργία.

Τώρα έχετε ένα ενεργό τελικό σημείο API GraphQL στο Fabric. Σε αυτό το σημείο, μπορείτε να αντιγράψετε τη διεύθυνση URL τελικού σημείου από την πύλη Fabric, να επιλέξετε Δημιουργία κώδικα για να λάβετε δείγματα κώδικα και το API είναι έτοιμο να λάβει αιτήσεις. Στην επόμενη ενότητα, θα συνδέσουμε προελεύσεις δεδομένων για να δημιουργήσουμε το σχήμα σας, αλλά το ίδιο το τελικό σημείο είναι ήδη λειτουργικό.

Σύνδεση σε μια προέλευση δεδομένων και δημιουργία του σχήματός σας

Σε αυτό το σημείο, το τελικό σημείο API είναι έτοιμο, αλλά δεν εκθέτει ακόμη δεδομένα. Τα API για GraphQL ορίζονται σε ένα σχήμα οργανωμένο όσον αφορά τους τύπους και τα πεδία, σε ένα σύστημα ισχυρού τύπου. Το Fabric δημιουργεί αυτόματα το απαραίτητο σχήμα GraphQL με βάση τα δεδομένα που επιλέγετε για να εκθέσει σε προγράμματα-πελάτες GraphQL.

Για να συνδέσετε μια προέλευση δεδομένων και να δημιουργήσετε το σχήμα σας:

Βεβαιωθείτε ότι έχετε επιλέξει το νέο στοιχείο GraphQL API στον χώρο εργασίας σας.
Στην περιοχή Προσθήκη δεδομένων στο API για GraphQL , επιλέξτε το πλακίδιο Επιλογή προέλευσης δεδομένων .
Στη συνέχεια, επιλέξτε τη συνδεσιμότητα για το API σας:

Εδώ μπορείτε να καθορίσετε τον τρόπο με τον οποίο τα προγράμματα-πελάτες API μπορούν να έχουν πρόσβαση στο API για την εκτέλεση αιτήσεων GraphQL με βάση δύο ξεχωριστές επιλογές:
- Καθολική σύνδεση (SSO): Μπορείτε να χρησιμοποιήσετε διαπιστευτήρια προγράμματος-πελάτη για να συνδεθείτε σε προελεύσεις δεδομένων. Ο χρήστης API που έχει υποβληθεί σε έλεγχο ταυτότητας πρέπει να έχει πρόσβαση στους υποκείμενους πίνακες στην προέλευση δεδομένων.
  
  Για παράδειγμα, εάν εκθέτετε δεδομένα Lakehouse στα προγράμματα-πελάτες API σας, ο εξουσιοδοτημένος χρήστης πρέπει να έχει πρόσβαση τόσο στο API όσο και στο Lakehouse. Πιο συγκεκριμένα, το Execute δικαιώματα στο GraphQL API (επιλογή Εκτέλεση ερωτημάτων και μεταλλάξεων κατά την προσθήκη δικαιωμάτων άμεσης πρόσβασης) και δικαιώματα ανάγνωσης ή εγγραφής που απαιτούνται στην προέλευση δεδομένων επιλογής, αντίστοιχα. Εναλλακτικά, ο χρήστης μπορεί να προστεθεί ως μέλος χώρου εργασίας με ρόλο συμβάλλοντα όπου βρίσκονται τόσο το API όσο και τα στοιχεία προέλευσης δεδομένων, γεγονός που παρέχει την απαιτούμενη πρόσβαση και στα δύο στοιχεία από μία μόνο θέση. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Παροχή πρόσβασης στους χρήστες σε χώρους εργασίας.
- Αποθηκευμένα διαπιστευτήρια: Μπορείτε να χρησιμοποιήσετε αποθηκευμένα διαπιστευτήρια για να συνδεθείτε σε προελεύσεις δεδομένων. Ο χρήστης API που έχει υποβληθεί σε έλεγχο ταυτότητας δεν χρειάζεται άμεση πρόσβαση στα δεδομένα. Ένα αποθηκευμένο διαπιστευτήριο χρησιμοποιείται από κοινού για πρόσβαση στα δεδομένα μεταξύ του API και των υποκείμενων πινάκων στην προέλευση δεδομένων.
  
  Για παράδειγμα, εάν εκθέτετε δεδομένα Lakehouse στους πελάτες API σας, ο χρήστης που έχει υποβληθεί σε έλεγχο ταυτότητας πρέπει απλώς να έχει άμεση πρόσβαση στο API (επιλογή Εκτέλεση ερωτημάτων και μεταλλάξεων κατά την προσθήκη δικαιωμάτων άμεσης πρόσβασης) και όχι στο Lakehouse. Ένα αποθηκευμένο διαπιστευτήριο χρησιμοποιείται για τη σύνδεση του API στην προέλευση δεδομένων και κοινοποιείται από όλους τους χρήστες API με έλεγχο ταυτότητας. Αυτή η επιλογή απαιτείται εάν εκθέτετε μια προέλευση δεδομένων Azure, όπως μια βάση δεδομένων AZure SQL μέσω GraphQL.
Αφού επιλεγούν, αυτές οι επιλογές επιβάλλονται για όλες τις προελεύσεις δεδομένων που προστίθενται αργότερα στο API. Δεν είναι δυνατή η συνδυασμός διαπιστευτηρίων καθολικής σύνδεσης και αποθήκευσης στο ίδιο API. Μπορείτε να χρησιμοποιήσετε κύρια ονόματα χρήστη (UPN) ή κύρια ονόματα υπηρεσίας (SPN) για να συνδεθείτε στο API σας, χρησιμοποιώντας είτε SSO είτε αποθηκευμένα διαπιστευτήρια, ανάλογα με τις απαιτήσεις ασφαλείας σας.

Για μια λεπτομερή ανάλυση των απαιτήσεων δικαιωμάτων για διαφορετικά σενάρια ελέγχου ταυτότητας, ανατρέξτε στην ενότητα Σύνοψη ελέγχου ταυτότητας και δικαιωμάτων.

Σημείωμα

Το API για GraphQL απαιτεί από τις εφαρμογές-πελάτες να χρησιμοποιούν το Αναγνωριστικό Microsoft Entra για τον έλεγχο ταυτότητας. Η εφαρμογή-πελάτης σας πρέπει να καταχωρηθεί και ρυθμιστεί επαρκώς για την εκτέλεση κλήσεων API εναντίον του Fabric. Η εφαρμογή που έχει καταχωρηθεί στο Microsoft Entra ID απαιτεί δικαιώματα GraphQLApi.Execute.All API για την υπηρεσία Power BI. Μπορείτε να βρείτε μια ολοκληρωμένη εκμάθηση με οδηγίες και δείγμα κώδικα για τις κύριες αρχές χρήστη και τις αρχές υπηρεσίας στη Σύνδεση εφαρμογών.
Από τον κατάλογο OneLake, επιλέξτε την προέλευση δεδομένων στην οποία θέλετε να συνδεθείτε. Επιλέξτε Φίλτρο για να δείτε μόνο συγκεκριμένους τύπους προελεύσεων δεδομένων Fabric ή κάντε αναζήτηση με μια συγκεκριμένη λέξη-κλειδί. Όταν είστε έτοιμοι, επιλέξτε Σύνδεση.

Σε αυτό το παράδειγμα, επιλέξαμε ένα τελικό σημείο ανάλυσης SQL συνδεδεμένο με μια βάση δεδομένων κατοπτρισμού που περιέχει το δείγμα δεδομένων της AdventureWorks.
Εάν επιλέξατε Αποθηκευμένα διαπιστευτήρια προηγουμένως και εάν δεν υπάρχει ήδη αποθηκευμένο διαπιστευτήριο για το GraphQL API σας, θα σας ζητηθεί να δημιουργήσετε ένα νέο αποθηκευμένο διαπιστευτήριο.
Εμφανίζεται η σελίδα Επιλογή δεδομένων , όπου μπορείτε να επιλέξετε ποια αντικείμενα θέλετε να εκτίθενται στο σχήμα GraphQL.
Επιλέξτε τα πλαίσια ελέγχου δίπλα στους μεμονωμένους πίνακες, προβολές ή αποθηκευμένες διαδικασίες που θέλετε να εκθέσετε στο API. Για να επιλέξετε όλα τα αντικείμενα σε έναν φάκελο, επιλέξτε το πλαίσιο ελέγχου με το όνομα της προέλευσης δεδομένων στο επάνω μέρος.
Επιλέξτε Φόρτωση για να ξεκινήσετε τη διαδικασία δημιουργίας σχήματος GraphQL.
Το σχήμα δημιουργείται και μπορείτε να ξεκινήσετε την δημιουργία ερωτημάτων GraphQL (ανάγνωση, λίστα) ή μεταλλάξεων (δημιουργία, ενημέρωση, διαγραφή) για να αλληλεπιδράσετε με τα δεδομένα σας.

Φιλοδώρημα

Εισαγάγετε Ctrl/Cmd + πλήκτρο διαστήματος για να λαμβάνετε προτάσεις ενώ γράφετε τα ερωτήματά σας στο πρόγραμμα επεξεργασίας.

Για περισσότερες πληροφορίες σχετικά με τη χρήση του προγράμματος επεξεργασίας API, ανατρέξτε στο θέμα Fabric API για πρόγραμμα επεξεργασίας GraphQL.

Σύνοψη

Αυτό ήταν! Δημιουργήσατε με επιτυχία ένα API GraphQL στο Fabric, συνδέσατε την προέλευση δεδομένων σας και δημιουργήσατε ένα σχήμα. Το API σας είναι πλέον έτοιμο να δέχεται συνδέσεις και αιτήματα από εφαρμογές πελατών. Μπορείτε να χρησιμοποιήσετε το πρόγραμμα επεξεργασίας API για να δοκιμάσετε και να δημιουργήσετε πρωτότυπα ερωτήματα GraphQL και να χρησιμοποιήσετε την εξερεύνηση σχήματος για να επαληθεύσετε τους τύπους δεδομένων και τα πεδία που εκτίθενται στο API.

Ανάδραση

Ήταν χρήσιμη αυτή η σελίδα;

Last updated on 2026-01-20