Έλεγχος πηγής και διοχετεύσεις ανάπτυξης στο API για GraphQL

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

Ποιος χρησιμοποιεί τον έλεγχο και την ανάπτυξη προέλευσης

Οι αγωγοί ενοποίησης και ανάπτυξης Git είναι απαραίτητοι για:

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

Χρησιμοποιήστε διοχετεύσεις ελέγχου προέλευσης και ανάπτυξης όταν χρειάζεται να διαχειριστείτε τα API GraphQL ως μέρος ενός δομημένου κύκλου ζωής ανάπτυξης με πολλαπλά περιβάλλοντα.

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

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

Επισκόπηση

Το Fabric προσφέρει ισχυρά εργαλεία για CI/CD (συνεχή ενοποίηση και συνεχή ανάπτυξη) και διαχείριση του κύκλου ζωής ανάπτυξης μέσω δύο κύριων στοιχείων: ενοποίηση Git (CI) και διοχετεύσεις ανάπτυξης (CD). Οι χώροι εργασίας χρησιμεύουν ως κεντρικά στοιχεία τόσο για τα στάδια συγχρονισμού Git όσο και για τα στάδια ανάπτυξης.

Ενοποίηση Git (CI): Συγχρονίζει στοιχεία χώρου εργασίας (για παράδειγμα, κώδικας, διαμορφώσεις, API) με αποθετήρια ελέγχου έκδοσης, ενεργοποιώντας τον έλεγχο έκδοσης και την παρακολούθηση αλλαγών μέσω Git.

Διοχετεύσεις ανάπτυξης (CD): Επιτρέπει τη δημιουργία σταδίων (για παράδειγμα, Ανάπτυξη, Δοκιμή, Παραγωγή) με συνδεδεμένους χώρους εργασίας. Τα στοιχεία που υποστηρίζονται σε κάθε στάδιο αναπαράγονται αυτόματα στα επόμενα στάδια και οι αλλαγές σε μια ανάπτυξη εναύσματος χώρου εργασίας σε μια διοχέτευση έκδοσης. Μπορείτε να ρυθμίσετε τις παραμέτρους της διοχέτευσης για να διασφαλίσετε ότι οι αλλαγές ελέγχονται και αναπτύσσονται αποτελεσματικά σε όλα τα περιβάλλοντα.

Το Fabric υποστηρίζει διάφορες ροές εργασιών CI/CD προσαρμοσμένες σε συνήθη σενάρια. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Επιλογές ροής εργασίας CI/CD στο Fabric.

Σημείωση

Μόνο τα μεταδεδομένα αντιγράφονται κατά την ανάπτυξη. και τα δεδομένα δεν αντιγράφονται.

Τα στοιχεία από τον χώρο εργασίας αποθηκεύονται στο σχετικό αποθετήριο δεδομένων Git ως Infrastructure as Code (IaC). Οι αλλαγές κώδικα στο αποθετήριο μπορούν να ενεργοποιήσουν την ανάπτυξη σε διοχετεύσεις. Αυτή η μέθοδος σάς επιτρέπει να κάνετε αυτόματη αναπαραγωγή των αλλαγών κώδικα σε όλα τα στάδια για σκοπούς δοκιμής και έκδοσης παραγωγής.

Μέθοδοι ελέγχου ταυτότητας προέλευσης δεδομένων

Όταν δημιουργείτε το API σας για το GraphQL, επιλέγετε τον τρόπο με τον οποίο οι πελάτες ελέγχουν την ταυτότητα και έχουν πρόσβαση στις πηγές δεδομένων σας. Αυτή η επιλογή έχει σημαντικές επιπτώσεις για τους αγωγούς ανάπτυξης και τη συμπεριφορά αυτόματης δέσμευσης. Η κατανόηση αυτών των μεθόδων ελέγχου ταυτότητας είναι απαραίτητη για τον προγραμματισμό της ροής εργασιών CI/CD. Για περισσότερες πληροφορίες σχετικά με την αυτόματη σύνδεση και τη διαδικασία ανάπτυξης, ανατρέξτε στο θέμα Κατανόηση της διαδικασίας ανάπτυξης.

