17370845950

在 linux 环境（尤其是 docker 容器化场景）中，可使用 `mssql-scripter` + `sqlcmd` 组合实现类比 `pg_dump`/`psql` 的自动化数据库快照与恢复，适用于测试环境数据基线重置。

对于 PHP + Docker 架构下的自动化浏览器测试流程，频繁重置 SQL Server 数据库至初始状态是关键需求。遗憾的是，Microsoft 官方并未提供完全对标 pg_dump 的轻量级单二进制导出工具，但通过组合使用开源命令行工具 mssql-scripter（官方维护的跨平台脚本生成器）与 sqlcmd（官方 CLI 查询执行器），可构建稳定、可脚本化、符合 CI/CD 流程的数据库快照方案。

✅ 核心工具链说明

• mssql-scripter：基于 Python 的命令行工具，支持连接 SQL Server 实例并生成包含架构（DDL）和数据（INSERT 语句）的 T-SQL 脚本。等效于 --schema-and-data 模式。
• sqlcmd：Microsoft 官方提供的轻量级 CLI 工具，用于执行 T-SQL 脚本或查询，支持 -i 参数从文件导入。

⚠️ 注意：mssql-scripter 依赖底层 sqltoolsservice（SQL Tools Service Layer），旧版本在较新 Linux 发行版（如 Ubuntu 21.04+）上易因 OpenSSL 或编码兼容性问题失败，需手动指定新版服务层并修复 UTF 编码 bug。

? 推荐 Docker 构建方案（精简可靠）

以下 Dockerfile 片段已验证可在 Ubuntu 21.04+ 及后续 LTS（如 22.04）中稳定运行，适配现代 OpenSSL 和 Python 3.9+ 环境：

FROM ubuntu:22.04

# 安装基础依赖与 Microsoft ODBC 驱动、sqlcmd
RUN apt-get update && apt-get install -y \
      curl \
      gnupg \
      python3 \
      python3-pip \
      libunwind8 \
      && rm -rf /var/lib/apt/lists/*

# 添加 Microsoft GPG 密钥与仓库
RUN curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add - \
  && curl https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/prod.list > /etc/apt/sources.list.d/msprod.list

RUN apt-get update && apt-get install -y \
      msodbcsql18 \
      mssql-tools18 \
      && echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc

# 安装 mssql-scripter（需 Python 3.9+）
RUN pip3 install --no-cache-dir mssql-scripter

# 下载并部署兼容新版 OpenSSL 的 sqltoolsservice（v3.0.0-release.205）
ARG SQLTOOLS_URL=https://github.com/microsoft/sqltoolsservice/releases/download/v3.0.0-release.205/Microsoft.SqlTools.ServiceLayer-rhel-x64-net6.0.tar.gz
RUN mkdir -p /opt/Microsoft.SqlTools.ServiceLayer \
  && curl -sSL $SQLTOOLS_URL | tar -xzf - -C /opt/Microsoft.SqlTools.ServiceLayer --strip-components=1

# 修复 mssql-scripter 的 UTF-8 编码 bug（应为 UTF-16 输出以兼容 SQL Server BOM 处理）
RUN sed -i 's/utf-8/utf-16/g' /usr/local/lib/python3.*/dist-packages/mssqlscripter/main.py

# 设置环境变量供 mssql-scripter 自动发现服务层
ENV MSSQLTOOLSSERVICE_PATH=/opt/Microsoft.SqlTools.ServiceLayer
ENV PYTHONIOENCODING=utf-16

# 验证安装
RUN mssql-scripter --help >/dev/null && sqlcmd -? >/dev/null || exit 1

构建镜像后，即可在容器内执行标准化操作：

? 导出数据库快照（等效 pg_dump）

mssql-scripter \
  -S mssql-server \          # SQL Server 主机名（Docker 内部网络）
  -d myapp_test \            # 目标数据库名
  -U sa \                    # 用户名
  -P 'MyStrongPass123!' \   # 密码（生产环境建议用 -i 交互或 AZURE_TO
KEN）
  --schema-and-data \        # 同时导出结构 + 全量数据（含 INSERT）
  --target-server-version "SQL Server 2019" \  # 显式指定兼容版本，提升可靠性
  --file-path ./dump.sql

✅ 输出为 UTF-16 LE 编码 .sql 文件，含 BOM，确保 sqlcmd 正确解析中文/特殊字符。

? 导入快照（等效 psql）

/opt/mssql-tools18/bin/sqlcmd \
  -S mssql-server \
  -d myapp_test \
  -U sa \
  -P 'MyStrongPass123!' \
  -i ./dump.sql \
  -I  # 启用带引号标识符（推荐，兼容含空格/关键字的表名）

? 在 PHP 测试流程中集成示例（伪代码）

// beforeTest(): 重置数据库
exec("docker exec php-test-container mssql-scripter -S db -d testdb -U sa -P '$pass' --schema-and-data > /tmp/base.sql");
exec("docker exec php-test-container /opt/mssql-tools18/bin/sqlcmd -S db -d testdb -U sa -P '$pass' -i /tmp/base.sql");

// afterTest(): 可选清理或保留快照用于调试

⚠️ 关键注意事项

• 密码安全：避免在命令行明文传递密码（易被 ps 泄露）。推荐改用 sqlcmd 的 -G（Azure AD）或通过 .env + sqlcmd -v 传参；或使用 mssql-scripter --password-env 结合环境变量。
• 大数据量优化：--schema-and-data 对百万级以上行性能较差。如仅需结构重置，改用 --schema-only + --data-only 分离策略，并配合 BULK INSERT 或 bcp 工具加速导入。
• 权限要求：执行用户需具备 db_owner 角色或 VIEW DEFINITION + SELECT 权限。
• 替代方案评估：
  • bcp：原生高性能批量导入导出，但不生成可读 SQL，适合大数据迁移；
  • sqlpackage（.NET Core）：支持 DACPAC 导出，但 Linux 支持需 .NET 6+ 且无直接数据导出选项；
  • 首选仍为 mssql-scripter + sqlcmd 组合：平衡可读性、可控性、自动化友好度与官方支持度。

综上，该方案已在多个 PHP+Docker 测试流水线中稳定运行，完全满足“每次测试前一键回滚至基线”的核心诉求，兼具可维护性与工程严谨性。