Ενοποίηση στοιχείου ελέγχου προέλευσης βάσης δεδομένων SQL στο Microsoft Fabric

Ισχύει για:βάση δεδομένων SQL σε Microsoft Fabric

Σε αυτό το εκπαιδευτικό βοήθημα, θα μάθετε πώς μπορείτε να εργαστείτε με τη βάση δεδομένων SQL στο Fabric χρησιμοποιώντας το στοιχείο ελέγχου προέλευσης ενοποίησης git Fabric.

Μια βάση δεδομένων SQL στο Microsoft Fabric διαθέτει ενοποίηση ελέγχου προέλευσης ή "ενοποίηση git", έτσι ώστε οι χρήστες να μπορούν να παρακολουθούν τους ορισμούς των αντικειμένων της βάσης δεδομένων τους με την πάροδο του χρόνου. Αυτή η ενοποίηση επιτρέπει σε μια ομάδα να:

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

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

Εάν δεν είστε εξοικειωμένοι με το Git, ακολουθούν ορισμένοι προτεινόμενοι πόροι:

Αυτό το άρθρο παρουσιάζει μια σειρά χρήσιμων σεναρίων που μπορείτε να χρησιμοποιήσετε μεμονωμένα ή σε συνδυασμό για να διαχειριστείτε τη διαδικασία ανάπτυξης με τη βάση δεδομένων SQL στο Fabric:

Τα σενάρια σε αυτό το άρθρο καλύπτονται σε ένα επεισόδιο της έκθεσης δεδομένων. Παρακολουθήστε το βίντεο για μια επισκόπηση της ενοποίησης του στοιχείου ελέγχου προέλευσης στο Fabric:

Σημείωμα

Οι ρυθμίσεις σε επίπεδο βάσης δεδομένων, όπως η συρραφή και το επίπεδο συμβατότητας, δεν περιλαμβάνονται προς το παρόν στην ενοποίηση του ελέγχου προέλευσης και των διοχετεύσεων ανάπτυξης. Για ρυθμίσεις βάσης δεδομένων που μπορείτε να ορίσετε χρησιμοποιώντας T-SQL μετά τη δημιουργία της βάσης δεδομένων, μπορείτε να τροποποιήσετε τη βάση δεδομένων με δέσμες ενεργειών μετά την ανάπτυξη.

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

Ρύθμιση

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

Για τα βήματα για να συνδέσετε τον χώρο εργασίας σας σε ένα αποθετήριο δεδομένων ελέγχου προέλευσης, ανατρέξτε στο θέμα Γρήγορα αποτελέσματα με την ενοποίηση του Git. Ο χώρος εργασίας σας μπορεί να συνδεθεί σε ένα απομακρυσμένο αποθετήριο Azure DevOps ή GitHub.

Προσθήκη της βάσης δεδομένων SQL Fabric στο στοιχείο ελέγχου προέλευσης

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

  1. Συνδεθείτε στη βάση δεδομένων SQL στο πρόγραμμα επεξεργασίας Fabric SQL, SQL Server Management Studio, η επέκταση MSSQL για Visual Studio Code ή άλλα εξωτερικά εργαλεία.
  2. Δημιουργήστε έναν νέο πίνακα, αποθηκευμένη διαδικασία ή άλλο αντικείμενο στη βάση δεδομένων.
  3. Επιλέξτε το κουμπί ελέγχου Προέλευση για να ανοίξετε τον πίνακα ελέγχου προέλευσης.
  4. Επιλέξτε το πλαίσιο ελέγχου δίπλα στην επιθυμητή βάση δεδομένων. Επιλέξτε Δέσμευση. Η υπηρεσία Fabric διαβάζει ορισμούς αντικειμένων από τη βάση δεδομένων και τους εγγράφει στο απομακρυσμένο αποθετήριο δεδομένων.
  5. Τώρα, μπορείτε να προβάλετε το ιστορικό των αντικειμένων βάσης δεδομένων στην προβολή προέλευσης αποθετηρίου κώδικα.

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

Αρχείο έργου SQL

