SQLCMD执行报错：-v参数格式无效，单台服务器运行异常求助

架构老林

2026-6-14

SQLCMD 传递变量执行INSERT时出现key=value格式错误的原因分析

问题场景

尝试通过SQLCMD执行INSERT语句并传递变量值，该命令在多数服务器上运行正常，但在某一台服务器上执行失败。使用的命令如下（其中TESTID是INSERT语句中使用的变量）：

Set DATABASEDETAILS=-I -S TESTSERVER -E -d TEST_DB
Set TESTID=1

SQLCMD.exe %DATABASEDETAILS% -v TESTID="%TESTID%" -Q "INSERT INTO TEST_TABLE (TEST_RUN_ID) VALUES ($(TESTID))"

执行命令时出现以下错误：

Sqlcmd: invalid argument "TESTID" for "-v,— variables" flag: TESTID must be formatted as key=value

已用NOTEPAD++检查变量参数周围的特殊字符，未发现异常，但不清楚问题原因。

可能的原因及解决办法

SQLCMD版本兼容性问题：不同服务器上的SQLCMD版本可能存在差异，旧版本对-v参数的格式要求更严格，不允许变量值带引号。尝试去掉变量值的引号，修改命令为：
```
SQLCMD.exe %DATABASEDETAILS% -v TESTID=%TESTID% -Q "INSERT INTO TEST_TABLE (TEST_RUN_ID) VALUES ($(TESTID))"
```
环境变量扩展异常：目标服务器的CMD环境可能存在变量扩展问题，导致%TESTID%被解析为空或异常分割。可以先直接硬编码值测试，比如-v TESTID=1，如果能正常运行，说明是变量扩展的问题。此时可改用延迟变量扩展，修改脚本：
```
@echo off
SetLocal EnableDelayedExpansion
Set DATABASEDETAILS=-I -S TESTSERVER -E -d TEST_DB
Set TESTID=1

SQLCMD.exe %DATABASEDETAILS% -v TESTID=!TESTID! -Q "INSERT INTO TEST_TABLE (TEST_RUN_ID) VALUES ($(TESTID))"
EndLocal
```
命令行参数分割异常：DATABASEDETAILS变量中的参数在目标服务器上可能被异常分割。可以尝试将-v参数直接写入SQLCMD命令，不通过环境变量传递：
```
SQLCMD.exe -I -S TESTSERVER -E -d TEST_DB -v TESTID=%TESTID% -Q "INSERT INTO TEST_TABLE (TEST_RUN_ID) VALUES ($(TESTID))"
```
权限或服务器配置差异：目标服务器的SQLCMD可能运行在不同权限上下文，或者SQL Server配置有特殊限制。尝试以管理员身份运行CMD后再执行命令测试。