SQL Server Data Tools、SDK スタイル (プレビュー)

SQL Server Data Tools (SSDT) は、SQL Server データベースと Azure SQL データベースの構築に重点を置いた Visual Studio の開発ツールのセットです。 Visual Studio の SDK スタイルの SQL プロジェクトにより、Visual Studio 2022 で使用できる SQL Server Data Tools、SDK スタイル (プレビュー) 機能の一部として、次世代の SQL プロジェクトを利用できるようになります。 SQL プロジェクト 機能は CI/CD パイプラインに拡張され、SqlPackage CLI を使用してデータベース プロジェクトのビルド & デプロイを自動化できます。

概要

元の SQL プロジェクト形式は MSBuild (.NET Framework) に基づいており、Visual Studio の SQL Server Data Tools で使用される形式です。 SDK スタイルのプロジェクト形式は、新しい SDK スタイルのプロジェクト (Microsoft.Build.Sql) に基づいており、Azure Data Studio および VS Code の SQL Database プロジェクト拡張機能で使用される形式です。 Microsoft.Build.Sql プロジェクト SDK は、元の SQL プロジェクトよりも柔軟性が高く、新機能サポートしています。

• .NET 8 のサポート (クロス プラットフォーム)
• データベース参照の NuGet パッケージ参照
• プロジェクト内の.sql ファイルの既定の glob パターン

新しい開発作業では、今後サポートされる形式であるため、SDK スタイルのプロジェクト形式の使用を検討する必要があります。 SDK スタイルのプロジェクトには、元の SQL プロジェクトの機能のスーパーセットがあり、既存の SQL プロジェクトは、プロジェクト ファイルの変更によって SDK スタイルのプロジェクトに変換できます。 機能カバレッジの例外は、.NET Framework を必要とし、SDK スタイルのプロジェクトではサポートされていない SQLCLR オブジェクトのサポートです。

SQL プロジェクトの詳細については、 SQL データベース プロジェクトのトピックを参照してください。Microsoft.Build.Sql SDK は GitHub と NuGet.org で入手できます。

インストール

警告

SDK スタイルの SQL プロジェクト機能はプレビュー版です。インストールして元の SQL プロジェクトと共存させて使用することはできません。 スタンドアロンの Visual Studio インスタンスに SDK スタイルの SQL プロジェクトをインストールすることをお勧めします。

Visual Studio 2022 で SDK スタイルの SQL プロジェクトをインストールするには、次の手順に従います。

1. Visual Studio のダウンロード ページから Visual Studio 2022 プレビュー (17.12 プレビュー 2 以降) をダウンロードしてインストールします。
2. インストール中に、 [個々のコンポーネント] タブを選択し、"SQL" を検索して "SQL Server Data Tools SDK スタイル (プレビュー)" を見つけて選択します。 この項目を選択すると、必要な依存関係が自動的に選択されます。
3. ワークロードや追加機能は選択しないでインストールを続行します。

Visual Studio ドキュメント には、Visual Studio のインストールを変更して個々のコンポーネントを選択する方法に関する追加情報が記載されています。

SDK スタイルの SQL プロジェクトが元の SQL プロジェクトと共存してインストールされており、且つ SDK スタイルの SQL Server Data Tools のインストールがスタンドアロン コンポーネントとして推奨される場合、予期しない動作が発生する可能性があります。 Visual Studio のインストールに含まれるコンポーネントを確認するには、Visual Studio の [ヘルプ] メニューを使用して、[Microsoft Visual Studio について] を選択します。 1 台のコンピューターで複数の Visual Studio インスタンスを利用するには、いくつかの方法があります。

• Visual Studio 2022 や Visual Studio 2022 プレビューなど、Visual Studio のさまざまなリリース チャネルをインストールします。
• Visual Studio Community や Visual Studio Enterprise など、Visual Studio の 異なるエディション をインストールします。
• 以前のバージョンとは別のディレクトリにインストールすることで、Visual Studio のインスタンスを分離します。

制限事項

SQL プロジェクト ツールを使うと、他のツールとの機能の違いを調べることができます。 Visual Studio の SDK スタイルの SQL プロジェクト機能には、次の制限があります。

• 元の SQL プロジェクトと共存してインストールすることはサポートされていません
• SQL プロジェクト ファイルでは、Visual Studio 17.12 プレビュー 2 で.sqlproj の代わりに .sqlprojx という拡張子が使用されるようになりました
• SQLCLR オブジェクトはサポートされていません
• スキーマ比較インターフェイスは利用できません
• テーブル デザイナー インターフェイスは利用できません
• データ比較インターフェイスは利用できません
• データベース単体テストは利用できません

Visual Studio での SDK スタイルの SQL プロジェクトのサポートはプレビュー中です。最新の Visual Studio 2022 プレビュー リリースからのインストールをお勧めします。 Visual Studio の SQL プロジェクト機能は開発中であり、フィードバックは開発者コミュニティを通じて行ってください。

既存のプロジェクトを変換する

Microsoft.Build.Sql SDK スタイルの SQL プロジェクトは、新規作成または既存の SQL プロジェクトから変換して作成できます。 元の SQL プロジェクトを Microsoft.Build.Sql プロジェクトに変換する場合は、変換する前にプロジェクトのバックアップを作成することをお勧めします。 既存の SQL プロジェクトを SDK スタイルのプロジェクトに変換するには、 元の SQL プロジェクトの変換の攻略ガイドの手順を参考にしてください。

関連するコンテンツ

• SQL Database プロジェクト
• Visual Studio 2022 Preview リリース ノート
• VS Code の SQL プロジェクト