Το αρχείο έργου SQL στο αποθετήριο ελέγχου προέλευσης περιέχει μετα-δεδομένα σχετικά με τη βάση δεδομένων. Η ενοποίηση ελέγχου προέλευσης Fabric χρησιμοποιεί αυτό το αρχείο για να προσφέρει περισσότερη λειτουργικότητα στις διοχετεύσεις ελέγχου προέλευσης και ανάπτυξης. Η ενοποίηση ελέγχου προέλευσης δομής δημιουργεί και ενημερώνει αυτόματα το αρχείο έργου. Αποφύγετε τις μη αυτόματες επεξεργασίες στο αρχείο έργου, επειδή οι αλλαγές σας στο αρχείο έργου αντικαθίστανται από την ενοποίηση του στοιχείου ελέγχου προέλευσης Fabric στην επόμενη υποβολή από το Fabric. Ωστόσο, εάν θέλετε να δημιουργήσετε ένα έργο SQL τοπικά χρησιμοποιώντας εργαλεία SQL όπως το SQL Server Management Studio ή την επέκταση έργων SQL για τον master.dacpac κώδικα του Visual Studio, μπορείτε να προσθέσετε μια αναφορά στο αρχείο στο αρχείο του έργου σας.

Η ενοποίηση Fabric με έργα SQL προσθέτει αυτές τις ιδιότητες μετα-δεδομένων στο αρχείο έργου:

Η δυνατότητα αναφορών αντικειμένων συστήματος ρυθμίζεται αυτόματα χωρίς να απαιτείται καμία ενέργεια. Το πρόγραμμα επεξεργασίας ερωτημάτων Fabric παρέχει δέσμες ενεργειών πριν και μετά την ανάπτυξη στον φάκελο Κοινόχρηστα ερωτήματα .

Ενημέρωση της βάσης δεδομένων SQL Fabric από το στοιχείο ελέγχου προέλευσης

