Κοινή χρήση μέσω


SqlPackage για βάση δεδομένων SQL στο Microsoft Fabric

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

Σε αυτή την εκμάθηση, θα μάθετε πώς να εργάζεστε με το SqlPackage στη βάση δεδομένων SQL σας στο Fabric.

Το SqlPackage είναι ένα CLI που παρέχει φορητότητα βάσης δεδομένων και αναπτύξεις βάσης δεδομένων.

  • Η φορητότητα (εισαγωγή/εξαγωγή) μιας βάσης δεδομένων με διαχείριση στο Azure ή στο Fabric εξασφαλίζει ότι τα δεδομένα σας είναι φορητά σε άλλες πλατφόρμες, συμπεριλαμβανομένου του SQL Server ή της Διαχειριζόμενης παρουσίας SQL Azure, σε περίπτωση που θέλετε να κάνετε μετεγκατάσταση αργότερα.
  • Η ίδια φορητότητα επιτρέπει επίσης ορισμένα σενάρια μετεγκατάστασης μέσω αυτόνομων αντιγράφων βάσης δεδομένων (.bacpac) με λειτουργίες εισαγωγής/εξαγωγής.

Το SqlPackage μπορεί επίσης να επιτρέψει την εύκολη ανάπτυξη βάσεων δεδομένων επαυξητικών αλλαγών στα αντικείμενα βάσης δεδομένων (νέες στήλες σε πίνακες, αλλαγές σε υπάρχουσες αποθηκευμένες διαδικασίες κ.λπ.).

  • Το SqlPackage μπορεί να εξαγάγει ένα .dacpac αρχείο που περιέχει τους ορισμούς των αντικειμένων σε μια βάση δεδομένων και να δημοσιεύσει ένα .dacpac αρχείο για να εφαρμόσει αυτή την κατάσταση αντικειμένου σε μια νέα ή υπάρχουσα βάση δεδομένων.
  • Η λειτουργία δημοσίευσης ενοποιείται επίσης με έργα SQL, τα οποία επιτρέπουν κύκλους ανάπτυξης χωρίς σύνδεση και πιο δυναμικούς κύκλους ανάπτυξης για βάσεις δεδομένων SQL.

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

Ρύθμιση

Το SqlPackage διατίθεται για Windows, macOS και Linux ως εργαλείο dotnet. Μπορείτε να την εγκαταστήσετε χρησιμοποιώντας την ακόλουθη εντολή:

dotnet tool install --global Microsoft.SqlPackage

Ως καθολικό εργαλείο dotnet, το SqlPackage είναι διαθέσιμο στο τερματικό σας όπως sqlpackage από οποιονδήποτε φάκελο.

Εισαγωγή βάσης δεδομένων με το SqlPackage

Το A .bacpac είναι ένα φορητό αντίγραφο μιας βάσης δεδομένων, χρήσιμο για ορισμένα σενάρια μετεγκατάστασης και δοκιμών. Μπορείτε να την .bacpac εισαγάγετε σε μια κενή βάση δεδομένων SQL.

Σημείωμα

Το A .bacpac δεν είναι αντίγραφο ασφαλείας ή αντικατάσταση για δυνατότητες δημιουργίας αντιγράφων ασφαλείας/επαναφοράς. Για περισσότερες πληροφορίες σχετικά με τα αντίγραφα ασφαλείας στη βάση δεδομένων SQL Fabric, ανατρέξτε στο θέμα Αυτόματη δημιουργία αντιγράφων ασφαλείας σε βάση δεδομένων SQL στο Microsoft Fabric και Επαναφορά από ένα αντίγραφο ασφαλείας στη βάση δεδομένων SQL στο Microsoft Fabric.

  1. Εάν χρησιμοποιείτε ένα .bacpac από το περιβάλλον βάσης δεδομένων SQL Azure σας, ίσως χρειαστεί να αλλάξετε τη βάση δεδομένων προέλευσης για να ικανοποιεί την περιοχή επιφάνειας T-SQL βάσης δεδομένων SQL Fabric.

  2. Δημιουργήστε τη νέα βάση δεδομένων SQL σας στο Fabric όπως συνήθως μέσω της διασύνδεσης Fabric.

  3. Αντιγράψτε τη συμβολοσειρά σύνδεσης από τις ρυθμίσεις.

    Στιγμιότυπο οθόνης από την πύλη Fabric που εμφανίζει τη σελίδα Συμβολοσειρές σύνδεσης της βάσης δεδομένων SQL.

  4. Χρησιμοποιήστε την εντολή εισαγωγής από το τερματικό στον φάκελο sqlpackage. Καταχωρήστε τον κάτοχο <servername> και <database_name>.

    sqlpackage /action:import /sourcefile:"C:\DatabaseName.bacpac" /targetconnectionstring:"Data Source=tcp:<server_name>.database.windows.net,1433;Initial Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive"
    
    • Αντικαταστήστε τη συμβολοσειρά σύνδεσης από το παράθυρο διαλόγου Ρυθμίσεις βάσης δεδομένων SQL.
    • Αντικαταστήστε την sourcefile τιμή με το .bacpac όνομα (DatabaseName) και location στον τοπικό υπολογιστή σας.

Για περισσότερες πληροφορίες σχετικά με την εισαγωγή, ανατρέξτε στο θέμα Εισαγωγή SqlPackage.

Εξαγωγή βάσης δεδομένων με το SqlPackage

Η εξαγωγή μιας .bacpac λειτουργίας είναι η αντίστροφη λειτουργία, όπου η δική σας targetfile είναι .bacpac και μπορείτε sourceconnectionstring να τη βρείτε στο παράθυρο διαλόγου Ρυθμίσεις βάσης δεδομένων SQL, όπως στο προηγούμενο παράδειγμα. Καταχωρήστε τον κάτοχο <servername> και <database_name>. Για παράδειγμα:

sqlpackage.exe /action:export /targetfile:"C:\DatabaseName.bacpac" /sourceconnectionstring:"Data Source=tcp:<server_name>.database.windows.net,1433;Initial    Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive"

Για περισσότερες πληροφορίες σχετικά με την εξαγωγή, ανατρέξτε στο θέμα Εξαγωγή sqlPackage.

Εξαγωγή και δημοσίευση

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

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

Το SqlPackage έχει τη δυνατότητα ανάπτυξης μιας .dacpac νέας (κενής) βάσης δεδομένων ή επαυξητικής ενημέρωσης μιας υπάρχουσας βάσης δεδομένων ώστε να ταιριάζει με την επιθυμητή .dacpac κατάσταση.

  • Η εξαγωγή δημιουργεί .dacpac αρχεία ή sql από μια υπάρχουσα βάση δεδομένων.
  • Η δημοσίευση αναπτύσσει μια .dacpac σε μια βάση δεδομένων.

Η σύνταξη δημοσίευσης του SqlPackage είναι παρόμοια με τις εντολές εισαγωγής/εξαγωγής.