Υπάρχουν δύο διαθέσιμες επιλογές συνδεσιμότητας κατά τη σύνδεση πηγών δεδομένων στο API σας για το GraphQL: Καθολική σύνδεση (SSO) και Αποθηκευμένα διαπιστευτήρια.

Καθολική σύνδεση (SSO)

Με το SSO, οι πελάτες API χρησιμοποιούν τα δικά τους διαπιστευτήρια για πρόσβαση σε πηγές δεδομένων. Ο χρήστης API που έχει υποβληθεί σε έλεγχο ταυτότητας πρέπει να έχει δικαιώματα τόσο για το API όσο και για την υποκείμενη προέλευση δεδομένων.

Χρησιμοποιήστε το SSO όταν:

Έκθεση προελεύσεων δεδομένων Fabric (lakehouses, αποθήκες, τελικά σημεία ανάλυσης SQL)
Θέλετε οι χρήστες να έχουν πρόσβαση σε δεδομένα με βάση τα ατομικά τους δικαιώματα
Πρέπει να εφαρμόζετε ασφάλεια σε επίπεδο γραμμών ή άλλες πολιτικές πρόσβασης δεδομένων ανά χρήστη

Απαιτήσεις άδειας:

Οι χρήστες API χρειάζονται δικαιώματα εκτέλεσης στο GraphQL API (Εκτέλεση ερωτημάτων και μεταλλάξεων)
Οι χρήστες API χρειάζονται δικαιώματα ανάγνωσης ή εγγραφής στην πηγή δεδομένων
Εναλλακτικά, προσθέστε χρήστες ως μέλη χώρου εργασίας με ρόλο συμβαλλόντων όπου βρίσκονται τόσο το API όσο και η προέλευση δεδομένων

Συμπεριφορά αυτόματης δέσμευσης σε διοχετεύσεις ανάπτυξης: Όταν αναπτύσσετε ένα API χρησιμοποιώντας SSO από τον χώρο εργασίας προέλευσης (για παράδειγμα, Dev) στον χώρο εργασίας προορισμού (για παράδειγμα, Δοκιμή):

Η πηγή δεδομένων και το GraphQL API αναπτύσσονται και τα δύο στον χώρο εργασίας προορισμού
Το API στον χώρο εργασίας προορισμού συνδέεται αυτόματα με το αντίγραφο της τοπικής προέλευσης δεδομένων στον χώρο εργασίας προορισμού
Κάθε περιβάλλον (Dev, Test, Production) χρησιμοποιεί τη δική του παρουσία πηγής δεδομένων

Σημείωση

Υπάρχουν συγκεκριμένοι περιορισμοί κατά τη χρήση SSO με τελικά σημεία ανάλυσης SQL. Ανατρέξτε στην ενότητα Τρέχοντες περιορισμοί για λεπτομέρειες.

Αποθηκευμένα διαπιστευτήρια

Με τα αποθηκευμένα διαπιστευτήρια, ένα μόνο κοινόχρηστο διαπιστευτήριο πραγματοποιεί έλεγχο ταυτότητας μεταξύ του API και των προελεύσεων δεδομένων. Οι χρήστες API χρειάζονται πρόσβαση μόνο στο ίδιο το API και όχι στις υποκείμενες προελεύσεις δεδομένων.

Χρησιμοποιήστε αποθηκευμένα διαπιστευτήρια όταν:

Έκθεση προελεύσεων δεδομένων Azure (Βάση δεδομένων SQL Azure, εξωτερικές βάσεις δεδομένων)
Θέλετε απλοποιημένη διαχείριση αδειών (οι χρήστες χρειάζονται μόνο πρόσβαση API)
Όλοι οι χρήστες API θα πρέπει να έχουν πρόσβαση στα ίδια δεδομένα με τα ίδια δικαιώματα
Χρειάζεστε συνεπή διαπιστευτήρια σε όλα τα αιτήματα API

Απαιτήσεις άδειας:

