適用対象: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 を入力します。
設定した認証情報でローカルコンテナの
masterデータベースに接続し、次を実行します:CREATE DATABASE appdb;名前
appdbは例です。別のデータベース名を選択できます。 セットアップツールがすでにユーザーデータベースを作成している場合は、そのデータベースを使用し、このステップをスキップしてください。appdbに直接新しい接続を開きます。 クライアントの接続設定、または-d appdb内のsqlcmdでデータベースを指定してください。 Azure SQL Databaseユーザーデータベースセッションでデータベースを切り替えるためにUSEを使用しないでください。このステップの前のインタラクティブコマンドについては、
masterセッションを終了し、-d masterの代わりに-d appdbでコマンドを再度実行します。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 |
このクイックスタートの実行コマンドは永続ストレージの設定を行いません。 コンテナを削除するとデータベースファイルが削除されるので、必要なデータはまず保存してください。 データボリュームを別途構成する場合は、そのデータを削除する予定がある場合のみ削除してください。