Lernprogramm: Speichern des Datenbankschemas in Git

• .NET 8 SDK
• Visual Studio 2022 Community, Professional oder Enterprise
• SQL Server Data Tools (SSDT) für Visual Studio installieren

• .NET 8 SDK
• Visual Studio Code
• SQL Database Projects-Erweiterung

• .NET SDK
• SQL Server Management Studio (SSMS)
• In SSMS installierte Datenbank DevOps-Workload

• .NET 8 SDK
• SqlPackage CLI
• Microsoft.Build.Sql.Templates .NET-Vorlagen

# install SqlPackage CLI
dotnet tool install -g Microsoft.SqlPackage

# install Microsoft.Build.Sql.Templates
dotnet new install Microsoft.Build.Sql.Templates

Klicken Sie im SQL Server Objekt-Explorer in Visual Studio mit der rechten Maustaste auf die Datenbank, aus der Sie eine project erstellen möchten, und wählen Sie Neue Project erstellen... .

Geben Sie im Dialogfeld Neues Projekt einen Projektnamen ein. Der Projektname muss nicht mit einem Datenbanknamen übereinstimmen. Überprüfen Sie den Projektstandort und ändern Sie ihn bei Bedarf. Die Standardimporteinstellungen importieren die Objekte nach Schema in Ordner und dann Objekttyp. Sie können die Importeinstellungen ändern, um die Ordnerstruktur zu ändern oder Berechtigungen in die zu importierenden Objekte einzuschließen. Starten eines Imports.

Im Dialogfeld "Datenbank importieren " wird der Importstatus als Meldungen angezeigt. Nach Abschluss des Imports werden die importierten Objekte im Projektmappen-Explorer angezeigt. Der Prozess speichert die Protokolle in einer Datei im Projektverzeichnis unter Import Schema Logs. Wählen Sie "Fertig stellen" aus.

Wählen Sie in der Ansicht des Datenbankobjekt-Explorers in Visual Studio Code eine Datenbank aus, aus der Sie ein Projekt erstellen möchten. Klicken Sie mit der rechten Maustaste auf die Datenbank, und wählen Sie Projekt aus Datenbank erstellen aus.

In Visual Studio Code erfordert das Dialogfeld Projekt aus der Datenbank erstellen den Projektnamen und den Speicherort. Die Standardimporteinstellungen importieren die Objekte nach Schema in Ordner und dann Objekttyp. Sie können eine andere Ordnerstruktur auswählen oder berechtigungen in die zu importierenden Objekte einschließen, bevor Sie "Erstellen" auswählen.

Öffnen Sie die Anzeige Datenbankprojekte, um die neuen Projekt- und importierten Objektdefinitionen anzuzeigen.

Klicken Sie im Objekt-Explorer in SQL Server Management Studio mit der rechten Maustaste auf die Datenbank, aus der Sie eine project erstellen möchten, und wählen Sie im Menü "Aufgaben" die Option "Project aus Datenbank erstellen" aus.

Überprüfen Sie im Dialogfeld "SQL-Project aus Datenbank erstellen" die ausgewählte Datenbank, und ändern Sie den project Namen und Speicherort nach Bedarf. Das neue Projekt wird mit den Objekten aus der ausgewählten Datenbank erstellt und in Ordnern nach Schema angeordnet, dann Objekttyp.

Eine Lösungsdatei wird automatisch im Ordner oberhalb des Projektordners erstellt und nach der Erstellung im Projektmappen-Explorer geöffnet. Wenn Sie Ihr neues Projekt zu einer vorhandenen Projektmappe hinzufügen möchten, wählen Sie "Zur Projektmappe hinzufügen" aus, und navigieren Sie zur Projektmappendatei. Wählen Sie "Erstellen" aus, um das Projekt zu erstellen.

Verwenden Sie die SQLPackage CLI, um das Schema einer vorhandenen Datenbank in ein SQL-Projekt zu extrahieren. Mit dem folgenden SqlPackage-Befehl wird das Schema einer Datenbank in ein vollständiges SQL-Projekt extrahiert. Die .sql Dateien werden nach geschachtelten Schema- und Objekttypordnern organisiert, und eine .sqlproj Datei wird erstellt, um das Projekt mit Eigenschaften zu verwalten, die den Optionen der Datenbank entsprechen.