Οι χρήστες API χρειάζονται μόνο δικαιώματα εκτέλεσης στο GraphQL API (Εκτέλεση ερωτημάτων και μεταλλάξεων)
Τα ίδια τα αποθηκευμένα διαπιστευτήρια πρέπει να έχουν τα κατάλληλα δικαιώματα στην προέλευση δεδομένων
Οι προγραμματιστές που αναπτύσσουν το API πρέπει να έχουν πρόσβαση στα αποθηκευμένα διαπιστευτήρια

Συμπεριφορά αυτόματης δέσμευσης σε διοχετεύσεις ανάπτυξης: Όταν αναπτύσσετε ένα API χρησιμοποιώντας αποθηκευμένα διαπιστευτήρια από τον χώρο εργασίας προέλευσης (Dev) στον χώρο εργασίας προορισμού (Δοκιμή):

Η προέλευση δεδομένων αναπτύσσεται στον χώρο εργασίας προορισμού
Το API στον χώρο εργασίας προορισμού παραμένει συνδεδεμένο με την προέλευση δεδομένων στον χώρο εργασίας προέλευσης (Dev)
Δεν πραγματοποιείται αυτόματη σύνδεση - το αναπτυγμένο API συνεχίζει να χρησιμοποιεί τα αποθηκευμένα διαπιστευτήρια, δείχνοντας στην αρχική προέλευση δεδομένων
Πρέπει να ρυθμίσετε εκ νέου τις παραμέτρους των συνδέσεων με μη αυτόματο τρόπο ή να δημιουργήσετε νέα αποθηκευμένα διαπιστευτήρια σε κάθε περιβάλλον προορισμού

Important

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

Συνδέσεις μεταξύ χώρων εργασίας

Εάν το API σας στον χώρο εργασίας προέλευσης (Dev) συνδέεται σε μια προέλευση δεδομένων σε διαφορετικό χώρο εργασίας, το αναπτυγμένο API στον χώρο εργασίας προορισμού (Δοκιμή) παραμένει συνδεδεμένο σε αυτήν την εξωτερική προέλευση δεδομένων ανεξάρτητα από τη μέθοδο ελέγχου ταυτότητας. Η αυτόματη σύνδεση λειτουργεί μόνο όταν τόσο το API όσο και η προέλευση δεδομένων βρίσκονται στον ίδιο χώρο εργασίας προέλευσης.

Το παρακάτω διάγραμμα απεικονίζει αυτά τα σενάρια ανάπτυξης:

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

API για ενοποίηση GraphQL Git

Το Fabric API για GraphQL υποστηρίζει την ενσωμάτωση Git, επιτρέποντάς σας να διαχειρίζεστε τα GraphQL API σας ως κώδικα στο σύστημα ελέγχου έκδοσης. Αυτή η ενοποίηση παρέχει ιστορικό εκδόσεων, συνεργασία μέσω διακλαδώσεων και αιτημάτων έλξης, δυνατότητα επαναφοράς αλλαγών και πλήρη διαδρομή ελέγχου των τροποποιήσεων API. Αντιμετωπίζοντας τη διαμόρφωση του GraphQL API ως Infrastructure as Code (IaC), μπορείτε να εφαρμόσετε βέλτιστες πρακτικές ανάπτυξης λογισμικού στο επίπεδο πρόσβασης δεδομένων σας.

Η ενσωμάτωση του Git είναι απαραίτητη για:

Έλεγχος έκδοσης: Παρακολουθήστε όλες τις αλλαγές στο σχήμα GraphQL, τις συνδέσεις πηγών δεδομένων και τις σχέσεις σας με την πάροδο του χρόνου
Συνεργασία: Συνεργαστείτε με μέλη της ομάδας χρησιμοποιώντας κλάδους, αιτήματα έλξης και αναθεωρήσεις κώδικα
Δυνατότητα επαναφοράς: Επιστρέψτε στις προηγούμενες διαμορφώσεις API όταν προκύψουν προβλήματα
Προώθηση περιβάλλοντος: Χρησιμοποιήστε το Git ως πηγή αλήθειας για την ανάπτυξη API σε περιβάλλοντα

