Erste Schritte mit der Erweiterung „SQL Database Projects“

In diesem Artikel werden drei Möglichkeiten für die ersten Schritte mit der Erweiterung „SQL Database Projects“ beschrieben:

  1. Erstellen Sie ein neues Datenbankprojekt, indem Sie zur Ansicht Datenbankprojekte navigieren oder in der Befehlspalette nach Datenbankprojekte: Neu suchen.

  2. Vorhandene Datenbankprojekte können in der Befehlspalette über Datenbankprojekte: Vorhandene öffnen geöffnet werden.

  3. Starten Sie mit einer vorhandenen Datenbank indem Sie in der Befehlspalette Datenbankprojekte: Projekt aus Datenbank erstellen oder in der Ansicht Verbindungen die Option Projekt aus Datenbank erstellen auswählen.

    New viewlet

Nachdem Sie ein SQL-Projekt erstellt oder geöffnet haben, können Sie mit der Entwicklung von SQL-Projekten beginnen. Folgende Aktionen können Sie ausführen:

Erstellen eines leeren Datenbankprojekts

Wählen Sie in der Ansicht Datenbankprojekte die Schaltfläche Neues Projekt aus, und geben Sie in der angezeigten Texteingabe einen Projektnamen ein. Wählen Sie im angezeigten Dialogfeld „Select a Folder“ (Ordner auswählen) ein Verzeichnis für den Ordner, die .sqlproj-Datei und andere Inhalte des Projekts aus. Das leere Projekt wird geöffnet und in der Ansicht Datenbankprojekte für die Bearbeitung angezeigt.

Öffnen eines vorhandenen Projekts

Wählen Sie in der Ansicht Datenbankprojekte die Schaltfläche Projekt öffnen aus, und öffnen Sie über die angezeigte Dateiauswahl eine vorhandene SQLPROJ-Datei. Vorhandene Projekte können aus Azure Data Studio, VS Code oder Visual Studio SQL Server Data Tools stammen.

Das vorhandene Projekt wird geöffnet und seine Inhalte werden in der Ansicht Datenbankprojekte für die Bearbeitung angezeigt.

Erstellen eines Datenbankprojekts aus einer vorhandenen Datenbank

Anstatt mit einem leeren Projekt zu beginnen, können Sie auch schnell ein SQL-Datenbank-Projekt mit vorhandenen Objekten aus einer Datenbank auffüllen.

Im Objekt-Explorer

Stellen Sie in der Ansicht Verbindungen eine Verbindung mit der SQL-Instanz her, die die zu extrahierende Datenbank enthält. Klicken Sie mit der rechten Maustaste auf die Datenbank, und wählen Sie im Kontextmenü Projekt aus Datenbank erstellen aus.

Screenshot of create Project from Database dialog.

Die Ordnerstruktureinstellung ist standardmäßig auf Schema/Objekttyp festgelegt und bietet verschiedene Möglichkeiten, die vorhandenen Objekte automatisch zu organisieren, wenn sie in einem Skript verwendet werden. Folgende Optionen sind in der Ordnerstruktureinstellung verfügbar:

  • Datei: Für alle Objekte wird eine einzelne Datei erstellt.
  • Flach: Für alle Objekte in einzelnen Dateien wird ein einziger Ordner erstellt.
  • Objekttyp: Pro Objekttyp wird ein Ordner erstellt, und jedes Objekt wird per Skript in eine Datei geschrieben.
  • Schema: Pro Schema wird ein Ordner erstellt, und jedes Objekt wird per Skript in eine Datei geschrieben.
  • Schema/Objekttyp: Pro Schema wird ein Ordner erstellt. Innerhalb des Ordners wird pro Objekttyp ein Ordner erstellt, und jedes Objekt wird per Skript in eine Datei geschrieben.

In der Ansicht „Datenbankprojekte“

Wählen Sie in der Ansicht Projekte die Schaltfläche Projekt aus Datenbank importieren aus, und stellen Sie eine Verbindung mit einer SQL-Instanz her. Wählen Sie, sobald die Verbindung hergestellt wurde, eine Datenbank aus der Liste der verfügbaren Datenbanken aus, und legen Sie den Namen des Projekts fest.

Wählen Sie abschließend eine Ordnerstruktur für die Extraktion aus. Das neue Projekt wird geöffnet und enthält SQL-Skripts für die Inhalte der ausgewählten Datenbank.

Weitere Aktionen

Erstellen und Veröffentlichen

In der Erweiterung „SQL-Datenbank-Projekte“ stellen Sie das Datenbankprojekt bereit, indem Sie es als Datenschichtanwendungs-Datei (DACPAC) erstellen und auf einer unterstützten Plattform veröffentlichen. Weitere Informationen zu diesem Prozess finden Sie unter Erstellen und Veröffentlichen eines Projekts.

Schemavergleich

Die Erweiterung „SQL-Datenbank-Projekte“ interagiert mit der Erweiterung „Schemavergleich“ (sofern installiert), um die Inhalte eines Projekts mit einem DAC-Paket oder einer vorhandenen Datenbank zu vergleichen. Der resultierende Schemavergleich kann verwendet werden, um die Unterschiede zwischen Quelle und Ziel anzuzeigen und zu übernehmen.

Screenshot of schema compare dialog comparing a SQL project to a database.

Aktualisieren von Projekten aus Datenbanken

Bei Änderungen an einer Datenbank, die noch nicht im SQL-Projekt vorgenommen wurden, kann das SQL-Projekt mit dem Zustand einer Datenbank aktualisiert werden. Hierzu wählen Sie im Kontextmenü einer Datenbank in der Ansicht Verbindungen oder im Kontextmenü eines SQL-Projekts in der Ansicht Datenbankprojekte die Option Projekt aus Datenbank aktualisieren aus.

Screenshot of update Project from Database dialog.

Nächste Schritte