sqlpackage /a:Extract /ssn:localhost /sdn:MyDatabase /tf:MyDatabaseProject /p:ExtractTarget=SqlProject

Wenn das SQL-Projekt in Visual Studio geöffnet ist, erstellen Sie ein lokales Git-Repository, und pushen Sie es an eine Remote.With the SQL project open in Visual Studio, create a local Git repository and push it to a remote.

1. Wählen Sie Git>Git-Repository erstellen aus der Menüleiste aus.

2. Wählen Sie im Dialogfeld "Git-Repository erstellen" unter "Push an einen neuen Remoteabschnitt" entweder GitHub oder Azure DevOps aus. Wenn Sie sich dafür entscheiden, an GitHub zu pushen, melden Sie sich bei Ihrem GitHub-Konto an, wenn Sie dazu aufgefordert werden. Wenn Sie Azure DevOps auswählen, melden Sie sich bei Ihrem Azure DevOps Konto an, und wählen oder erstellen Sie ein Projekt.

3. Geben Sie einen Repositorynamen und eine Beschreibung ein. Stellen Sie sicher, dass die Gitignore-Vorlage auf VisualStudio festgelegt ist, und wählen Sie "Erstellen und Push" aus.

Visual Studio erstellt das lokale Git-Repository, führt einen ersten Commit mit Ihren SQL-Projektdateien aus und pusht es in das Remote-Repository.