Συνδέστε τον χώρο εργασίας σας στο Git

Για να ενεργοποιήσετε την ενσωμάτωση Git για τα API GraphQL:

Ανοίξτε τις ρυθμίσεις χώρου εργασίας για τον χώρο εργασίας που περιέχει το API σας για το GraphQL
Ρυθμίστε τις παραμέτρους της σύνδεσης Git στο αποθετήριο δεδομένων σας (Azure DevOps, GitHub ή άλλη υπηρεσία παροχής Git)
Μόλις συνδεθούν, όλα τα στοιχεία χώρου εργασίας, συμπεριλαμβανομένων των API για το GraphQL, εμφανίζονται στον πίνακα ελέγχου Source

Για λεπτομερείς οδηγίες ρύθμισης, ανατρέξτε στο θέμα Γρήγορα αποτελέσματα με την ενοποίηση του Git.

Δεσμεύστε και συγχρονίστε τα GraphQL API σας

Αφού συνδεθείτε στο Git, μπορείτε να δεσμεύσετε το API σας για διαμορφώσεις GraphQL στο αποθετήριο. Κάθε υποβολή δημιουργεί ένα στιγμιότυπο του ορισμού του API σας, συμπεριλαμβανομένων:

Ορισμοί σχήματος GraphQL
Συνδέσεις προέλευσης δεδομένων και ρυθμίσεις ελέγχου ταυτότητας
Διαμορφώσεις σχέσεων
Ορισμοί ερωτημάτων και μεταλλάξεων

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

Αναπαράσταση GraphQL API στο Git

Κάθε στοιχείο API για GraphQL αποθηκεύεται στο Git με μια καλά καθορισμένη δομή φακέλου που αντιπροσωπεύει όλες τις πτυχές της διαμόρφωσης του API σας:

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

Εργασία με αρχεία ορισμού API:

Η μορφή ορισμού GraphQL API ακολουθεί τα πρότυπα Infrastructure as Code (IaC) του Fabric. Μπορούμε να προβάλουμε και να επεξεργαστούμε αυτά τα αρχεία απευθείας στο αποθετήριο Git, αν και οι περισσότερες τροποποιήσεις θα πρέπει να γίνουν μέσω της πύλης Fabric για να διασφαλιστεί η εγκυρότητα του σχήματος. Τα αρχεία ορισμών είναι ιδιαίτερα χρήσιμα για:

Αναθεωρήσεις κώδικα: Τα μέλη της ομάδας μπορούν να ελέγξουν τις αλλαγές API στα αιτήματα έλξης
Τεκμηρίωση: Τα αρχεία χρησιμεύουν ως τεκμηρίωση της δομής του API σας
Αυτοματισμός: Οι αγωγοί CI/CD μπορούν να διαβάσουν αυτά τα αρχεία για να κατανοήσουν τις διαμορφώσεις API
Αποκατάσταση καταστροφών: Οι πλήρεις ορισμοί API διατηρούνται στον έλεγχο έκδοσης

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

API για GraphQL σε διοχέτευση ανάπτυξης

Οι διοχετεύσεις ανάπτυξης σάς δίνουν τη δυνατότητα να προωθήσετε το API σας για διαμορφώσεις GraphQL σε περιβάλλοντα (συνήθως Ανάπτυξη, Δοκιμή και Παραγωγή). Όταν αναπτύσσετε ένα API για το GraphQL μέσω μιας διοχέτευσης, αντιγράφονται μόνο τα μεταδεδομένα API—συμπεριλαμβανομένων των ορισμών σχήματος, των συνδέσεων προέλευσης δεδομένων και των διαμορφώσεων σχέσεων. Τα πραγματικά δεδομένα παραμένουν στις συνδεδεμένες προελεύσεις δεδομένων και δεν αντιγράφονται κατά την ανάπτυξη.

Βασικά ζητήματα ανάπτυξης:

Πριν από την ανάπτυξη, κατανοήστε πώς οι μέθοδοι ελέγχου ταυτότητας και η οργάνωση του χώρου εργασίας επηρεάζουν την ανάπτυξή σας:

