用途:在本地 Azure SQL Database 开发容器上运行数据库架构迁移,使本地引擎与云端 Azure SQL Database 行为一致(EngineEdition 为 5,Edition 为 SQL Azure)。
主要能力:覆盖 EF Core(dotnet ef database update)、Prisma(prisma migrate deploy/dev)、Alembic(alembic upgrade head)、SqlPackage/DACPAC 发布等迁移方式;支持原生 VECTOR(n) 列与 VECTOR_DISTANCE,以及 CREATE VECTOR INDEX(DiskANN)。
必要用法:先 docker login 私有注册表,启动镜像 sqldbpreview-dpgaeqhmgphzd4bk.azurecr.io/azure-sql/db-dev:latest,用重试循环等待就绪;在 master 连接上创建 appdb,然后在连接串中指定 Database=appdb(不用 USE)。连接串使用 User Id=/Password=/Database= 与 TrustServerCertificate=true。种子数据需在迁移后显式用 sqlcmd 执行,容器不自动运行 /docker-entrypoint-initdb.d。
限制:不要使用 mcr.microsoft.com/mssql/server 镜像;引擎不会在连接时自动建库;非 x64 主机需加 --platform linux/amd64;向量维度必须是字面量,不能作绑定参数;向量索引需在数据加载后创建,且会影响 TRUNCATE 与数据层包导入;只能对 appdb 运行迁移,master 仅用于预配。最低工具版本:go-sqlcmd 1.10.0、Prisma 6.19.3。其他细节暂未提供。