Um zu überprüfen, ob der Code erfolgreich übertragen wurde, öffnen Sie einen Browser, und navigieren Sie zu Ihrem Repository auf GitHub (https://github.com) oder Azure DevOps (https://dev.azure.com). Die SQL-Projektdateien, einschließlich der .sqlproj Datei und der .sql Objektdefinitionen, sollten angezeigt werden.

Weitere Informationen finden Sie unter "Info zu Git" in Visual Studio.

Wenn der SQL-Projektordner in Visual Studio Code geöffnet ist, initialisieren Sie ein lokales Git-Repository und übertragen Sie es in ein Remote-Repository.

1. Öffnen Sie die Ansicht "Quellcodeverwaltung ", indem Sie in der Aktivitätsleiste das Symbol "Quellcodeverwaltung" auswählen oder drücken Ctrl+Shift+G.

2. Wählen Sie "Repository initialisieren " aus, um ein neues Git-Repository im aktuellen Ordner zu erstellen.

3. Alle Projektdateien werden als nicht nachverfolgte Änderungen angezeigt. Wählen Sie das + Symbol neben "Änderungen " aus, um alle Dateien zu stufen.

4. Geben Sie eine Commit-Nachricht wie Initial commit of SQL project in das Nachrichteneingabefeld ein und wählen Sie die Schaltfläche Commit (Häkchensymbol) aus.

5. Wählen Sie in der Quellcodeverwaltung-Ansicht Branch veröffentlichen aus, um Ihr lokales Repository in ein Remote-Repository zu übertragen. Wählen Sie aus, ob Sie in GitHub oder in Azure DevOps veröffentlichen möchten, und folgen Sie den Anmeldeaufforderungen. Wählen Sie eine Sichtbarkeit des Repositorys (öffentlich oder privat) aus, und bestätigen Sie dies.

Um zu überprüfen, ob der Code erfolgreich übertragen wurde, öffnen Sie einen Browser, und navigieren Sie zu Ihrem Repository auf GitHub (https://github.com) oder Azure DevOps (https://dev.azure.com). Die SQL-Projektdateien, einschließlich der .sqlproj Datei und der .sql Objektdefinitionen, sollten angezeigt werden.

Weitere Informationen finden Sie unter "Quellcodeverwaltung" in Visual Studio Code.

Wenn das SQL-Projekt in SQL Server Management Studio geöffnet ist, erstellen Sie ein lokales Git-Repository, und übertragen Sie es an eine Remote.With the SQL project open in SQL Server Management Studio, create a local Git repository and push it to a remote.

1. Wählen Sie in der Menüleiste Git>Git-Repository erstellen aus.

2. Wählen Sie im Dialogfeld "Git-Repository erstellen" unter "Push an einen neuen Remoteabschnitt" entweder GitHub oder Azure DevOps aus. Wenn Sie Ihre Änderungen an GitHub übertragen möchten, melden Sie sich bei Aufforderung bei Ihrem GitHub-Konto an. Wenn Sie Azure DevOps auswählen, melden Sie sich bei Ihrem Azure DevOps Konto an, und wählen oder erstellen Sie ein Projekt.

3. Geben Sie einen Repositorynamen und eine Beschreibung ein. Stellen Sie sicher, dass die Gitignore-Vorlage auf VisualStudio festgelegt ist, und wählen Sie "Erstellen und Push" aus.

SSMS erstellt das lokale Git-Repository, führt mit Ihren SQL-Projektdateien einen ersten Commit aus und überträgt es in das Remote-Repository.

Um zu überprüfen, ob der Code erfolgreich übertragen wurde, öffnen Sie einen Browser, und navigieren Sie zu Ihrem Repository auf GitHub (https://github.com) oder Azure DevOps (https://dev.azure.com). Die SQL-Projektdateien, einschließlich der .sqlproj Datei und der .sql Objektdefinitionen, sollten angezeigt werden.

Weitere Informationen finden Sie unter "Info zu Git" in Visual Studio.

Initialisieren Sie im SQL-Projektverzeichnis ein lokales Git-Repository, committen Sie sämtliche Dateien und pushen Sie sie in ein Remote-Repository.

1. Initialisieren Sie ein neues Git-Repository, fügen Sie eine .gitignore Datei hinzu, und erstellen Sie einen ersten Commit:

   cd MyDatabaseProject
   git init
   dotnet new gitignore
   git add .
   git commit -m "Initial commit of SQL project"
   

2. Erstellen Sie ein neues Remote-Repository in GitHub oder Azure DevOps:

   • GitHub: Gehen Sie zu https://github.com/new und erstellen Sie ein neues Repository. Initialisieren Sie es nicht mit einem README, .gitignore oder einer Lizenz.
   • Azure DevOps: Wechseln Sie zu Ihrem Azure DevOps Projekt, wählen Sie Repos aus, und erstellen Sie ein neues Repository. Deaktivieren Sie das Kontrollkästchen "README hinzufügen".

3. Fügen Sie die Remoteverbindung hinzu und übertragen Sie den anfänglichen Commit:

   git remote add origin <your-repository-url>
   git push -u origin main
   

   Ersetzen Sie <your-repository-url> beim Erstellen des Repositorys durch die von GitHub oder Azure DevOps bereitgestellte URL.

Um zu überprüfen, ob der Code erfolgreich übertragen wurde, öffnen Sie einen Browser, und wechseln Sie zu Ihrem Repository. Die SQL-Projektdateien, einschließlich der .sqlproj Datei und der .sql Objektdefinitionen, sollten angezeigt werden.

Verwenden Sie den Schemaabgleich, um das SQL-Projekt aus der Datenbank zu aktualisieren.

1. Klicken Sie in SQL Server Objekt-Explorer mit der rechten Maustaste auf die Datenbank, und wählen Sie "Schemaabgleich" aus.

2. Im Fenster "Schemaabgleich " wird die Datenbank als Quelle festgelegt. Wählen Sie die Dropdownliste " Ziel auswählen " und dann "Ziel auswählen" aus.

3. Wählen Sie im Dialogfeld „Zielschema auswählen“ Projekt aus, und wählen Sie Ihr SQL-Datenbankprojekt aus. Wählen Sie OK aus.

4. Wählen Sie Vergleichen aus, um den Vergleich auszuführen. Die Ergebnisse zeigen die Unterschiede zwischen der Datenbank (Quelle) und dem Projekt (Ziel) an.

5. Überprüfen Sie die Unterschiede. Deaktivieren Sie alle Änderungen, die Sie nicht auf das Projekt anwenden möchten.

6. Wählen Sie "Aktualisieren" aus, um die ausgewählten Änderungen auf das SQL-Projekt anzuwenden.

Die Projektdateien werden aktualisiert, um dem Datenbankschema zu entsprechen. Überprüfen Sie die Änderungen im Fenster Git-Änderungen, geben Sie eine Commit-Nachricht ein, und wählen Sie Commit für alle übernehmen aus. Wählen Sie "Push" aus, um die Änderungen an das Remote-Repository zu übertragen.

Verwenden Sie den Befehl Projekt aus Datenbank aktualisieren, um das SQL-Projekt aus der Datenbank zu aktualisieren.

1. Klicken Sie im Datenbankobjekt-Explorer mit der rechten Maustaste auf die Datenbank, und wählen Sie SQL-Datenbankprojekte>Projekt aus Datenbank aktualisieren aus.

2. Wählen Sie das SQL-Datenbankprojekt aus, das aktualisiert und bestätigt werden soll.

3. Der Vergleich wird ausgeführt und wendet die Änderungen aus der Datenbank auf das Projekt an. Die aktualisierten .sql Dateien werden in der Ansicht "Quellcodeverwaltung " als geänderte Dateien angezeigt.

Überprüfen Sie die Änderungen in der Ansicht "Quellcodeverwaltung ", stufen Sie die geänderten Dateien auf, geben Sie eine Commit-Nachricht ein, und wählen Sie "Commit ausführen" aus. Wählen Sie "Änderungen synchronisieren" aus, um den Commit an das Remote-Repository zu übertragen.

Verwenden Sie den Schemaabgleich, um das SQL-Projekt aus der Datenbank zu aktualisieren.

1. Klicken Sie im Objekt-Explorer mit der rechten Maustaste auf die Datenbank, und wählen Sie Tasks>Schemavergleich (Vorschau) aus.

2. Im Fenster "Schemaabgleich " wird die Datenbank als Quelle festgelegt. Klicken Sie auf die Schaltfläche mit den Auslassungspunkten und wählen Sie Ihr SQL-Datenbankprojekt als Ziel aus.

3. Wählen Sie Vergleichen aus, um den Vergleich auszuführen. Die Ergebnisse zeigen die Unterschiede zwischen der Datenbank (Quelle) und dem Projekt (Ziel) an.

4. Überprüfen Sie die Unterschiede. Deaktivieren Sie alle Änderungen, die Sie nicht auf das Projekt anwenden möchten.

5. Wählen Sie Übernehmen aus, um die ausgewählten Änderungen auf das SQL-Projekt anzuwenden.

Die Projektdateien werden aktualisiert, um dem Datenbankschema zu entsprechen. Überprüfen Sie die Änderungen im Fenster Git-Änderungen, geben Sie eine Commit-Nachricht ein, und wählen Sie Commit für alle übernehmen aus. Wählen Sie "Push" aus, um die Änderungen an das Remote-Repository zu übertragen.

Verwenden Sie SqlPackage, um das SQL-Projekt aus der Datenbank neu zu generieren und die vorhandenen Projektdateien durch das aktuelle Datenbankschema zu ersetzen. Während die anderen SQL-Projekttools eine grafische Oberfläche bereitstellen, bietet SqlPackage einen Befehlszeilenansatz für die Automatisierung, der keine Möglichkeit bietet, die Dateiänderungen zu überprüfen, bevor sie angewendet werden.

1. Entfernen Sie die vorhandenen SQL-Objektdateien, und generieren Sie das Projekt neu:

   rm -rf MyDatabaseProject
   sqlpackage /a:Extract /ssn:localhost /sdn:MyDatabase /tf:MyDatabaseProject /p:ExtractTarget=SqlProject
   

2. Überprüfen Sie die Änderungen mit Git, und übernehmen Sie Folgendes:

   cd MyDatabaseProject
   dotnet new gitignore
   git add .
   git status
   git commit -m "Update project from database changes"
   git push
   

1. Wählen Sie Git>Pull aus der Menüleiste aus, um die neuesten Änderungen aus dem Remote-Repository abzurufen.

2. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf den SQL-Datenbankprojektknoten, und wählen Sie "Schemaabgleich" aus.

3. Im Fenster "Schemavergleich " wird das Projekt als Quelle festgelegt. Wählen Sie die Dropdownliste " Ziel auswählen " und dann "Ziel auswählen" aus.

4. Wählen Sie im Dialogfeld "Zielschema auswählen" die Option "Datenbank" aus, und wählen Sie die verbindung mit der lokalen Entwicklungsdatenbank aus. Wählen Sie OK aus.

5. Wählen Sie Vergleichen aus, um den Vergleich auszuführen. Die Ergebnisse zeigen die Unterschiede zwischen dem Projekt (Quelle) und der Datenbank (Ziel) an.

6. Überprüfen Sie die Unterschiede, um zu überprüfen, ob die Änderungen erwartet werden.

7. Wählen Sie "Aktualisieren" aus, um die Änderungen auf die Datenbank anzuwenden.

1. Öffnen Sie die Ansicht "Quellcodeverwaltung", und wählen Sie im Menü "..." die Option "Ziehen" aus (oder verwenden Sie die Schaltfläche "Synchronisieren" in der Statusleiste), um die neuesten Änderungen aus dem Remote-Repository abzurufen.

2. Klicken Sie in der Ansicht "Datenbankprojekte " mit der rechten Maustaste auf das SQL-Datenbankprojekt, und wählen Sie "Schemaabgleich" aus.

3. Im Fenster "Schemavergleich " wird das Projekt als Quelle festgelegt. Wählen Sie die Zielschaltfläche mit den Auslassungspunkten aus, und wählen Sie Ihre lokale Datenbankverbindung für die Entwicklung als Ziel aus.

4. Wählen Sie Vergleichen aus, um den Vergleich auszuführen. Die Ergebnisse zeigen die Unterschiede zwischen dem Projekt (Quelle) und der Datenbank (Ziel) an.

5. Überprüfen Sie die Unterschiede, um zu überprüfen, ob die Änderungen erwartet werden.

6. Wählen Sie Übernehmen aus, um die Änderungen in der Datenbank zu übernehmen.

1. Öffnen Sie ein Terminal und führen Sie git pull im Projektverzeichnis aus, um die neuesten Änderungen aus dem Remote-Repository abzurufen.

2. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf den SQL-Datenbankprojektknoten, und wählen Sie "Schemaabgleich( Vorschau)" aus.

3. Im Fenster "Schemavergleich " wird das Projekt als Quelle festgelegt. Wählen Sie das Ziel aus, und wählen Sie ihre lokale Entwicklungsdatenbankverbindung aus.

4. Wählen Sie Vergleichen aus, um den Vergleich auszuführen. Die Ergebnisse zeigen die Unterschiede zwischen dem Projekt (Quelle) und der Datenbank (Ziel) an.

5. Überprüfen Sie die Unterschiede, um zu überprüfen, ob die Änderungen erwartet werden.

6. Wählen Sie Übernehmen aus, um die Änderungen in der Datenbank zu übernehmen.

1. Rufen Sie die neuesten Änderungen aus dem Remote-Repository ab:

   cd MyDatabaseProject
   git pull
   

2. Erstellen Sie das Projekt, um zu überprüfen, ob die Änderungen erfolgreich kompiliert wurden:

   dotnet build
   

3. Stellen Sie die Änderungen in Ihrer lokalen Entwicklungsdatenbank mithilfe von SqlPackage bereit:

   sqlpackage /a:Publish /sf:bin/Debug/MyDatabaseProject.dacpac /tsn:localhost /tdn:MyDatabase
   

   Ersetzen Sie MyDatabaseProject.dacpac durch den Namen Ihrer .dacpac-Ausgabedatei, und aktualisieren Sie die Werte für den Zielserver (/tsn) und die Datenbank (/tdn) nach Bedarf.