Azure SQL Edge Docker镜像文档

标签列表

• azure-sql-edge:latest
  拉取命令：docker pull mcr.microsoft.com/azure-sql-edge:latest

关于本镜像

Microsoft Azure SQL Edge的***容器镜像，适用于Docker引擎。

如何使用本镜像

启动Azure SQL Edge实例（最新版本）

[!注意] 若在Windows上使用PowerShell运行以下命令，请使用双引号代替单引号。

bash
docker run --cap-add SYS_PTRACE -e 'ACCEPT_EULA=1' -e 'MSSQL_SA_PASSWORD=yourStrong(!)Password' -p 1433:1433 --name azuresqledge -d mcr.microsoft.com/azure-sql-edge

启动Premium版本的Azure SQL Edge实例

bash
docker run --cap-add SYS_PTRACE -e 'ACCEPT_EULA=1' -e 'MSSQL_SA_PASSWORD=yourStrong(!)Password' -e 'MSSQL_PID=Premium' -p 1433:1433 --name azuresqledge -d mcr.microsoft.com/azure-sql-edge

连接到Azure SQL Edge实例

可通过容器内的sqlcmd工具连接到Azure SQL Edge实例，在主机上执行以下命令：

[!注意] ARM64版本的SQL Edge容器中不包含sqlcmd工具。

bash
docker exec -it <container_id|container_name> /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P <your_password>

也可通过entrypoint.sh脚本执行数据库创建、登录名配置、数据库附加、数据导入等初始化任务。示例可参考：使用entrypoint.sh创建数据库和架构并导入数据。

还可使用主机或远程计算机上的命令行工具或GUI工具连接，详情参见Azure SQL Edge文档中的连接和查询章节。

配置说明

系统要求

• Docker Engine 1.8+，支持***支持的平台
• 至少1GB内存。若运行在Docker for Mac或Windows，需为Docker虚拟机分配足够内存
• 必须设置以下环境变量：
  • ACCEPT_EULA=Y
  • MSSQL_SA_PASSWORD=<your_strong_password>
  • MSSQL_PID=<edition_name>（默认：Developer）
• 系统管理员（SA）密码要求：至少8个字符，包含大写字母、小写字母、数字和/或非字母数字符号中的至少三类。

环境变量

可通过环境变量或mssql.conf文件配置Azure SQL Edge容器。

• ACCEPT_EULA：确认接受最终用户许可条款。Azure SQL Edge Developer版EULA参见此处，Premium版EULA参见此处。
• MSSQL_SA_PASSWORD：容器运行后用于连接Azure SQL Edge的数据库系统管理员（用户ID：'sa'）密码。密码需满足复杂度要求（至少8个字符，包含大写字母、小写字母、数字和/或非字母数字符号中的至少三类）。
• MSSQL_PID：容器运行的版本，可选值：
  • Developer：开发版（默认，未指定时使用）
  • Premium：高级版

相关仓库

Linux版SQL Server命令行工具：microsoft/mssql-tools

完整标签列表

可通过以下链接获取azure-sql-edge的所有可用标签：[***]

说明：GA（General Availability）表示版本已正式发布并提供支持。

已知问题

• Docker for Mac上挂载卷功能无法正常工作

许可协议

• ***声明：容器许可信息

通过向环境变量ACCEPT_EULA传递值"Y"，表示您拥有拟使用的SQL Server版本和 edition 的有效许可，并同意Azure SQL Edge软件在Docker容器镜像中的使用受您的Azure SQL Edge许可条款约束。

如需指定版本，使用MSSQL_PID环境变量，详情参见“环境变量”部分。

Azure SQL Edge Developer版允许开发人员在Azure SQL Edge上构建任何类型的应用程序，包含Premium版的所有功能，但仅许可用于开发和测试系统，不可用于生产服务器。Developer版许可条款参见此处。