Σε αυτό το σενάριο, δημιουργείτε αντικείμενα βάσης δεδομένων ως κώδικα στην επέκταση έργων SQL στον κώδικα του Visual Studio και, στη συνέχεια, δεσμεύετε τα αρχεία στο στοιχείο ελέγχου προέλευσης πριν από την ενημέρωση της βάσης δεδομένων SQL Fabric από την ενοποίηση του στοιχείου ελέγχου προέλευσης. Αυτό το σενάριο απευθύνεται σε προγραμματιστές που προτιμούν να εργάζονται σε κώδικα του Visual Studio, έχουν υπάρχουσες εφαρμογές που χρησιμοποιούν έργα SQL ή έχουν πιο προηγμένες απαιτήσεις διοχέτευσης CI/CD.

  1. Βεβαιωθείτε ότι έχετε εγκαταστήσει την πιο πρόσφατη έκδοση του Visual Studio Code και τις επεκτάσεις έργων MSSQL και SQL για το Visual Studio Code.
  2. Δημιουργήστε μια νέα βάση δεδομένων SQL στον χώρο εργασίας σας και δεσμεύστε την στο στοιχείο ελέγχου προέλευσης χωρίς να προσθέσετε αντικείμενα. Αυτό το βήμα προσθέτει τα κενά μετα-δεδομένα στοιχείου έργου SQL και βάσης δεδομένων SQL στο αποθετήριο δεδομένων.
  3. Κλωνοποιήστε το αποθετήριο ελέγχου προέλευσης στον τοπικό υπολογιστή σας.
    • Εάν χρησιμοποιείτε Azure DevOps, επιλέξτε το μενού περιβάλλοντος ... για το έργο ελέγχου προέλευσης. Επιλέξτε Clone για να αντιγράψετε το αποθετήριο Azure DevOps στον τοπικό σας υπολογιστή. Εάν είστε νέοι στο Azure DevOps, ανατρέξτε στον οδηγό Code with git για Azure DevOps.
    • Εάν χρησιμοποιείτε GitHub, επιλέξτε το κουμπί Code στο αποθετήριο και αντιγράψτε τη διεύθυνση URL για να κλωνοποιήσετε το αποθετήριο στον τοπικό υπολογιστή σας. Εάν δεν είστε εξοικειωμένοι με GitHub, ανατρέξτε στον οδηγό κλωνοποίηση αποθετηρίου.
  4. Ανοίξτε τον κλωνοποιημένο φάκελο στο Visual Studio Code. Ο κλάδος που σχετίζεται με τον χώρο εργασίας σας ενδέχεται να μην είναι ο προεπιλεγμένος. Θα πρέπει να δείτε έναν φάκελο με το όνομα <yourdatabase>.SQLDatabase Visual Studio Code μετά την αλλαγή του κλάδου.
  5. Δημιουργήστε ένα .sql αρχείο για τουλάχιστον έναν πίνακα που θέλετε να δημιουργήσετε στη βάση δεδομένων εντός της δομής φακέλων για τη βάση δεδομένων σας. Το αρχείο θα πρέπει να περιέχει την πρόταση CREATE TABLE για τον πίνακα. Για παράδειγμα, δημιουργήστε ένα αρχείο με το όνομα MyTable.sql του φακέλου dbo/Tables με το ακόλουθο περιεχόμενο:
    CREATE TABLE dbo.MyTable
    (
        Id INT PRIMARY KEY,
        ExampleColumn NVARCHAR(50)
    );
    
  6. Για να βεβαιωθείτε ότι η σύνταξη είναι έγκυρη, επικυρώστε το μοντέλο βάσης δεδομένων με το έργο SQL. Αφού προσθέσετε τα αρχεία, χρησιμοποιήστε την προβολή Έργα βάσης δεδομένων στον κώδικα του Visual Studio για να δημιουργήσετε το έργο.
  7. Μετά από μια επιτυχημένη δόμηση, δεσμεύστε τα αρχεία στο στοιχείο ελέγχου προέλευσης χρησιμοποιώντας την προβολή στοιχείου ελέγχου προέλευσης στον κώδικα του Visual Studio ή την προτιμώμενη τοπική διασύνδεση git.
  8. Προωθήστε/συγχρονίστε την δέσμευση σας στο απομακρυσμένο αποθετήριο δεδομένων. Ελέγξτε ότι τα νέα αρχεία σας εμφανίζονται στο Azure DevOps ή στο GitHub.
  9. Επιστρέψτε στο περιβάλλον εργασίας web Fabric και ανοίξτε τον πίνακα ελέγχου Προέλευση στον χώρο εργασίας. Μπορεί να έχετε ήδη μια ειδοποίηση ότι "έχετε εκκρεμείς αλλαγές από το git". Επιλέξτε το κουμπί Ενημέρωση (Ενημέρωση όλων) για να εφαρμόσετε τον κώδικα από το έργο SQL στη βάση δεδομένων.
    • Ενδέχεται η βάση δεδομένων να υποδεικνύει αμέσως ότι είναι "Χωρίς δέσμευση" μετά την ενημέρωση. Αυτή η κατάσταση συμβαίνει επειδή η δυνατότητα Git Integration κάνει μια άμεση σύγκριση όλου του περιεχομένου αρχείου που δημιουργείται για έναν ορισμό στοιχείου και είναι πιθανές ορισμένες ακούσιες διαφορές. Ένα παράδειγμα είναι τα ενσωματωμένα χαρακτηριστικά σε στήλες. Σε αυτές τις περιπτώσεις, πρέπει να δεσμευτείτε ξανά στον έλεγχο προέλευσης στο περιβάλλον εργασίας web Fabric για να συγχρονίσετε τον ορισμό με αυτό που δημιουργείται ως μέρος μιας λειτουργίας υποβολής.
  10. Μόλις ολοκληρωθεί η ενημέρωση, χρησιμοποιήστε ένα εργαλείο της επιλογής σας για να συνδεθείτε στη βάση δεδομένων. Τα αντικείμενα που προσθέσατε στο έργο SQL είναι ορατά στη βάση δεδομένων.

Σημείωμα

Όταν κάνετε αλλαγές στο τοπικό έργο SQL, εάν υπάρχει σφάλμα σύνταξης ή χρήση μη υποστηριζόμενων δυνατοτήτων στο Fabric, η ενημέρωση της βάσης δεδομένων αποτυγχάνει. Για να συνεχίσετε, πρέπει να επαναφέρετε με μη αυτόματο τρόπο την αλλαγή στο στοιχείο ελέγχου προέλευσης.