Τα API που χρησιμοποιούν Single Sign-On (SSO) μπορούν να συνδεθούν αυτόματα σε τοπικές προελεύσεις δεδομένων στον χώρο εργασίας προορισμού (όταν η προέλευση δεδομένων αναπτύχθηκε επίσης από τον ίδιο χώρο εργασίας προέλευσης)
Τα API που χρησιμοποιούν αποθηκευμένα διαπιστευτήρια δεν συνδέονται αυτόματα και παραμένουν συνδεδεμένα με την προέλευση δεδομένων του χώρου εργασίας προέλευσης
Οι προελεύσεις δεδομένων μεταξύ χώρων εργασίας δεν συνδέονται ποτέ αυτόματα, ανεξάρτητα από τη μέθοδο ελέγχου ταυτότητας

Για μια ολοκληρωμένη κατανόηση της διαδικασίας ανάπτυξης, ανατρέξτε στην ενότητα Κατανόηση της διαδικασίας ανάπτυξης.

Αναπτύξτε το API σας για GraphQL

Για να αναπτύξετε το API σας για GraphQL χρησιμοποιώντας αγωγούς ανάπτυξης:

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

Τρέχοντες περιορισμοί

Κατά την ανάπτυξη API για GraphQL μέσω διοχετεύσεων ανάπτυξης, η αυτόματη σύνδεση έχει τους ακόλουθους περιορισμούς:

Θυγατρικά στοιχεία: Η αυτόματη σύνδεση δεν λειτουργεί όταν το API συνδέεται σε ένα τελικό σημείο ανάλυσης SQL που είναι θυγατρικό μιας γονικής προέλευσης δεδομένων (όπως ένα Lakehouse). Το αναπτυγμένο API παραμένει συνδεδεμένο με το τελικό σημείο του χώρου εργασίας προέλευσης.
Αποθηκευμένα διαπιστευτήρια: Τα API που χρησιμοποιούν τη μέθοδο ελέγχου ταυτότητας Αποθηκευμένα διαπιστευτήρια δεν υποστηρίζουν αυτόματη δέσμευση. Το API παραμένει συνδεδεμένο με την προέλευση δεδομένων του χώρου εργασίας προέλευσης μετά την ανάπτυξη. Για λεπτομερείς πληροφορίες σχετικά με τις μεθόδους ελέγχου ταυτότητας και τη συμπεριφορά αυτόματης δέσμευσής τους, ανατρέξτε στο θέμα Μέθοδοι ελέγχου ταυτότητας προέλευσης δεδομένων.
Αλλαγές σχήματος GraphQL API και υποκείμενης προέλευσης δεδομένων: Τα API GraphQL στο Fabric δεν εντοπίζουν αυτόματα αλλαγές σχήματος στις υποκείμενες προελεύσεις δεδομένων τους. Εάν ένας πίνακας ή μια αναλυτική προβολή αλλάξει τη δομή του (για παράδειγμα, οι στήλες προστίθενται, μετονομάζονται ή καταργούνται), το API συνεχίζει να χρησιμοποιεί το σχήμα που καταγράφηκε κατά τη δημιουργία ή την τελευταία ανανέωση, επομένως τα νέα πεδία ή οι ενημερωμένοι τύποι δεν θα εμφανίζονται αυτόματα. Για να αντικατοπτρίζονται οι ενημερώσεις σχήματος, απαιτείται μη αυτόματη ανανέωση των μεταδεδομένων του API — για παράδειγμα, ανοίγοντας το στοιχείο API GraphQL και ενημερώνοντας το σχήμα του (προσθέτοντας ή αφαιρώντας στήλες) ή καταργώντας και προσθέτοντας ξανά τον πίνακα. Σε ορισμένες περιπτώσεις, μπορεί να χρειαστεί να διαγράψετε και να επανασυνδέσετε ολόκληρη την προέλευση δεδομένων για να καταγράψετε πλήρως όλες τις αλλαγές σχήματος.

Σχόλια

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

Τελευταία ενημέρωση στις 2026-03-01