Azure SQL Databaseコンテナで構築する

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

このクイックスタートでは、Azure SQL Database コンテナから始め、ローカルデータベースを作成し、最初のクエリを実行します。 次に、Azure SQL Dev Hubを使ってサンプルやプロンプト、AIコーディングエージェントのスキルを活かしたアプリケーションを構築します。

Note

Azure SQL Database コンテナーはパブリック プレビュー段階です。

Azure SQL Database コンテナとは何ですか?

コンテナはデータベースエンジンをパッケージ化し、コンピュータ上でコンテナランタイムで実行できるようにします。 Azure SQL Database コンテナは SQL Server コンテナイメージではなく Azure SQL Database エンジンを実行します。 アプリケーションはAzureのデータベースではなく、localhost,1433などのローカルアドレスに接続します。

コンテナを使用してT-SQLの学習、アプリケーション開発、スキーマ変更のテスト、継続的インテグレーション(CI)テストの実行などが可能です。 また、AIアプリケーション向けのネイティブベクター、ベクター検索、JSONも探索できます。 これは、Azure SQL Database で使用しているドライバーやオブジェクトリレーショナルマッパー(ORM)と連携します。

このコンテナはローカル開発とテストに無償で提供されます。 ローカルで運用するのにAzureのサブスクリプションやクレジットカードは必要ありません。

Important

コンテナは開発、テスト、CI、デモ用であって、本番用ではありません。 自動バックアップ、高可用性、エラスティックプールなどのAzure管理サービスは提供していません。 本環境では、データベースとアプリケーションをローカルコンテナではなく Azure サービスに展開してください。

詳細については、「Azure SQL Database コンテナとは何か?」を参照してください。

Prerequisites

  • インストールされており、Linux コンテナを実行しているコンテナランタイム。 次のセクションで説明する Docker、Podman、WSL コンテナ、または Apple の container ツールを選択してください。
  • Linux 用 Windows サブシステム 2(WSL2)を備えた、macOS、Linux、またはWindowsで動作する対応x64またはARM64コンピューター。 画像はネイティブ linux/amd64 および linux/arm64 バリアントを提供しています。
  • 少なくとも2つのCPUコア、コンテナランタイムに利用可能な4 GBのメモリ、およびイメージと小規模データベース用の10GBの空きディスク容量。
  • 初回画像ダウンロードのためのインターネットアクセス。 ローカルクエリはその後オフラインで実行可能です。外部サービスは依然として接続性を必要とします。
  • 利用可能なホストポート(例: 1433)と、固有のコンテナ名。 この例では sqldb を使用します。 いずれかがすでに使用されている場合は、別の名前またはホストポートを選択してください。

現在のプラットフォームおよびランタイムの要件に対応する コンテナの前提条件 を確認してください。

コンテナランタイムを選択する

あなたのオペレーティングシステムに合った実行時を使用してください。 これらの例はホストアーキテクチャ用のネイティブイメージを使用しています。エミュレーションの設定は行いません。

ランタイム 段取り
Docker Docker Desktop または Docker Engine をインストールし、Linux コンテナサポートで動作していることを確認してください。
Podman Podmanをインストールしてください。 macOSやWindowsでは、必要に応じてPodmanマシンを初期化し、podman machine startで起動してください。
WSL コンテナー WSLをインストールまたは更新して、wslc.exeが利用可能になるようにします。 Windowsホスト上でPowerShellからwslcを実行します。 WSLディストリビューション内のBashからは、wslc.exeを使用します。WSLの相互運用性が有効で、wslc.exe が PATH に通っている必要があります。 公開されたポートは Windows ホスト上にあります。
Apple container macOS 26 を搭載した Apple Silicon Mac に Apple のコンテナツール をインストールします。 container system startでサービスを開始します。

containerd と nerdctl を使用したものや Rancher Desktop など、他の OCI 互換ランタイムもイメージを実行できます。 コマンドや設定については、ランタイムのドキュメントを活用してください。

パブリックプレビュー画像を取得する

パブリックプレビュー画像参照は mcr.microsoft.com/mssql/azure-sql-db-server:latestです。 Microsoft Artifact Registry リストから画像情報を取得します。 パブリック画像には、プライベートプレビューレジストリアカウントやレジストリサインインは必要ありません。

以下のコマンドは、ローカルにキャッシュされていないイメージを自動的にダウンロードします。 Dockerで個別にダウンロードするには、以下を実行します:

docker pull mcr.microsoft.com/mssql/azure-sql-db-server:latest

Podman、WSLコンテナ、またはAppleコンテナでは、それぞれ同じ画像参照で podman pull、 wslc pull、または container image pullを使用します。

コンテナーを起動する

<your-strong-password>をsa認証用の一意で強力なパスワードに置き換えてください。 これらのグループのうち少なくとも3つのグループ(大文字、小文字、数字、記号)の文字を含め、最低8文字を使用してください。 パスワードはソース管理や共有ターミナル出力から遠ざけましょう。 パスワードはコンテナ設定にも表示されます。

ランタイムを選択し、そのコマンドを実行します。 ACCEPT_EULA=Y を設定すると、イメージのライセンス条項に同意したものとみなされます。 各例はコンテナに2 GiBのメモリと2つのCPUを割り当て、ホストのループバックアドレスにデータベースポート 1433 を公開します。

docker run --name sqldb --memory 2g --cpus 2 -e ACCEPT_EULA=Y -e "MSSQL_SA_PASSWORD=<your-strong-password>" -p 127.0.0.1:1433:1433 -d mcr.microsoft.com/mssql/azure-sql-db-server:latest

稼働中のコンテナは必ずしもデータベースエンジンが準備万端であることを意味するわけではありません。 コンテナに付属している sqlcmd ユーティリティを使用して、SQL 接続が正常かどうかを確認します。

