Teilen über

SQL Server Data Tools, SDK-Stil (Vorschau)

  • Artikel

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 Fähigkeit von SQL-Projekten erstreckt sich auf CI/CD-Pipelines, so dass Sie die Erstellung und Bereitstellung Ihrer Datenbankprojekte mit der SqlPackage CLI 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 Erweiterung „SQL Database Projects“ für Azure Data Studio und VS 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

Neue Entwicklungsarbeiten sollten die Verwendung des SDK-Stil-Projektformats in Betracht ziehen, da es sich um das Format handelt, das in Zukunft unterstützt wird. SDK-Stilprojekte verfügen über eine Obermenge von Funktionen aus ursprünglichen SQL-Projekten, und vorhandene SQL-Projekte können durch Änderung der Projektdatei in SDK-Formatprojekte konvertiert werden. Die Ausnahme von der Funktionalitätsabdeckung ist die Unterstützung für SQLCLR-Objekte, die .NET Framework erfordern und in SDK-Formatprojekten nicht unterstützt werden.

Weitere Dokumentationen zu SQL-Projekten finden Sie im Thema zu SQL-Datenbankprojekten, und 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 Vorschau (17.12 Vorschau 2 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. Fahren Sie mit der Installation fort, ohne Workloads oder zusätzliche Features auszuwählen.

Screenshot des Visual Studio-Installationsprogramms mit geöffneter Registerkarte für die einzelnen Komponenten.

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 parallel mit den ursprünglichen SQL-Projekten installiert werden, und die SQL Server Data Tools 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 Vorschau 2
  • 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-Stil-Projekt konvertieren möchten, führen Sie die Schritte in der Schrittanleitung zum Konvertieren des ursprünglichen SQL-Projekts aus.

Zugehöriger Inhalt