SQL Server Data Tools, SDK-Stil (Vorschau)

SQL Server Data Tools (SSDT) ist eine Reihe von Entwicklungstools in Visual Studio, die sich auf das Erstellen von SQL Server-Datenbanken und Azure SQL-Datenbanken konzentrieren. SQL-Projekte im SDK-Stil in Visual Studio ermöglichen die Nutzung der nächsten Generation von SQL-Projekten als Teil des Features SQL Server Data Tools, SDK-Stil (Vorschau) für Visual Studio 2022. Die SQL-Projektfunktion erstreckt sich auf CI/CD-Pipelines, sodass Sie den Build und die Bereitstellung Ihrer Datenbankprojekte mit sqlPackage automatisieren können.

Übersicht

Das ursprüngliche SQL-Projektformat basiert auf MSBuild (.NET Framework) und ist das Format, das von SQL Server Data Tools in Visual Studio verwendet wird. Das Projektformat im SDK-Stil basiert auf den neuen SDK-Formatprojekten (Microsoft.Build.Sql) und ist das Format, das von der SQL-Datenbankprojekteerweiterung für Visual Studio Code verwendet wird. Das Microsoft.Build.Sql-Projekt-SDK ist flexibler als die ursprünglichen SQL-Projekte und enthält neue Features:

• .NET 8-Unterstützung (plattformübergreifend)
• NuGet-Paketverweise für Datenbankverweise
• Standard-Globbingmuster für .sql Dateien im Projekt

Visual Studio 2026 unterstützt keine SQL-Projekte im SDK-Stil, und die ursprünglichen SQL-Projekte sind das einzige SQL-Projektformat, das in dieser Version von Visual Studio verfügbar ist. Visual Studio 2022 ist die einzige Version von Visual Studio, die SQL-Projekte im SDK-Stil in der KOMPONENTE SQL Server Data Tools, SDK-Format (Vorschau) enthält.

Weitere Informationen zu SQL-Projekten finden Sie unter Was sind SQL-Datenbankprojekte?. Das Microsoft.Build.Sql SDK ist auf GitHub und auf NuGet.org verfügbar.

Installieren

Warnung

Das Feature für SQL-Projekte im SDK-Stil wird in der Vorschau und parallelen Installation mit den ursprünglichen SQL-Projekten nicht unterstützt. Die Installation der SQL-Projekte im SDK-Stil in einer eigenständigen Visual Studio-Instanz wird empfohlen.

Führen Sie die folgenden Schritte aus, um die SQL-Projekte im SDK-Stil in Visual Studio 2022 zu installieren:

1. Laden Sie Visual Studio 2022 (17.12 oder höher) von der Visual Studio-Downloadseite herunter, und installieren Sie sie.

2. Wählen Sie während der Installation die Registerkarte Einzelne Komponenten aus und suchen Sie nach „SQL“, um nach „SQL Server Data Tools SDK-Style (Vorschau)“ zu suchen und es auszuwählen. Wenn Sie dieses Element auswählen, werden automatisch erforderliche Abhängigkeiten ausgewählt.

3. Suchen Sie auf der Registerkarte "Einzelkomponenten " nach ".NET SDK", und wählen Sie die Komponente ".NET SDK" aus. Wenn Sie dieses Element auswählen, werden automatisch erforderliche Abhängigkeiten einschließlich der unterstützten .NET-Laufzeiten ausgewählt. Die .NET SDK-Komponente ermöglicht die Unterstützung für zusätzliche Versionen des Microsoft.Build.Sql SDK in Visual Studio, die über NuGet.org verfügbar sind.

   

4. Fahren Sie mit der Installation fort, ohne Workloads oder zusätzliche Features auszuwählen.

Die Visual Studio-Dokumentation enthält zusätzliche Informationen zum Ändern von Visual Studio-Installationen zum Auswählen einzelner Komponenten.

Unerwartetes Verhalten kann auftreten, wenn die SQL-Projekte im SDK-Stil nebeneinander mit den ursprünglichen SQL-Projekten installiert werden und die SQL Server-Datentools im SDK-Stil als eigenständige Komponente installiert werden. Um zu überprüfen, welche Komponenten Teil einer Visual Studio-Installation sind, verwenden Sie das Hilfe-Menü in Visual Studio und wählen Sie Informationen zu Microsoft Visual Studio aus. Es stehen mehrere Ansätze zur Verfügung, um mehrere Visual Studio-Instanzen auf einem einzelnen Computer zu verwenden:

• Installieren Sie verschiedene Veröffentlichungskanäle von Visual Studio, z. B. Visual Studio 2022 und Visual Studio 2022 Vorschau.

• Installieren Sie verschiedene Editionen von Visual Studio, z. B. Visual Studio Community und Visual Studio Enterprise.

• Installieren Sie ein bestimmtes Verzeichnis, um eine Visual Studio-Instanz von einer zuvor installierten Version zu trennen.

Begrenzungen

Ein vollständiger Vergleich der Funktionalität zwischen den SQL-Projekt-Tools ist in SQL-Projekten-Tools verfügbar. Das Feature für SQL-Projekte im SDK-Stil in Visual Studio hat die folgenden Einschränkungen:

• Parallele Installation mit ursprünglichen SQL-Projekten wird nicht unterstützt

• Die SQL-Projektdatei verwendet die Erweiterung .sqlprojx anstelle von .sqlproj in Visual Studio 17.12 Preview 2. In Visual Studio 17.12 Preview 3 und höher lautet die Erweiterung .sqlproj.

• SQLCLR-Objekte werden nicht unterstützt

• Die Schemavergleichsschnittstelle ist nicht aktiviert

• Die Tabellen-Designer-Schnittstelle ist nicht aktiviert

• Die Datenvergleichsschnittstelle ist nicht aktiviert

• Datenbankeinheitstests sind nicht aktiviert

Die Unterstützung für SQL-Projekte im SDK-Stil in Visual Studio wird in der Vorschau angezeigt, und die Installation aus der neuesten Visual Studio 2022-Vorschauversion empfohlen. Das Feature für SQL-Projekte in Visual Studio befindet sich in der aktiven Entwicklung und Feedback ist über die Entwicklercommunity willkommen.

Konvertieren vorhandener Projekte

SQL-Projekte im Microsoft.Build.Sql-SDK-Stil können von Grund auf neu erstellt oder aus vorhandenen SQL-Projekten konvertiert werden. Die Konvertierung eines ursprünglichen SQL-Projekts in ein Microsoft.Build.Sql-Projekt kann durchgeführt werden, aber das Erstellen einer Sicherung des Projekts vor der Konvertierung wird empfohlen. Wenn Sie ein vorhandenes SQL-Projekt in ein SDK-Formatprojekt konvertieren möchten, führen Sie die Schritte im Handbuch zum Konvertieren eines ursprünglichen SQL-Projekts in ein Anleitung zum SDK-Format aus.

Zugehöriger Inhalt

• Was sind SQL-Datenbankprojekte?
• Visual Studio 2022: Anmerkungen zur Vorschauversion
• SQL-Projekte in Visual Studio Code