SQL Database Projects 拡張機能を始めるためのガイド

Important

Azure Data Studio は、2026 年 2 月 28 日に廃止されます。 Visual Studio Codeを使用することをお勧めします。 Visual Studio Code への移行の詳細については、「Azure Data Studio の概要」を参照してください。

この記事では、SQL Database Projects 拡張機能の使用を開始する 3 つの方法について説明します。

1. [データベース プロジェクト ] ビューに移動するか、コマンド パレットで [ データベース プロジェクト : 新規] を検索して、新 しいデータベース プロジェクト を作成します。

2. 既存のデータベース プロジェクト は、[ データベース プロジェクト] を使用して開くことができます。コマンド パレットで既存のものを開きます。

3. [データベースプロジェクト]: コマンド パレットから[データベースからプロジェクトを作成]を使用するか、[接続]ビューで[データベースからプロジェクトを作成]を選択して、既存のデータベースから開始します。

   

SQL プロジェクトを作成または開いたら、SQL プロジェクトで開発を開始する準備が整います。 次のようなアクションを実行できます。

• テーブルまたはその他のデータベース オブジェクトを編集する
• プロジェクトのビルドとデプロイ
• スキーマ比較を使用して変更を視覚化する
• データベースに加えられた変更からプロジェクトを更新する

SQL プロジェクトの概念とその他のチュートリアルの詳細については、「SQL データベース プロジェクトとは」を参照してください。

空のデータベース プロジェクトを作成する

[ データベース プロジェクト] ビューで、[ 新しいプロジェクト ] ボタンを選択し、表示されるテキスト入力にプロジェクト名を入力します。 表示される [フォルダーの選択] ダイアログで、プロジェクトのフォルダー、 .sqlproj ファイル、およびその他のコンテンツのディレクトリを選択します。 空のプロジェクトが開き、[ データベース プロジェクト] ビューで編集用に表示されます。

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

[ データベース プロジェクト] ビューで、[ プロジェクトを開く ] ボタンを選択し、表示されるファイル ピッカーから既存の .sqlproj ファイルを開きます。 既存のプロジェクトは、Azure Data Studio、Visual Studio Code、または Visual Studio SQL Server Data Tools から作成できます。

既存のプロジェクトが開き、その内容が編集用の [データベース プロジェクト] ビューに表示されます。

既存のデータベースからデータベース プロジェクトを作成する

空のプロジェクトから開始する代わりに、SQL Database プロジェクトにデータベースの既存のオブジェクトをすばやく設定できます。

オブジェクト エクスプローラーで

[ 接続 ] ビューで、抽出するデータベースを含む SQL インスタンスに接続します。 データベースを右クリックし、コンテキスト メニュー から [データベース] から [プロジェクトの作成 ] を選択します。

フォルダー構造の設定は既定で [スキーマ/オブジェクトの種類] に設定され、スクリプト化されるときに既存のオブジェクトを自動的に整理するさまざまな方法が提供されます。フォルダー構造設定のオプションは次のとおりです。

• ファイル: すべてのオブジェクトに対して 1 つのファイルが作成されます
• フラット: 個々のファイル内のすべてのオブジェクトに対して 1 つのフォルダーが作成されます
• オブジェクトの種類: オブジェクトの種類ごとにフォルダーが作成され、各オブジェクトがファイルにスクリプト化されます
• スキーマ: スキーマごとにフォルダーが作成され、各オブジェクトがファイルにスクリプト化されます
• スキーマ/オブジェクトの種類: フォルダーはスキーマごとに作成され、フォルダー内にはオブジェクトの種類ごとに作成され、各オブジェクトはファイルにスクリプト化されます

[データベース プロジェクト] ビュー

[プロジェクト] ビューで、[データベースからプロジェクトをインポート] ボタンを選択し、SQL インスタンスに接続します。 接続が確立されたら、使用可能なデータベースの一覧からデータベースを選択し、プロジェクトの名前を設定します。

最後に、抽出のフォルダー構造を選択します。 新しいプロジェクトが開き、選択したデータベースの内容の SQL スクリプトが含まれます。

その他のアクション

ビルドと公開

データベース プロジェクトの配置は、SQL Database Projects 拡張機能で、 プロジェクトをデータ層アプリケーション ファイル (dacpac) にビルドし、サポートされているプラットフォームに発行することで実現されます。 [ データベース プロジェクト] ビューで、プロジェクトを右クリックし、[ ビルド ] を選択して dacpac ファイルを作成し、SQL プロジェクトを検証します。 プロジェクトをデータベースに配置する準備ができたら、もう一度プロジェクトを右クリックし、[ 発行 ] を選択して dacpac をデータベースに発行します。

このプロセスの詳細については、 SQL プロジェクトの作成とデプロイに関するチュートリアルを参照してください。

スキーマ比較

SQL Database Projects 拡張機能は スキーマ比較と対話するため、プロジェクトの内容を dacpac、既存のデータベース、または別のプロジェクトと比較できます。 結果のスキーマ比較を使用して、ソースとターゲットの違いを表示および適用できます。

スキーマ比較と SQL プロジェクトの詳細については、SQL プロジェクトのスキーマ比較に関する 記事を参照してください。

データベースからプロジェクトを更新する

SQL プロジェクトに対してまだ行われていないデータベースに変更が加えられた場合は、データベースの状態から SQL プロジェクトを更新できます。 この更新は、[接続] ビューのデータベースのコンテキスト メニューまたは [データベース プロジェクト] ビューの SQL プロジェクトのコンテキスト メニューから [データベースからプロジェクトを更新] を選択することによって行われます。 データベースの変更を伴う SQL プロジェクトを最新の状態に保つことは、データベース変更のソース管理の 1 つの方法です。

関連コンテンツ

• SQL データベース プロジェクトとは
• GitHub sql-action を使用してプロジェクトを発行する
• SQL Database Projects 拡張機能に関するヘルプを表示する