SuperAPI AI 工具集

azuresql-db-container

数据与分析

查看项目

更新于 10-16 00:31

技能介绍

用途:在本地 Docker 容器中运行 Azure SQL Database 引擎(Private Preview),为面向云 PaaS 引擎的开发提供本地对等环境。官方明确说明它不是 mcr.microsoft.com/mssql/server(SQL Server 镜像),应使用镜像 sqldbpreview-dpgaeqhmgphzd4bk.azurecr.io/azure-sql/db-dev:latest。

主要能力:镜像仅支持 x64(linux/amd64),非 x64 主机需加 --platform linux/amd64。引擎监听容器端口 1433。支持 VECTOR(n) 类型与 VECTOR_DISTANCE。所需环境变量为 ACCEPT_EULA=Y 与 MSSQL_SA_PASSWORD(至少 8 位且含大写、小写、数字、符号中的三类)。可选 Microsoft Entra ID 认证,需 MSSQL_AAD_* 变量与挂载证书。

使用方式:先按 https://aka.ms/sqldbcontainerpreview-signup 注册获取只读拉取凭证,执行 docker login sqldbpreview-dpgaeqhmgphzd4bk.azurecr.io -u <username>;可先 docker pull 获取最新构建。启动后需在 master 连接上执行 CREATE DATABASE appdb,再以 Database=appdb(或 sqlcmd 的 -d appdb)连接。验证引擎身份:SELECT SERVERPROPERTY('EngineEdition'), SERVERPROPERTY('Edition'),预期为 5 与 SQL Azure。也可运行 bash scripts/verify.sh 端到端自检,加 --keep 保留容器。

限制:不具备完整 SQL Server 功能面,无 SQL Agent、FILESTREAM、完整 Service Broker、跨服务器 DTC、Windows 认证/NTLM。不自动创建数据库;不自动运行 /docker-entrypoint-initdb.d。避免用 USE 切换数据库(用户库中返回 Msg 40508),master 连接仅用于预配。镜像为 Private Preview,会频繁重建,凭证只读且可能轮换,应作为机密保管、勿分发。本地功能通过不代表云端一致,需对照云环境验证。

其它:该技能作为入口,将具体任务转交 azuresql-db-from-sql-server、azuresql-db-local-to-cloud、azuresql-db-schema-migration、azuresql-db-import、azuresql-db-rag、azuresql-db-ci、azuresql-db-sidecar、azuresql-db-scaffold、azuresql-db-dab、azuresql-db-functions、azuresql-db-seed、azuresql-db-testing、azuresql-db-connections、azuresql-db-auth、azuresql-db-feedback 等任务技能处理。最低工具版本(按所用配方)包括 sqlpackage 170.4.83.3、go-sqlcmd 1.10.0、Data API builder 2.0.9、.NET SDK 8.0.421、Alembic 1.13.0、Prisma 6.19.3。清理可用 docker rm -f sqldb 与 docker volume rm sqldb-data。