使用 Azure SQL Database 容器建置

適用於:Azure SQL Database

在這個快速入門中,你會先使用 Azure SQL Database 容器,建立本機資料庫,並執行你的第一個查詢。 接著,使用 Azure SQL Dev Hub 建立一個包含範例、提示和 AI 編碼代理技能的應用程式。

Note

Azure SQL Database 容器目前處於公開預覽階段。

什麼是 Azure SQL Database 容器?

容器會打包資料庫引擎,讓你能在電腦上搭配容器執行時執行它。 Azure SQL Database 容器執行的是 Azure SQL Database 引擎,而非 SQL Server 容器映像。 您的應用程式會連接到本機位址,例如 localhost,1433,而不是 Azure 中的資料庫。

使用此容器學習 T-SQL、開發應用程式、測試架構變更,或執行持續整合(CI)測試。 你也可以探索原生向量、向量搜尋,以及用於 AI 應用的 JSON。 它可搭配您用於 Azure SQL Database 的驅動程式與物件關聯映射器(ORM)運作。

該容器免費供本地開發與測試使用。 你不需要 Azure 訂用帳戶或信用卡就能在本地運行。

Important

容器是用於開發、測試、CI 和 demo,而非生產環境。 它不提供 Azure 管理的服務,例如自動備份、高可用性或彈性池。 在正式環境中,請將您的資料庫和應用程式部署至 Azure 服務,而非本機容器。

欲了解更多資訊,請參閱「什麼是 Azure SQL Database 容器?」。

Prerequisites

  • 一個安裝並執行 Linux 容器的容器執行環境。 請選擇 Docker、Podman、WSL 容器,或是下一節所述的 Apple 的 container 工具。
  • 支援的 x64 或 ARM64 電腦,運行 macOS、Linux 或 Windows,並搭載 Windows 子系統 Linux 版 2(WSL2)。 映像提供原生 linux/amd64 與 linux/arm64 變體。
  • 至少需兩個 CPU 核心,容器執行時需有 4 GB 記憶體可用,以及 10 GB 可用磁碟空間用於映像檔與小型資料庫。
  • 初始影像下載需要網際網路存取。 本地查詢之後可以離線執行;外部服務仍需連線。
  • 可用的主機埠,例如 1433,以及唯一的容器名稱。 範例會使用 sqldb。 如果其中一者已在使用中,請選擇其他名稱或主機埠。

請參閱容器先決條件,以瞭解目前平台與執行環境需求。

選擇容器執行環境

使用適合你作業系統的執行環境。 這些範例使用主機架構的原生映像檔;它們不會設定模擬。

Runtime 設定
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 啟動其服務。

其他相容 OCI 的執行環境,例如搭配 nerdctl 的 containerd 或 Rancher Desktop,也能執行該映像檔。 請使用執行環境的文件來了解其指令與設定。

取得公開預覽影像

公開預覽影像參考為 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。 至少使用八個字元,且至少包含以下三個群組的字元:大寫字母、小寫字母、數字和符號。 避免密碼進入版本控制和共享終端輸出。 密碼也可在容器設定中顯示。

選擇您的執行環境,然後執行其指令。 設定 ACCEPT_EULA=Y 以接受該影像的授權條款。 每個範例為容器分配 2 GiB 記憶體與兩顆 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;"

請將 podman 替換為 wslc.exe、container(或在 WSL 內使用 docker),作為您的 wslc。 在引擎啟動期間重試。 成功的輸出包括 Microsoft SQL Azure。 此 -b 選項會回傳 SQL 錯誤的錯誤退出碼; -l 5 並將 -t 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 容器 | Microsoft Learn(適用於 SSMS)。

建立資料庫並執行查詢

使用 SQL 用戶端,例如隨容器附帶的工具 sqlcmd ,或使用編輯器的查詢視窗。 例如,請使用以下指令開啟互動 master 式連線,並以您執行環境的 CLI 取代 docker ,並使用您已設定的密碼:

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

在互動 sqlcmd 式工作階段中,請在每個 SQL 語句或查詢後加一行 Enter GO 來執行。 輸入 EXIT 鍵以關閉工作階段。

  1. 使用您設定的認證連線至本機容器的 master 資料庫,並執行:

    CREATE DATABASE appdb;
    

    名稱 appdb 為範例;您可以選擇不同的資料庫名稱。 如果您的設定工具已經建立使用者資料庫,請使用該資料庫並跳過此步驟。

  2. 直接開啟一個新的連線到 appdb。 請在用戶端連線設定中指定資料庫,或在 -d appdb 中使用 sqlcmd 指定資料庫。 請勿用USE來在 Azure SQL Database 使用者資料庫會話中切換資料庫。

    對於此步驟前的互動式指令,請退出 master 工作階段,然後再次以 -d appdb 而非 -d master 執行該指令。

  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 引擎上的使用者資料庫。 如果版本不同,請檢查您是否啟動的是 Azure SQL Database 映像檔,而非 SQL Server 映像檔。

您現在擁有一個用於應用程式開發的本地資料庫。 請在您的應用程式的 連接字串 中使用相同的資料庫名稱。

使用 Azure SQL Dev Hub 建置

請造訪 Azure SQL Dev Hub,選擇應用情境,並開始使用提示、範例及代理程式技能。 你可以打造任務追蹤應用程式、建立 API,或探索向量搜尋,以打造一個檢索增強生成(RAG)應用程式。

部分 Dev Hub 提示,例如 JavaScript 應用程式提示,會針對雲端資料庫,並要求 Microsoft Entra 驗證。 在本地執行提示字元前,請將指令與連線設定調整至容器的伺服器、對應連接埠、資料庫名稱及驗證方式。 如果您使用設定指南的預設 SQL 驗證路徑,請以您已設定的 SQL 認證資料取代僅限雲端的驗證需求,將認證資料置於原始碼控制之外,並且只信任本地容器連線時的自簽憑證。 在執行產生的 SQL、權限及結構描述變更前,請先檢視。

當您準備搬遷至 Azure 時,請在 Azure SQL Database 中建立資料庫,部署架構與資料,並更新應用程式的連線設定。 雲端資源需要 Azure 訂閱。 Azure SQL Database 免費方案是獨立的雲端選項,擁有其專屬的使用額度與限制。

部署前,先在 Azure 中測試 Azure SQL Database。 預覽限制、預設值及功能支援可能與雲端服務有所不同。 檢視已知的限制。

清理資源

完成後,請用執行階段或開發工具停止容器。

Runtime 停止容器 移除已停止的容器
Docker docker stop sqldb docker rm sqldb
Podman podman stop sqldb podman rm sqldb
WSL 容器 wslc stop sqldb wslc rm sqldb
Apple 容器 container stop sqldb container delete sqldb

此快速入門中的執行指令不會設定持久儲存。 移除容器可能會刪除其資料庫檔案,因此請先保留所需的資料。 如果您另外設定資料卷,請僅在打算刪除其資料時將其移除。