クイックスタート: Azure SQL Database のローカル開発環境を作成する

[アーティクル]
08/07/2023

Azure SQL データベースのローカル開発環境により、ローカル Azure SQL データベース Emulatorでデータベーススキーマを設計、編集、ビルドまたは検証、発行、実行する方法が提供されます。データベースプロジェクト機能を使用すると、開発者はローカル環境から Azure SQL データベースパブリックサービスにデータベースプロジェクトを簡単に発行できるほか、データベースのライフサイクル全体を管理できます (スキーマドリフトの管理など)。このクイックスタートでは、Azure SQL データベースローカル開発環境を活用するワークフロー全体について説明します。

前提条件

このクイックスタートを完了するには、まず、Azure SQL Database のローカル開発環境を設定する必要があります。

空のプロジェクトを作成する

作業を開始するには、空のデータベースプロジェクトを作成するか、既存のプロジェクトを開きます。このセクションの手順を使って新しい空のプロジェクトを作成できますが、次のようにすることもできます。

[データベースプロジェクト] ビューに移動するか、コマンドパレットで [データベースプロジェクト: 既存のものを開く] を探して、既存のプロジェクトを開きます。
コマンドパレットまたはデータベースコンテキストメニューで [データベースからのプロジェクトの作成] を選んで、既存のデータベースから始めます。
コマンドパレットの [データベースプロジェクト: OpenAPI/Swagger 仕様から SQL プロジェクトを生成する (プレビュー)] コマンドを使って、OpenAPI/Swagger 仕様から始めます。

Visual Studio Code または Azure Data Studio を使用して新しいプロジェクトを作成する手順は同じです。空のデータベースを作成するには、次の手順に従います。

任意の開発者ツール (Azure Data Studio、または Visual Studio Code) を開きます。
[プロジェクト] を選択し、新しいデータベースプロジェクトの作成を選択します。または、コマンドパレットで [データベースプロジェクト: 新規] を検索します。
プロジェクトの種類として[SQL Database] を選択します。
新しい SQL Database プロジェクトの名前を指定します。
SDK スタイルの SQL Database プロジェクトを選択します。 (SDK スタイルの SQL プロジェクトは、チームのリポジトリで複数の開発者と連携する場合に、より簡潔で管理しやすくするために推奨されます)。
プロジェクトのターゲットプラットフォームを設定するには、[ データベースプロジェクト名] を右クリックし、[ターゲットプラットフォームの変更] を選択します。プロジェクトのターゲットプラットフォームとして [Azure SQL データベース] を選択します。

ターゲットプラットフォームを設定すると、SQL Database プロジェクトのオブジェクトおよびスクリプトの編集とビルド時のサポートが提供されます。ターゲットプラットフォームを選択した後、Visual Studio Code によって構文の問題が強調表示されたり、選択プラットフォームでサポートされていない機能が使用されていることが示されます。

必要に応じて、SQL Database プロジェクトファイルをアプリケーションプロジェクトと共にソース管理下に配置できます。
データベースプロジェクトにオブジェクトを追加します。テーブル、ビュー、ストアドプロシージャ、スクリプトなどのデータベースオブジェクトを作成または変更できます。たとえば、[Database Project name] (データベースプロジェクト名) を右クリックし、[テーブルの追加] を選択してテーブルを追加します。
データベースプロジェクトをビルドして、Azure SQL データベースプラットフォームに対して動作することを検証します。プロジェクトをビルドするには、[Database Project name] (データベースプロジェクト名) を右クリックし、[ビルド] を選択します。
データベースプロジェクトをテストする準備ができたら、ターゲットに発行します。発行プロセスを開始するには、データベースプロジェクトの名前を右クリックし、[発行] を選択します。
発行時に、新規または既存のサーバーのいずれかに発行することを選択できます。この例では、[新しい Azure SQL データベース Emulatorに発行する] を選択します。
新しい Azure SQL データベース Emulatorに発行する場合は、ライト イメージとフルイメージのどちらかを選択するように求められます。 ライト イメージは、ほとんどの Azure SQL Database 機能と互換性があり、ダウンロードとインスタンス化にかかる時間が少ない軽量のイメージです。フルイメージを使用すると、メモリ内最適化テーブル、地理空間データ型などの高度な機能にアクセスできますが、より多くのリソースが必要になります。

使用可能なリソースに基づいて必要な数のローカルインスタンスを作成し、Visual Studio Code Docker 拡張情報または CLI コマンドを使用してライフサイクルを管理できます。
データベースプロジェクトのインスタンスが実行されたら、Visual Studio Code mssql 拡張情報から接続し、Azure SQL データベースの通常のデータベースと同様にスクリプトとクエリをテストできます。
データベースプロジェクトをリビルドし、準備が整うまで、データベースプロジェクト内のオブジェクトを追加または変更する処理を反復することで、ローカルコンピューター上で実行されているコンテナー化されたインスタンスのいずれかにデプロイします。
データベースプロジェクトライフサイクルの最後の手順は、完成した成果物を、mssql 拡張情報を使用して Azure SQL データベースの新規または既存のデータベースに発行することです。 [Database Project name] (データベースプロジェクト名) を右クリックし、[発行] を選択します。次に、Azure の新規または既存の Azure 論理サーバーなど、プロジェクトの発行先を選択します。