解决sqlcmd脚本未传SchemaName变量时的报错与默认值问题

问题核心是sqlcmd脚本变量的解析优先级高于T-SQL代码，直接在T-SQL里给变量设默认值没用——sqlcmd会先检查所有$(变量名)的引用，找不到对应传入的变量就直接报错，根本不会执行后续的T-SQL逻辑。

正确的实现步骤如下：

1. 用sqlcmd专属的:setvar语法提前为脚本变量设置默认值，这一步会在sqlcmd解析阶段生效
2. 将sqlcmd脚本变量的值赋值给T-SQL局部变量，后续逻辑用T-SQL变量处理

完整的my_script.sql示例：

-- 为sqlcmd脚本变量设置默认值，未通过-v参数传入时自动使用该值
:setvar SchemaName "dbo"

-- 声明T-SQL局部变量，接收sqlcmd变量的值
DECLARE @SchemaName NVARCHAR(128) = '$(SchemaName)';
DECLARE @TableName NVARCHAR(128) = '$(TableName)';

-- 输出完整表名
SELECT CONCAT(@SchemaName, '.', @TableName) AS FullTableName;

终端运行示例 #

• 传入SchemaName变量的场景：

sqlcmd -S 你的服务器名 -d 你的数据库名 -i my_script.sql -v SchemaName="sales" TableName="orders"

• 不传入SchemaName的场景（自动使用默认值dbo）：

sqlcmd -S 你的服务器名 -d 你的数据库名 -i my_script.sql -v TableName="orders"

这样处理后，未传入SchemaName时既不会报错，也会自动使用默认的'dbo'值。

内容的提问来源于stack exchange，提问作者dfashimpaur