Η ενημέρωση μιας βάσης δεδομένων SQL στο Fabric από το στοιχείο ελέγχου προέλευσης συνδυάζει μια λειτουργία δόμησης έργου SQL και δημοσίευσης SqlPackage. Το έργο SQL δόμηση επικυρώνει τη σύνταξη των αρχείων SQL και δημιουργεί ένα αρχείο .dacpac. Η λειτουργία δημοσίευσης SqlPackage καθορίζει τις αλλαγές που απαιτούνται για την ενημέρωση της βάσης δεδομένων ώστε να ταιριάζει με το .dacpac αρχείο. Λόγω της βελτιωμένης φύσης της διασύνδεσης Fabric, εφαρμόζονται οι ακόλουθες επιλογές στη λειτουργία δημοσίευσης sqlPackage:

  • /p:ScriptDatabaseOptions = false
  • /p:DoNotAlterReplicatedObjects = false
  • /p:IncludeTransactionalScripts = true
  • /p:GenerateSmartDefaults = true

Μπορείτε επίσης να κλωνοποιήσετε το έργο SQL που ελέγχεται από την προέλευση στον τοπικό υπολογιστή σας για επεξεργασία στον κώδικα του Visual Studio, στο SQL Server Management Studio ή σε άλλα εργαλεία έργου SQL. Δημιουργήστε το έργο SQL τοπικά για να επικυρώσετε τις αλλαγές πριν τις δεσμεύσετε στον έλεγχο προέλευσης.

Δημιουργία χώρου εργασίας διακλάδωσης

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

  1. Ολοκληρώστε το σενάριο μετατροπής της βάσης δεδομένων SQL Fabric σε κώδικα στο στοιχείο ελέγχου προέλευσης.
    • Θα πρέπει να έχετε μια διακλάδωση σε ένα αποθετήριο δεδομένων ελέγχου προέλευσης με ένα έργο SQL και τα μετα-δεδομένα αντικειμένου Fabric.
  2. Στον χώρο εργασίας Fabric, ανοίξτε τον πίνακα ελέγχου προέλευσης . Από την καρτέλα Κλάδοι του μενού ελέγχου Προέλευση, επιλέξτε Διακλάδωση προς τον νέο χώρο εργασίας.
  3. Καθορίστε τα ονόματα του κλάδου και του χώρου εργασίας που θέλετε να δημιουργήσετε. Η διακλάδωση δημιουργείται στο αποθετήριο στοιχείων ελέγχου προέλευσης και συμπληρώνεται με τα δεσμευμένα περιεχόμενα της διακλάδωσης που σχετίζεται με τον χώρο εργασίας από τον οποίο διακλαδώνεστε. Ο χώρος εργασίας δημιουργείται στο Fabric.
  4. Μεταβείτε στον χώρο εργασίας που μόλις δημιουργήσατε στο Fabric. Όταν ολοκληρωθεί η δημιουργία της βάσης δεδομένων, η βάση δεδομένων που μόλις δημιουργήθηκε περιέχει τα αντικείμενα που καθορίζονται στο αποθετήριο δεδομένων του κώδικά σας. Εάν ανοίξετε το πρόγραμμα επεξεργασίας ερωτημάτων Fabric και περιηγηθείτε στην Εξερεύνηση αντικειμένων, η βάση δεδομένων σας έχει νέους (κενούς) πίνακες και άλλα αντικείμενα.

