SQL Server Management Studio の Database DevOps (プレビュー)

SQL データベースプロジェクトは、テーブル、ストアドプロシージャ、関数など、単一データベースのスキーマを構成する SQL オブジェクトをローカルで表現したものです。 SQL データベースプロジェクトの開発サイクルは、データベース開発を、開発のベストプラクティスとして使い慣れた継続的インテグレーションおよび継続的配置 (CI/CD) ワークフローに統合するのに役立ちます。 SSMS では、プレビュー段階の Microsoft.Build.Sql プロジェクトを使用して、データベースオブジェクトのローカル定義を提供することで、データベースの変更を実装、管理、共同作業することができます。

この記事では、SQL Server Management Studio (SSMS) でデータベース DevOps ワークフローの一部として SQL データベースプロジェクトを使用する方法、またはデータベース DevOps ワークフローを固定する方法について説明します。 SQL データベースプロジェクトの詳細については、「 SQL データベースプロジェクト」を参照してください。

前提条件

新しいプロジェクトの作成

SSMS で SQL データベースプロジェクトを操作するには、プロジェクトファイルを含むローカルフォルダーが必要です。プロジェクトを開始するには、既存のデータベースからオブジェクトを抽出するか、新しいオブジェクトファイルを最初から作成します。

注

SSMS では、ソリューションエクスプローラーからファイルを開くときにサーバーに接続するように求められる場合があります。データベースに接続しなくても、オフラインで SQL データベースプロジェクト開発を実行できます。

既存のデータベースからオブジェクトを追加する

SqlPackage を使用して、オブジェクトの種類別に整理された個々の .sql ファイルに既存のデータベースからスキーマを抽出します。次のコマンドを実行して、データベースオブジェクトを含むフォルダー構造を作成します。

sqlpackage /Action:Extract /SourceConnectionString:"<connection-string>" /TargetFile:"<temp-folder>" /p:ExtractTarget=SchemaObjectType

/p:ExtractTarget=SchemaObjectType パラメーターは、スキーマとオブジェクトの種類 (dbo/Tables、dbo/StoredProceduresなど) に基づいて、抽出されたファイルをサブフォルダーに整理します。プロジェクトディレクトリの外部にある一時フォルダーに展開し、エクスプローラーを使用して目的の内容をプロジェクトフォルダーにコピーします。

SqlPackage 抽出オプションの詳細については、「 SqlPackage 抽出」を参照してください。

新しいオブジェクトを作成する

プロジェクトフォルダーに .sql ファイルを作成して、新しいデータベースオブジェクトをプロジェクトに追加します。各ファイルには、1 つのデータベースオブジェクトに対して 1 つの CREATE ステートメントを含める必要があります。たとえば、テーブル定義は次のようになります。

CREATE TABLE [dbo].[Products]
(
    [ProductId] INT NOT NULL PRIMARY KEY,
    [ProductName] NVARCHAR (100) NOT NULL,
    [Price] DECIMAL (10, 2) NOT NULL
);

dbo/TablesやSales/StoredProceduresなどのサブフォルダーを使用して、スキーマとオブジェクトの種類別にファイルを整理します。この構造は、SqlPackage 抽出の出力と一致し、プロジェクトの拡大に合わせてオブジェクトを見つけやすくなります。 SQL プロジェクトのビルドプロセスには、既定でプロジェクトフォルダーとそのサブフォルダー内のすべての .sql ファイルが含まれます。

SSMS には、作業の開始に役立つ一般的な項目のテンプレートが用意されています。新しい項目を追加するには、ソリューションエクスプローラーでプロジェクトを右クリックし、[ 追加>新しい項目] を選択し、SQL オブジェクトテンプレートの一覧から選択します。

既存のプロジェクトを開く

SSMS で既存の SQL データベースプロジェクトを開くには、[ ファイル>開く>プロジェクト/ソリューション ] を選択し、 .sqlproj ファイルに移動します。

Important

SSMS では、SDK スタイルの Microsoft.Build.Sql プロジェクトのみがサポートされます。サポートされている SDK の最小バージョンは 2.1.0 です。 Visual Studio で作成された元の SQL プロジェクトがある場合は、開く前に SDK スタイルの形式に変換する必要があります。

元の SQL プロジェクトを SDK スタイルの形式に変換する方法については、「元の SQL プロジェクトを SDK スタイルのプロジェクトに変換する」を参照してください。

プロジェクトをビルドして変更をデプロイする

SQL プロジェクトワークフローは、スキーマを検証してコンパイルするプロジェクトをビルドし、コンパイルされた出力をターゲットデータベースに配置する 2 つの主要な手順で構成されています。

プロジェクトのビルド

SQL プロジェクトをビルドすると、オブジェクト間の関係が検証され、指定されたターゲットプラットフォームに対して T-SQL 構文がチェックされます。ビルドプロセスでは、データベーススキーマのコンパイル済みモデルを含む .dacpac ファイルが生成されます。

SSMS でプロジェクトをビルドするには、ソリューションエクスプローラーでプロジェクトを右クリックし、[ ビルド] を選択します。

SQL プロジェクトのビルドオプションを示すソリューションエクスプローラーのスクリーンショット。

ビルド出力には、エラーまたは警告が表示されます。エラーは、存在しないテーブルを参照するビューなど、デプロイを妨げる問題を示します。警告では、オブジェクト名の大文字と小文字の区別に一貫性がないなどの潜在的な問題が強調表示されます。

ビルドが正常に完了すると、プロジェクトディレクトリ内の .dacpac フォルダーにbin\Debug ファイルが作成されます。

ビルドの問題のトラブルシューティングの詳細については、「 SQL プロジェクトのビルドエラーのトラブルシューティング」を参照してください。

変更をデプロイする

プロジェクトをビルドしたら、SSMS の [発行] ダイアログを使用して、 .dacpac をターゲットデータベースにデプロイします。配置プロセスは、 .dacpac をターゲットデータベースと比較し、データベースをプロジェクトと同期するために必要な CREATE、 ALTER、または DROP ステートメントを生成します。

配置するには、ソリューションエクスプローラーでプロジェクトを右クリックし、[発行] を選択 します。 [発行] ダイアログで、ターゲットデータベース接続を構成し、[ 発行 ] を選択して変更を適用するか 、スクリプトを生成 して実行前にデプロイスクリプトを確認します。

SQL データベースプロジェクトの変更をデプロイするための [発行] ダイアログのスクリーンショット。

発行プロセスはべき等であるため、問題を発生させずに同じ .dacpac を複数回デプロイできます。この方法では、同じコンパイル済み成果物を使用して、複数の環境 (開発、ステージング、運用) にデプロイできます。

デプロイオプションと構成の詳細については、「 SQL データベースプロジェクトの概要」を参照してください。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-03-18