Σημείωση
Η πρόσβαση σε αυτή τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να συνδεθείτε ή να αλλάξετε καταλόγους.
Η πρόσβαση σε αυτή τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να αλλάξετε καταλόγους.
Το GraphQL είναι μια γλώσσα ερωτημάτων ανοιχτού κώδικα και χρόνος εκτέλεσης για API που διατηρούνται από το GraphQL Foundation. Σε αντίθεση με τα παραδοσιακά REST API, το GraphQL επιτρέπει στους πελάτες να ζητούν ακριβώς τα δεδομένα που χρειάζονται σε ένα μόνο ερώτημα, μειώνοντας την υπερβολική ανάκτηση και την υποανάκτηση δεδομένων.
Το Microsoft Fabric API για GraphQL φέρνει αυτό το ισχυρό πρότυπο στο οικοσύστημα Fabric ως επίπεδο πρόσβασης δεδομένων που σας επιτρέπει να υποβάλετε ερωτήματα σε πολλές προελεύσεις δεδομένων γρήγορα και αποτελεσματικά. Το API αφαιρεί τις ιδιαιτερότητες των προελεύσεων δεδομένων παρασκηνίου, ώστε να εστιάζετε στη λογική της εφαρμογής σας και να παρέχετε όλα τα δεδομένα που χρειάζεται ένας πελάτης σε μία μόνο κλήση. Με την απλή γλώσσα ερωτημάτων και τον αποτελεσματικό χειρισμό του συνόλου αποτελεσμάτων, το GraphQL ελαχιστοποιεί τον χρόνο που χρειάζονται οι εφαρμογές για να αποκτήσουν πρόσβαση στα δεδομένα σας στο Fabric.
Γιατί να χρησιμοποιήσετε το GraphQL για δεδομένα Fabric
Χωρίς GraphQL, η έκθεση δεδομένων Fabric σε εφαρμογές απαιτεί συνήθως μία από αυτές τις προσεγγίσεις:
Άμεσες συνδέσεις βάσεων δεδομένων
- Οι εφαρμογές συνδέονται απευθείας σε lakehouses ή αποθήκες χρησιμοποιώντας προγράμματα οδήγησης SQL (ODBC, JDBC)
- Συνδέει στενά τον κώδικα εφαρμογής με τα σχήματα βάσης δεδομένων—οι αλλαγές σχήματος διακόπτουν τις εφαρμογές
- Απαιτεί τη διαχείριση συμβολοσειρών σύνδεσης, διαπιστευτηρίων και εξαρτήσεων προγραμμάτων οδήγησης σε κάθε εφαρμογή
- Τα ερωτήματα SQL που είναι ενσωματωμένα στον κώδικα εφαρμογής είναι δύσκολο να δοκιμαστούν και να διατηρηθούν
Προσαρμοσμένα REST API
- Δημιουργήστε και διατηρήστε προσαρμοσμένες υπηρεσίες υποστήριξης με πλαίσια όπως ASP.NET ή Node.js
- Γράψτε κώδικα ελεγκτή, λογική δρομολόγησης και επίπεδα πρόσβασης δεδομένων για κάθε τελικό σημείο
- Δημιουργήστε ξεχωριστές εκδόσεις API (v1, v2, v3) όταν αλλάζουν οι δομές δεδομένων
- Υπερβολική ανάκτηση δεδομένων (λήψη ολόκληρων σειρών όταν χρειάζεστε λίγες στήλες) ή υποανάκτηση (πραγματοποίηση πολλαπλών διαδρομών μετ' επιστροφής για σχετικά δεδομένα)
Το GraphQL επιλύει αυτές τις προκλήσεις:
- Δεν απαιτείται κώδικας υποστήριξης: Το Fabric δημιουργεί αυτόματα το σχήμα GraphQL, τους αναλυτές και το τελικό σημείο από τις προελεύσεις δεδομένων σας
- Ζητήστε ακριβώς αυτό που χρειάζεστε: Ζητήστε συγκεκριμένα πεδία σε ένα μόνο ερώτημα, εξαλείφοντας την υπερβολική ανάκτηση και μειώνοντας τα μεγέθη ωφέλιμου φορτίου
- Λήψη σχετικών δεδομένων σε μία αίτηση: Διέλευση σχέσεων χωρίς πολλαπλές διαδρομές μετ' επιστροφής (χωρίς πρόβλημα ερωτήματος N+1)
- Εξέλιξη σχήματος χωρίς αλλαγές: Προσθέστε νέα πεδία χωρίς να επηρεαστούν τα υπάρχοντα ερωτήματα—οι υπολογιστές-πελάτες ζητούν μόνο ό,τι γνωρίζουν
- Ασφάλεια τύπου και τεκμηρίωση: Σχήμα αυτοτεκμηρίωσης με ενσωματωμένη ενδοσκόπηση που κατανοούν τα εργαλεία ανάπτυξης
- Ενοποιημένη πρόσβαση σε πολλές προελεύσεις: Υποβολή ερωτημάτων σε lakehouses, αποθήκες και βάσεις δεδομένων SQL μέσω ενός μοναδικού τελικού σημείου
Για τους προγραμματιστές εφαρμογών, το GraphQL σημαίνει ταχύτερη ανάπτυξη με λιγότερη υποδομή. Για τους μηχανικούς δεδομένων, σημαίνει έκθεση δεδομένων χωρίς σύνταξη και διατήρηση προσαρμοσμένου κώδικα API.
Ποιος πρέπει να χρησιμοποιεί το API για το GraphQL
Το API του Fabric για GraphQL έχει σχεδιαστεί για:
- Προγραμματιστές εφαρμογών που δημιουργούν εφαρμογές web και κινητές συσκευές που βασίζονται σε δεδομένα και καταναλώνουν δεδομένα Fabric lakehouse και αποθήκης
- Μηχανικοί δεδομένων που εκθέτουν δεδομένα Fabric σε μεταγενέστερες εφαρμογές μέσω σύγχρονων, ευέλικτων API χωρίς να γράφουν προσαρμοσμένο κώδικα υποστήριξης
- Προγραμματιστές ενοποίησης που συνδέουν δεδομένα Fabric σε προσαρμοσμένες εφαρμογές και αυτοματοποιημένες ροές εργασιών
- Προγραμματιστές BI που δημιουργούν προσαρμοσμένες εφαρμογές ανάλυσης που συμπληρώνουν το Power BI με δεδομένα Fabric
- Επιστήμονες δεδομένων που εκθέτουν δεδομένα Fabric και πληροφορίες μηχανικής μάθησης μέσω API μέσω προγραμματισμού
Εάν εργάζεστε στην ενοποιημένη πλατφόρμα ανάλυσης Microsoft Fabric και πρέπει να κάνετε τα δεδομένα lakehouse, αποθήκης ή βάσης δεδομένων SQL προσβάσιμα σε εφαρμογές, το GraphQL API παρέχει έναν αποτελεσματικό, φιλικό προς τους προγραμματιστές τρόπο για να υποβάλετε ερωτήματα ακριβώς στα δεδομένα που χρειάζεστε.
Φιλοδώρημα
Θέλετε να ενσωματώσετε Fabric GraphQL API με πράκτορες AI; Δοκιμάστε το εκπαιδευτικό βοήθημα Δημιουργία τοπικού διακομιστή GraphQL MCP για πράκτορες AI για να συνδέσετε πράκτορες AI στα δεδομένα σας Fabric χρησιμοποιώντας το πρωτόκολλο περιβάλλοντος μοντέλου.
Έκθεση δεδομένων μέσω του API για GraphQL
Η έκθεση προελεύσεων δεδομένων σε ένα στοιχείο GraphQL στο Microsoft Fabric είναι απλή και μπορεί να επιτευχθεί μέσα σε λίγα λεπτά χρησιμοποιώντας το οπτικό περιβάλλον εργασίας της πύλης Fabric. Η διαδικασία περιλαμβάνει:
- Δημιουργία στοιχείου GraphQL API στον χώρο εργασίας σας Fabric
- Συνδέστε τις προελεύσεις δεδομένων σας επιλέγοντας από διαθέσιμες λίμνες, αποθήκες ή βάσεις δεδομένων
- Επιλογή των αντικειμένων που θα εκτεθούν , όπως πίνακες, προβολές ή αποθηκευμένες διαδικασίες
- Ορίστε σχέσεις (προαιρετικά) μεταξύ αντικειμένων για να ενεργοποιήσετε ισχυρά ένθετα ερωτήματα
- Ρυθμίστε τις παραμέτρους των δικαιωμάτων για να ελέγξετε ποιος μπορεί να έχει πρόσβαση στο API σας
Μόλις ρυθμιστεί, το Fabric δημιουργεί αυτόματα το σχήμα GraphQL, δημιουργεί τους απαραίτητους αναλυτές και σας παρέχει μια διεύθυνση URL τελικού σημείου. Το API σας είναι αμέσως έτοιμο να δεχτεί ερωτήματα—δεν απαιτείται ανάπτυξη ή ρύθμιση υποδομής.
Για οδηγίες βήμα προς βήμα, ανατρέξτε στο θέμα Δημιουργία API για το GraphQL στο Fabric και προσθήκη δεδομένων.
Υποστηριζόμενες προελεύσεις δεδομένων
Προς το παρόν, οι ακόλουθες υποστηριζόμενες προελεύσεις δεδομένων εκτίθενται μέσω του API Fabric για το GraphQL:
- Αποθήκη δεδομένων Microsoft Fabric
- Βάση δεδομένων SQL Microsoft Fabric
- Microsoft Fabric Lakehouse μέσω τελικού σημείου ανάλυσης SQL
- Βάσεις δεδομένων Microsoft Fabric Mirrored μέσω του τελικού σημείου της SQL Analytics, συμπεριλαμβανομένων των εξής:
- Βάση δεδομένων SQL Azure
- Διαχειριζόμενη παρουσία Azure SQL
- Azure Cosmos DB
- Βάση δεδομένων SQL Microsoft Fabric
- Azure Databricks
- Snowflake
- Άνοιγμα βάσεων δεδομένων κατοπτρισμού
- Βάση δεδομένων SQL Azure
- Datamart
Δυνατότητες
Το Microsoft Fabric API για GraphQL παρέχει ολοκληρωμένες δυνατότητες που βελτιστοποιούν την πρόσβαση στα δεδομένα για εφαρμογές. Από την αυτόματη δημιουργία κώδικα έως την παρακολούθηση απόδοσης, αυτές οι δυνατότητες σάς δίνουν τη δυνατότητα να δημιουργήσετε ισχυρά API δεδομένων με ελάχιστη διαμόρφωση.
Αυτόματη δημιουργία σχήματος
- Ανακάλυψη σχήματος: Ανακαλύπτει και αντιστοιχίζει αυτόματα σχήματα πηγής δεδομένων σε τύπους GraphQL
- Δημιουργία ερωτημάτων και μεταλλάξεων: Δημιουργεί ερωτήματα και μεταλλάξεις GraphQL με βάση τη δομή των δεδομένων σας
- Δημιουργία επιλυτών: Δημιουργεί αυτόματα τους αναλυτές που απαιτούνται για την ανάκτηση δεδομένων από τις πηγές σας
- Τοπικός κώδικας δοκιμής: Δημιουργεί δείγμα κώδικα για άμεση δοκιμή και ανάπτυξη
Ευελιξία προέλευσης δεδομένων
- Πολλές προελεύσεις δεδομένων: Σύνδεση και υποβολή ερωτημάτων σε πολλές προελεύσεις δεδομένων με υποστήριξη ερωτημάτων fan-out
- Αντικείμενα βάσης δεδομένων: Πλήρης υποστήριξη για πίνακες, προβολές και αποθηκευμένες διαδικασίες σε βάσεις δεδομένων SQL και αποθήκες
- Επιλεκτική έκθεση: Επιλέξτε συγκεκριμένα αντικείμενα και στήλες για έκθεση μέσω του API
- Μοντελοποίηση σχέσεων: Δημιουργία σχέσεων ένα-προς-ένα, ένα-προς-πολλά και πολλά-προς-πολλά μεταξύ οντοτήτων δεδομένων
Λειτουργίες και παρακολούθηση
- Παρακολούθηση απόδοσης: Ενσωματωμένος πίνακας ελέγχου και καταγραφή αιτημάτων για παρακολούθηση της συμπεριφοράς και της χρήσης του API
Εξέλιξη σχήματος χωρίς έκδοση εκδόσεων
Το GraphQL ακολουθεί μια μοναδική προσέγγιση στην εξέλιξη του API αποφεύγοντας την παραδοσιακή έκδοση. Αντί να δημιουργούν τελικά σημεία v1, v2 και v3, τα API GraphQL εξελίσσονται συνεχώς:
- Πρόσθετες αλλαγές: Μπορείτε να προσθέσετε νέους τύπους, πεδία και δυνατότητες χωρίς να σπάσετε τα υπάρχοντα ερωτήματα. Οι πελάτες ζητούν μόνο τα πεδία που χρειάζονται, επομένως τα νέα πεδία δεν τους επηρεάζουν.
- Συμβατότητα προς τα πίσω: Τα υπάρχοντα ερωτήματα συνεχίζουν να λειτουργούν ακόμη και όταν το σχήμα μεγαλώνει, επειδή το GraphQL επιστρέφει μόνο δεδομένα που ζητούνται ρητά.
- Κατάργηση λόγω κατάργησης: Τα πεδία μπορούν να επισημανθούν ως καταργημένα αντί να καταργηθούν αμέσως, δίνοντας στους πελάτες χρόνο να προσαρμοστούν.
- Ένα τελικό σημείο: Οι εφαρμογές συνδέονται πάντα στο ίδιο τελικό σημείο, ανεξάρτητα από τις αλλαγές σχήματος.
Αυτή η προσέγγιση απλοποιεί τη συντήρηση API και τις αναβαθμίσεις πελατών σε σύγκριση με τα παραδοσιακά API με έκδοση. Όταν τροποποιείτε το σχήμα API GraphQL στο Fabric, οι υπάρχουσες εφαρμογές συνεχίζουν να λειτουργούν εφόσον προσθέτετε νέες δυνατότητες αντί να καταργείτε ή να μετονομάζετε υπάρχοντα πεδία. Για περισσότερες πληροφορίες σχετικά με τη διαχείριση αλλαγών σχήματος, ανατρέξτε στο θέμα Fabric API για ενδοσκόπηση και εξαγωγή σχήματος GraphQL.
Εμπειρία αλληλεπιδραστικής επεξεργασίας
Το API για το GraphQL περιλαμβάνει ένα πρόγραμμα επεξεργασίας που σας επιτρέπει να αναπτύξετε και να δοκιμάσετε εύκολα τα ερωτήματα και τις μεταλλάξεις σας. Οι δυνατότητες του συντάκτη περιλαμβάνουν:
- Ένα παράθυρο αποτελεσμάτων για την απεικόνιση της εξόδου των ερωτημάτων και των μεταλλάξεων
- Υποστήριξη για παραμέτρους ερωτήματος και μετάλλαξης
- Intellisense που υποστηρίζει σύνταξη GraphQL και ονόματα αντικειμένων σχήματος
Για περισσότερες πληροφορίες σχετικά με τη χρήση του επεξεργαστή GraphQL, ανατρέξτε στο API για τον επεξεργαστή GraphQL.
Περιορισμούς
Ανατρέξτε στο API για περιορισμούς GraphQL για περισσότερες πληροφορίες.