次の方法で共有


SQL Database Projects 拡張機能を使用したテーブルへの変更のビルドと配置

適用対象: SQL Server Azure SQL データベース Azure SQL Managed Instance

SQL Database Projects 拡張機能を使うと、Azure Data Studio でサーバー インスタンスに接続しなくても、SQL プロジェクト (テーブル、ビュー、ストアド プロシージャなど) を編集できます。 下記のチュートリアルでは、次の操作方法について説明します。

  1. AdventureWorks2022 データベースの SQL データベース プロジェクトを作成します。

  2. SQL Database Project を使用して AdventureWorks2022 データベース内のテーブルに変更を加えて配置し、このデータベースが存在するローカル接続サーバー インスタンスでこの変更を確認します。

この記事には AdventureWorks2022 サンプル データベースが必要です。このサンプル データベースは、Microsoft SQL Server サンプルとコミュニティ プロジェクトのホーム ページからダウンロードできます。

また、SQL Database Project 拡張機能をインストールする必要もあります。 この拡張機能の詳細については、SQL Database Project のドキュメントを参照してください。

SQL Database Project の作成

  1. オブジェクト エクスプローラーにある AdventureWorks2022 データベース オブジェクトに移動し、それを右クリックして [データベースからプロジェクトを作成] を選択します。

    データベース オブジェクトからプロジェクトを作成する方法を示す Azure Data Studio のオブジェクト エクスプローラーのスクリーンショット。

  2. ターゲット プロジェクトを保存する場所を選択し、プロジェクトを含むファイルに希望する名前を付けます。 また、フォルダー構造 の設定を、ドロップダウンで指定されたオプションのいずれかに構成することもできます。 このチュートリアルでは、Schema/Object 型フォルダー構造を使用します。 完了したら、 [作成] を選択します。 このプロジェクトが抽出されると、"プロジェクト ファイルの抽出に成功しました" というメッセージが表示されます。

  3. Azure Data Studio のサイドバー メニューで、[データベース プロジェクト] アイコンを選択し、SQL Database Project 拡張機能を開きます。 作成したデータベース プロジェクト フォルダーに移動します。 次に、このプロジェクトの Person スキーマ フォルダーで、Tables フォルダーに移動し、このフォルダーのドロップダウンを展開します。 デザイナー モードでテーブルを右クリックして開き、このテーブルのテーブル デザインを開きます。 この例では、Person.sql テーブルで作業を行います。

    SQL Database Project 拡張機能を使用してオフライン モードでテーブルを開く方法を示す Azure Data Studio のスクリーンショット。

    Note

    プロジェクト ファイルの場所は、上記の手順 2 で定義されているフォルダー構造によって異なる場合があることにご注意ください。

プロジェクトからデータベースに変更を配置する

  1. 元のテーブルは、BusinessEntityID から始まり ModifiedDate で終わる 13 個の列名を持つ Person テーブルのテーブルデザインを示しています。 型 nvarchar(50) の Citizenship という名前の別の列を追加し、この変更を発行します。SQL Database Project の変更を発行する方法を示す Azure Data Studio のスクリーンショット。

  2. データベース プロジェクトのファイル メニューから、プロジェクトが存在するプロジェクト ルート ノードを右クリックし、[ビルド] を選択してこのプロジェクトをビルドします。 ビルドが成功または失敗した場合は、出力ターミナルに成功またはエラー メッセージが表示されます。 完了したら、この同じフォルダーを右クリックし、[発行] を選択して、ローカル ホスト サーバー接続の AdventureWorks2022 データベースにこのプロジェクトを発行します。

    SQL Database Project の変更をビルドして発行する方法を示す Azure Data Studio のスクリーンショット。

    Note

    この手順では、ローカル ホストに接続する必要があることにご注意ください。 これを行うには、[プロジェクトの発行] ダイアログ ボックスのプラグ アイコンをクリックします。

  3. SQL Database Project ビューを終了します。 次に、サーバー接続のオブジェクト エクスプローラーに移動し、AdventureWorks2022 データベースの Tables フォルダーに移動します。 変更したテーブルのテーブル デザインを開き、加えた変更を確認します。 今回は、Person.Person テーブルに新しい列 Citizenship を追加しました。

    ローカル ホスト接続のテーブルに加えられた変更を示す Azure Data Studio のスクリーンショット。

次の手順