Συγχώνευση αλλαγών από έναν κλάδο σε έναν άλλο

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

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

  1. Με τη βάση δεδομένων στον δευτερεύοντα κλάδο, κάντε αλλαγές στα αντικείμενα βάσης δεδομένων.
    • Για παράδειγμα, τροποποιήστε μια υπάρχουσα αποθηκευμένη διαδικασία ή δημιουργήστε έναν νέο πίνακα.
  2. Ελέγξτε αυτές τις αλλαγές στο στοιχείο ελέγχου προέλευσης χρησιμοποιώντας το κουμπί Δέσμευση στον πίνακα ελέγχου προέλευσης στο Fabric.
  3. Στο Azure DevOps ή στο GitHub, δημιουργήστε μια αίτηση έλξης από τη δευτερεύουσα διακλάδωση στην κύρια διακλάδωση.
    • Στο αίτημα έλξης, μπορείτε να δείτε τις αλλαγές στον κώδικα βάσης δεδομένων μεταξύ του κύριου χώρου εργασίας και του δευτερεύοντος χώρου εργασίας.
  4. Μόλις ολοκληρώσετε το αίτημα έλξης, το στοιχείο ελέγχου προέλευσης ενημερώνεται, αλλά η βάση δεδομένων στο Fabric στον κύριο χώρο εργασίας δεν αλλάζει. Για να αλλάξετε την κύρια βάση δεδομένων, ενημερώστε τον κύριο χώρο εργασίας από το στοιχείο ελέγχου προέλευσης χρησιμοποιώντας το κουμπί Ενημέρωση στον πίνακα ελέγχου προέλευσης στο Fabric.

Διαχείριση στατικών δεδομένων με δέσμη ενεργειών μετά την ανάπτυξη

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

  1. Από μια βάση δεδομένων SQL στο Fabric που είναι συνδεδεμένη με το στοιχείο ελέγχου προέλευσης, προσδιορίστε ή δημιουργήστε έναν πίνακα για τον οποίο θέλετε να διαχειριστείτε στατικά δεδομένα. Για παράδειγμα, μπορεί να έχετε έναν dbo.Colors πίνακα που χρησιμοποιείται από την εφαρμογή σας και έχει ένα γνωστό σύνολο τιμών που δεν αλλάζουν συχνά.

  2. Δημιουργήστε ένα νέο ερώτημα στο πρόγραμμα επεξεργασίας βάσης δεδομένων SQL στο Fabric. Στο πρόγραμμα επεξεργασίας ερωτημάτων, προσθέστε μια MERGE πρόταση για τη διαχείριση των περιεχομένων του Colors πίνακα. Για παράδειγμα:

    MERGE dbo.Colors AS target
    USING (VALUES
        (1, 'Red'),
        (2, 'Green'),
        (3, 'Blue')
    ) AS source (Id, Name)
    ON target.Id = source.Id
    WHEN MATCHED THEN
        UPDATE SET Name = source.Name
    WHEN NOT MATCHED BY TARGET THEN
        INSERT (Id, Name) VALUES (source.Id, source.Name)
    WHEN NOT MATCHED BY SOURCE THEN
        DELETE;
    
  3. Μετονομάστε το ερώτημα σε Post-Deployment-StaticData.sql και μετακινήστε το σε Κοινόχρηστα ερωτήματα.

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

Αυτό το ερώτημα εκτελείται αυτόματα ως μέρος οποιασδήποτε ενημέρωσης από την ανάπτυξη ελέγχου προέλευσης ή διοχέτευσης ανάπτυξης, ώστε να μπορείτε να διαχειριστείτε τα στατικά δεδομένα στον πίνακα χρησιμοποιώντας το Colors στοιχείο ελέγχου προέλευσης. Μπορείτε να επεξεργαστείτε το ερώτημα στο πρόγραμμα επεξεργασίας ερωτημάτων Fabric και να πραγματοποιήσετε αλλαγές στο στοιχείο ελέγχου προέλευσης για να διαχειριστείτε τις αλλαγές στα στατικά δεδομένα με την πάροδο του χρόνου. Επιπλέον, επειδή οι δέσμες ενεργειών πριν και μετά την ανάπτυξη περιλαμβάνονται στο έργο SQL, μπορείτε επίσης να επεξεργαστείτε το ερώτημα από τον τοπικό υπολογιστή σας χρησιμοποιώντας τον κώδικα του Visual Studio ή άλλα εργαλεία έργου SQL και, στη συνέχεια, να δεσμεύσετε αυτές τις αλλαγές στον έλεγχο προέλευσης. Μάθετε περισσότερα σχετικά με τις δέσμες ενεργειών πριν και μετά την ανάπτυξη στην τεκμηρίωση έργων SQL.