你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

使用 Azure SQL 数据库 容器构建

适用于:Azure SQL 数据库

在本快速入门中,您将开始使用 Azure SQL 数据库 容器,创建本地数据库,并运行您的第一个查询。 然后,使用 Azure SQL Dev Hub 构建一个包含示例、提示和 AI 编码代理技能的应用。

Note

Azure SQL 数据库容器为公共预览版。

什么是 Azure SQL 数据库 容器?

容器将数据库引擎打包起来,这样你就可以在自己的计算机上通过容器运行时运行它。 Azure SQL 数据库 容器运行的是 Azure SQL 数据库 引擎,而不是 SQL Server 容器镜像。 您的应用程序连接到本地地址,例如 localhost,1433,而不是 Azure 中的数据库。

使用容器学习 T-SQL、开发应用程序、测试架构变更或运行持续集成(CI)测试。 你还可以探索原生向量、矢量搜索以及用于 AI 应用的 JSON。 它与您用于 Azure SQL 数据库 的驱动程序和对象关系映射器(ORM)配合使用。

该容器免费供本地开发和测试使用。 你不需要 Azure 订阅或信用卡就能在本地运行它。

Important

容器用于开发、测试、CI 和演示,而非生产环境。 它不提供 Azure 托管的服务,如自动备份、高可用性或弹性池。 对于生产环境,将数据库和应用部署到 Azure 服务,而非本地容器。

有关详细信息,请参阅《什么是 Azure SQL 数据库 容器?》。

Prerequisites

  • 已安装并正在运行 Linux 容器的容器运行时。 请选择 Docker、Podman、WSL 容器,或如下一节所述的 Apple 的 container 工具。
  • 一台受支持的 x64 或 ARM64 计算机,运行 macOS、Linux 或 Windows,并运行 适用于 Linux 的 Windows 子系统 2(WSL2)。 该镜像提供原生 linux/amd64 和 linux/arm64 变体。
  • 至少两个 CPU 核心,容器运行时可用的 4 GB 内存,以及用于镜像和小型数据库的 10 GB 可用磁盘空间。
  • 用于初始图像下载的互联网访问。 本地查询之后可以离线运行;外部服务仍然需要连接。
  • 可用的主机端口,例如 1433,以及唯一的容器名称。 本示例使用 sqldb。 如果其他名称或主机端口已被占用,请选择其他名称或主机端口。

查看容器先决条件,了解当前平台和运行时要求。

选择容器运行时

使用适合你操作系统的运行时。 这些示例使用了您的主机架构的原生镜像;它们不配置仿真。

Runtime Setup
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,并使用相同的镜像引用。

启动容器

用唯一且强的密码替换 sa,用于 <your-strong-password> 身份验证。 至少使用八个字符,其中至少包含以下三个组的字符:大写字母、小写字母、数字和符号。 避免密码进入源代码控制和共享终端输出。 密码也在容器配置中可见。

选择你的运行时,然后运行其命令。 设置 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;"

将 docker 替换为 podman、wslc(或在 WSL 中使用 wslc.exe)或 container。 在引擎启动时重试。 成功输出包括 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 数据库 容器和 SQL Server 容器本地构建”,或连接并查询 Azure SQL 数据库 容器 |Microsoft Learn for SSMS。

创建一个数据库并运行查询

使用 SQL 客户端,例如随容器捆绑的 sqlcmd 实用程序,或使用编辑器的查询窗口。 例如,请使用以下命令打开交互式 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。 不要用 USE 在 Azure SQL 数据库 用户数据库会话中切换数据库。

    对于此步骤之前的交互式命令,退出 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 数据库 引擎上的用户数据库。 如果版本不同,请检查您启动的是 Azure SQL 数据库 镜像,而不是 SQL Server 镜像。

您现在拥有用于应用程序开发的本地数据库。 在您的应用程序的 连接字符串 中使用相同的数据库名称。

使用 Azure SQL Dev Hub 构建

访问 Azure SQL Dev Hub,选择应用场景,并开始学习提示、示例和代理技能。 你可以构建任务跟踪应用、创建 API,或探索向量搜索,以实现检索增强生成(RAG)应用。

某些开发中心提示,例如 JavaScript 应用提示,针对云数据库,并要求 Microsoft Entra 身份验证。 在本地运行提示符之前,请根据您的容器服务器、映射端口、数据库名称和身份验证方式调整其指令和连接配置。 如果您使用安装指南的默认 SQL 身份验证路径,请用已配置的 SQL 凭据替换仅限云的身份验证要求,将凭据置于源代码控制之外,并且仅信任本地容器连接的自签名证书。 在运行生成的 SQL、权限和架构更改之前,请检查它们。

当您准备迁移到 Azure 时,请在 Azure SQL 数据库 中创建一个数据库,部署架构和数据,并更新应用程序的连接配置。 云资源需要 Azure 订阅。 Azure SQL 数据库 免费套餐是一个独立的云选项,有自己的允许和限制。

部署前,先在 Azure 中测试 Azure SQL 数据库。 预览限制、默认设置和功能支持可能与云服务不同。 查看已知限制。

清理资源

完成后,用运行时或开发工具停止容器。

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

此快速启动中的运行命令不配置持久存储。 移除容器可能会删除其数据库文件,因此请先保留所需的任何数据。 如果您单独配置数据卷,仅在打算删除其数据时才将其移除。