Linux 命令行下高效备份与恢复 SQL Server 数据库的完整实践指南

2026-01-21

Linux 命令行下高效备份与恢复 SQL Server 数据库的完整实践指南

本文介绍在 linux 环境（尤其是 docker 容器化场景）中，使用 `mssql-scripter` 和 `sqlcmd` 实现 sql server 数据库的自动化导出（含结构与数据）与导入，完美替代 postgresql 中 `pg_dump`/`psql` 的工作流。

在基于 Docker 的 PHP 自动化测试环境中，频繁重置数据库至基线状态是刚需。不同于 PostgreSQL 生态成熟的 pg_dump/psql，SQL Server 在 Linux 下原生缺乏开箱即用的 CLI 导出/导入工具。但通过微软官方维护的 mssql-scripter（基于 Python 的跨平台脚本生成器）配合 sqlcmd（轻量级命令行执行器），可构建稳定、可复现的自动化数据快照流水线。

✅ 核心工具链说明

工具	用途	类比
mssql-scripter	生成包含 DDL（表/索引/约束）和 DML（INSERT）的 .sql 脚本	≈ pg_dump –clean –schema-and-data
sqlcmd	执行 SQL 脚本文件或单条语句	≈ psql -f dump.sql

⚠️ 注意：mssql-scripter 不直接执行恢复操作，它只生成可执行的 T-SQL 脚本；实际导入必须由 sqlcmd 或其他 SQL Server 客户端完成。

? 推荐 Docker 构建方案（适配现代 OpenSSL 与编码）

由于上游 mssql-scripter 存在已知兼容性问题（如 Issue #236），需手动集成新版 sqltoolsservice 并修复 UTF 编码缺陷。以下为生产就绪的多阶段精简版 Dockerfile 片段：

FROM ubuntu:22.04

# 安装依赖与 SQL Server 工具链
RUN apt-get update && apt-get install -y /
      curl wget gnupg unzip libunwind8 /
      && 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 /
      && apt-get update /
      && apt-get install -y msodbcsql18 mssql-tools18 /
      && echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc

# 安装 Python 3.9+ 与 mssql-scripter
RUN apt-get install -y python3-pip python3-dev /
      && pip3 install --no-cache-dir mssql-scripter==1.0.0a15

# 替换 sqltoolsservice（关键！解决 OpenSSL 3.x 兼容性）
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

# 修复 UTF-8 编码 bug（强制使用 UTF-16 输出，避免 BOM/乱码）
RUN sed -i 's/utf-8/utf-16/g' /usr/local/lib/python3.*/dist-packages/mssqlscripter/main.py

ENV MSSQLTOOLSSERVICE_PATH=/opt/Microsoft.SqlTools.ServiceLayer
ENV LANG=C.UTF-8

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

✅ 构建后，容器内即可执行标准化命令：

燕雀Logo

为用户提供LOGO免费设计在线生成服务

下载

# 导出全量结构 + 数据（含 DROP + CREATE + INSERT）
mssql-scripter -S mssql-host -d mydb -U sa -P 'MyPass!123' /
  --schema-and-data /
  --exclude-object-type Login,User,Role,ServerRoleMembership /
  --target-server-version SQLServer2019 /
  > dump.sql

# 导入（注意：目标库需已存在，且用户有 db_owner 权限）
/opt/mssql-tools18/bin/sqlcmd -S mssql-host -d mydb -U sa -P 'MyPass!123' -i dump.sql

? 关键注意事项与最佳实践

权限要求：mssql-scripter 需要 db_owner 或 VIEW DEFINITION + SELECT 权限；sqlcmd 导入需 db_ddladmin + db_datawriter。
字符集安全：务必使用 –encoding utf-16（或通过上述 patch 强制）避免中文/特殊字符乱码；生成脚本建议用 iconv -f UTF-16 -t UTF-8 dump.sql 转换后再检查。
排除对象：测试环境应显式 –exclude-object-type Login,User，避免跨环境 SID 冲突。
事务控制：sqlcmd 默认不开启事务，若需原子性恢复，可在 dump.sql 开头添加 BEGIN TRY BEGIN TRANSACTION … COMMIT END TRY BEGIN CATCH ROLLBACK; THROW; END CATCH 包裹逻辑（需自行注入）。
替代方案参考：
- 若仅需数据迁移（非结构重建），可用 bcp（更高效，但无 schema 导出能力）；
- 若接受容器内运行 PowerShell，Invoke-SqlCmd + Export-SqlData 是 Windows 方案，但不符合纯 Linux 要求；
- PHP 项目中也可直接调用 exec() 封装上述命令，无需额外语言栈。

通过该方案，你将获得与 pg_dump/psql 行为高度一致、可 CI/CD 集成、完全容器化的 SQL Server 数据快照能力——让每一次浏览器自动化测试，都从干净、可预测的数据库状态开始。

https://www.php.cn/faq/2013234.html