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 を使用してデータベース プロジェクトのビルドとデプロイを自動化できます。

概要

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

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

Visual Studio 2026 は SDK スタイルの SQL プロジェクトをサポートしていません。元の SQL プロジェクトは、そのバージョンの Visual Studio で使用できる唯一の SQL プロジェクト形式です。 Visual Studio 2022 は、SQL Server Data Tools の SDK スタイル (プレビュー) コンポーネントに SDK スタイルの SQL プロジェクトを含む Visual Studio の唯一のバージョンです。

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

インストール

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

1. Visual Studio の ダウンロード ページから Visual Studio 2022 (17.12 以降) をダウンロードしてインストールします。

2. インストール中に、 [個々のコンポーネント] タブを選択し、"SQL" を検索して "SQL Server Data Tools SDK スタイル (プレビュー)" を見つけて選択します。 この項目を選択すると、必要な依存関係が自動的に選択されます。

3. [個々のコンポーネント] タブで ".NET SDK" を検索し、".NET SDK" コンポーネントを選択します。 この項目を選択すると、サポートされている .NET ランタイムなど、必要な依存関係が自動的に選択されます。 .NET SDK コンポーネントを使用すると、Visual Studio で Microsoft.Build.Sql SDK の追加バージョンをサポートできます。 これは、NuGet.org を通じて利用できます。

   

4. ワークロードや追加機能は選択しないでインストールを続行します。

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 の.sqlprojxではなく、拡張機能.sqlprojが使用されます。 Visual Studio 17.12 プレビュー 3 以降では、拡張機能は .sqlproj。

• SQLCLR オブジェクトはサポートされていません

• スキーマ比較インターフェイスは利用できません

• テーブル デザイナー インターフェイスは利用できません

• データ比較インターフェイスは利用できません

• データベース単体テストは利用できません

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

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

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

関連するコンテンツ

• SQL データベース プロジェクトとは
• Visual Studio 2022 Preview リリース ノート
• Visual Studio Code の SQL プロジェクト