docker exec sqldb /opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P "<your-strong-password>" -C -b -l 5 -t 5 -Q "SELECT @@VERSION;"

dockerをpodman、wslc(またはWSL内ではwslc.exe)、またはcontainerに置き換えてください(ランタイムに応じて)。 エンジンが始動している間に再試行してください。 成功した成果には Microsoft SQL Azureが含まれます。 -bオプションはSQLエラーのエラー終了コードを返します。-l 5と-t 5はログイン待ち時間とクエリ待ち時間をそれぞれ5秒に制限します。 -C このローカル接続に対してコンテナの自己署名証明書を信頼します。ローカル開発以外で適切な証明書検証を行うこと。

このチェックは公開されたホストポートを経由せず、コンテナ内から接続します。 エディターやアプリケーションから接続するには、サーバー 127.0.0.1,1433、SQL 認証、ログイン sa、設定したパスワードを使用してください。 ホストのマッピングを変更した場合はポートを調整してください。

SQL が接続を受け入れない場合は、 docker logs --tail 80 sqldb、 podman logs --tail 80 sqldb、 wslc logs --tail 80 sqldb、または container logs -n 80 sqldb でログを確認してください。 再試行する前にパスワードポリシーと利用可能なリソースを確認してください。

グラフィカルなセットアップ体験を好みたい場合は、Visual Studio Code 用 MSSQL 拡張機能の Azure SQL Database コンテナと SQL Server コンテナでローカルビルドを行ってください。 Azure SQL Database コンテナ (プレビュー)ではなく、SQL Server コンテナを選択してください。

データベースを作成しクエリを実行します

コンテナにバンドルされている sqlcmd ユーティリティや、エディターのクエリウィンドウなどの SQL クライアントを使用してください。 例えば、次のコマンドでインタラクティブ master 接続を開き、 docker を実行時のCLIに置き換え、設定したパスワードを使用します。

docker exec -it sqldb /opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P "<your-strong-password>" -C -b -d master

インタラクティブ sqlcmd セッションでは、SQL ステートメントやクエリの各行の後に新しい行に GO を入力して実行します。 セッションを閉じるには EXIT を入力します。

  1. 設定した認証情報でローカルコンテナの master データベースに接続し、次を実行します:

    CREATE DATABASE appdb;
    

    名前 appdb は例です。別のデータベース名を選択できます。 セットアップツールがすでにユーザーデータベースを作成している場合は、そのデータベースを使用し、このステップをスキップしてください。

  2. appdb に直接新しい接続を開きます。 クライアントの接続設定、または-d appdb内のsqlcmdでデータベースを指定してください。 Azure SQL Databaseユーザーデータベースセッションでデータベースを切り替えるためにUSEを使用しないでください。

    このステップの前のインタラクティブコマンドについては、masterセッションを終了し、-d masterの代わりに-d appdbでコマンドを再度実行します。

  3. appdb接続でこのクエリを実行します:

    SELECT
        DB_NAME() AS current_database,
        SERVERPROPERTY('EngineEdition') AS engine_edition,
        SERVERPROPERTY('Edition') AS edition,
        1 AS connected;
    

    current_database は appdb、engine_edition は 5、edition は SQL Azure、connected は 1 であることを期待してください。 これらの値は、Azure SQL Database エンジン上のユーザーデータベースに接続したことを示します。 エディションが異なる場合は、SQL Server イメージではなく Azure SQL Database イメージを起動したか確認してください。

これでアプリケーション開発のためのローカルデータベースが手に入ります。 アプリケーションの 接続文字列 に同じデータベース名を使用してください。

Azure SQL Dev Hubでビルド

Azure SQL Dev Hub にアクセスしてアプリケーションシナリオを選択し、プロンプト、サンプル、エージェントスキルの活用を始めてください。 タスク追跡アプリを構築したり、APIを作成したり、検索拡張生成 (RAG) アプリケーション向けのベクター検索を試したりできます。

JavaScript アプリのプロンプトなど、一部の Dev Hub プロンプトはクラウドデータベースを対象とし、Microsoft Entra 認証が必要です。 プロンプトをローカルで実行する前に、その命令と接続設定の両方を、コンテナのサーバー、マップされたポート、データベース名、および認証方法に合わせて調整してください。 セットアップガイドの既定の SQL 認証パスを使用する場合は、クラウド専用の認証要件を構成済みの SQL 認証情報に置き換え、認証情報をソース制御から外し、自己署名証明書はローカルコンテナ接続のみに信頼してください。 実行前に生成された SQL、権限、およびスキーマの変更をレビューしてください。

Azure への移行準備ができたら、Azure SQL Database でデータベースを作成し、スキーマとデータを展開し、アプリケーションの接続構成を更新してください。 クラウドリソースには Azure サブスクリプションが必要です。 Azure SQL Database 無料プランは、独自の許容枠と制限を持つ別のクラウドオプションです。

展開前に、Azure 内の Azure SQL Database をテストしてください。 プレビューの制限、デフォルト設定、機能サポートはクラウドサービスと異なる場合があります。 既知の制限を確認してください。

リソースをクリーンアップする

終了したら、ランタイムツールまたは開発ツールでコンテナを停止します。

ランタイム コンテナを停止する 停止したコンテナを削除します
Docker docker stop sqldb docker rm sqldb
Podman podman stop sqldb podman rm sqldb
WSL コンテナー wslc stop sqldb wslc rm sqldb
アップルコンテナ container stop sqldb container delete sqldb

このクイックスタートの実行コマンドは永続ストレージの設定を行いません。 コンテナを削除するとデータベースファイルが削除されるので、必要なデータはまず保存してください。 データボリュームを別途構成する場合は、そのデータを削除する予定がある場合のみ削除してください。