将 sqlcmd 与脚本变量结合使用

将 sqlcmd 与脚本变量结合使用

SQL Server 2008 R2 

其他版本 

∙SQL Server 2008 

∙SQL Server 2005 

脚本中使用的变量称为脚本变量。使用脚本变量，一个脚本可以应用于多个方案中。例如，如果需要对多台服务器运行单个脚本，则可以用脚本变量来表示服务器名称，而不必为每台服务器修改脚本。通过更改脚本变量表示的服务器名称，可以在不同的服务器上运行同一脚本。

可以使用 setvar 命令显式定义脚本变量，也可以使用 sqlcmd-v 选项隐式定义脚本变量。

本主题还包含有关使用 SET 在 Cmd.exe 命令提示符下定义环境变量的示例。

使用 setvar 命令设置脚本变量 

setvar 命令用于定义脚本变量。使用 setvar 命令定义的变量存储在内部。不应将脚本变量与使用 SET 在命令提示符下定义的环境变量相混淆。如果脚本引用的变量不是环境变量，或不是使用 setvar 定义的变量，则会返回错误消息，并将停止执行脚本。有关详细信息，请参阅 sqlcmd 实用工具中的 -b 选项。

变量优先级（从低到高） 

如果有多类变量具有相同的名称，则使用优先级最高的变量。

1.系统级环境变量

2.用户级环境变量

3.启动 sqlcmd 之前在命令提示符下设置的命令 shell (SET X=Y)

4.sqlcmd -v X=Y

5.:Setvar X Y

如果启动 sqlcmd 时使用具有相关 sqlcmd 变量的选项，则 sqlcmd 变量将被隐式设置为使用该选项指定的值。在下面的示例中，启动 sqlcmd 时使用了 -l 选项。这会隐式设置 SQLLOGINTIMEOUT 变量。

c:\\> sqlcmd -l 60 

您还可以使用 -v 选项对脚本中的脚本变量进行设置。在下面的脚本（文件名为 testscript.sql）中，ColumnName 是一个脚本变量。

USE AdventureWorks2008R2; 

SELECT x.$(ColumnName) 

FROM Person.Person x 

WHERE c.BusinessEntityID < 5;

然后，您可以使用 -v 选项指定要返回的列名称：

sqlcmd -v ColumnName ="FirstName" -i c:\estscript.sql 

若要使用同一个脚本返回其他列，请更改 ColumnName 脚本变量的值。

sqlcmd -v ColumnName ="LastName" -i c:\estscript.sql 

有关脚本变量名和变量值的原则 

为脚本变量命名时，请考虑以下原则：

∙变量名不能包含空格字符或引号。

∙变量名不能与变量表达式（如 $(var)）具有相同的形式。

∙脚本变量不区分大小写。

∙如果字符串值包含空格，则必须用引号将使用 setvar 或 -v 选项定义的变量值引起来。

∙如果引号属于变量值的一部分，则必须对其进行转义。例如：:setvar MyVar "spac""e"。

有关 Cmd.exe SET 变量值和变量名的原则 

使用 SET 定义的变量是 Cmd.exe 环境的一部分并可供 sqlcmd 引用。请考虑以下原则：

∙变量名不能包含空格字符或引号。

∙变量值可包含空格或引号。

sqlcmd 脚本变量 

由 sqlcmd 定义的变量称为脚本变量。下表列出了 sqlcmd 脚本变量。

R 表示在程序初始化过程中只能设置一次值。

R/W 表示可以使用 setvar 命令重置值，并且后续命令将使用新值。

示例 

A. 在脚本中使用 setvar 命令

许多 sqlcmd 选项都可以通过在脚本中使用 setvar 命令来控制。在下面的示例中，创建了一个脚本 test.sql，其中 SQLCMDLOGINTIMEOUT 变量设置为 60 秒，另一个脚本变量 server 设置为 testserver。以下是 test.sql 中的代码。

:setvar SQLCMDLOGINTIMEOUT 60 

:setvar server "testserver" 

:connect $(server) -l $(SQLCMDLOGINTIMEOUT) 

USE AdventureWorks2008R2; 

SELECT FirstName, LastName 

FROM Person.Person; 

The script is then called by using sqlcmd: 

sqlcmd -i c:\est.sql 

B. 交互式使用 setvar 命令

下面的示例说明了如何使用 setvar 命令交互式设置脚本变量。

sqlcmd 

:setvar MYDATABASE AdventureWorks2008R2 

USE $(MYDATABASE); 

GO 

下面是结果集：

Changed database context to 'AdventureWorks2008R2'

1>

C. 在 sqlcmd 中使用命令提示符环境变量

在下例中，设置了四个环境变量然后从 sqlcmd 加以调用。

C:\\>SET tablename=Person.Person 

C:\\>SET col1=FirstName 

C:\\>SET col2=LastName 

C:\\>SET title=Ms. 

C:\\>sqlcmd -d AdventureWorks2008R2 

1> SELECT TOP 5 $(col1) + ' ' + $(col2) AS Name 

2> FROM $(tablename) 

3> WHERE Title ='$(title)' 

4> GO 

D. 在 sqlcmd 中使用用户级环境变量

在下面的示例中，在命令提示符下设置了用户级环境变量 %Temp%，并将其传递给了 sqlcmd 输入文件。若要获取用户级环境变量，请在“控制面板”中双击“系统”。单击“高级”选项卡，再单击“环境变量”。

以下是输入文件 (c:\estscript.txt) 中的代码：

:OUT $(MyTempDirectory) 

USE AdventureWorks2008R2; 

SELECT FirstName 

FROM AdventureWorks2008R2.Person.Person 

WHERE BusinessEntityID < 5; 

以下是在命令提示符下输入的代码：

C:\\ >SET MyTempDirectory=%Temp%\\output.txt 

C:\\ >sqlcmd -i C:\estscript.txt 

以下是发送给输出文件 (C:\\Documents and Settings\\\\Local Settings\\Temp\\output.txt) 的结果。

Changed database context to 'AdventureWorks2008R2'.

FirstName

--------------------------------------------------

Gustavo

Catherine

Kim

Humberto

(4 rows affected)

E. 使用启动脚本

sqlcmd 启动脚本是 sqlcmd 启动时执行的脚本。下面的示例设置了环境变量 SQLCMDINI。下面是 init.sql. 的内容

SET NOCOUNT ON 

GO 

DECLARE @nt_username nvarchar(128) 

SET @nt_username = (SELECT rtrim(convert(nvarchar(128), nt_username)) 

FROM sys.dm_exec_sessions WHERE spid = @@SPID) 

SELECT @nt_username + ' is connected to ' + 

rtrim(CONVERT(nvarchar(20), SERVERPROPERTY('servername'))) + 

' (' + 

rtrim(CONVERT(nvarchar(20), SERVERPROPERTY('productversion'))) + 

')' 

:setvar SQLCMDMAXFIXEDTYPEWIDTH 100 

SET NOCOUNT OFF 

GO 

:setvar SQLCMDMAXFIXEDTYPEWIDTH 

这将在 sqlcmd 启动时调用 init.sql 文件。

C:\\> SET sqlcmdini=c:\\init.sql 

>1 Sqlcmd 

这是输出。

>1 < 用户 > is connected to < 服务器 > (9.00.2047.00)

以下示例说明如何以 sqlcmd 变量的形式处理数据。

USE AdventureWorks2008R2; 

CREATE TABLE AdventureWorks2008R2.dbo.VariableTest 

( 

Col1 nvarchar(50) 

); 

GO 

在 dbo.VariableTest（包含值 $(tablename)）的 Col1 中插入一行。

INSERT INTO AdventureWorks2008R2.dbo.VariableTest(Col1) 

VALUES('$(tablename)'); 

GO 

在 sqlcmd 提示符下，如果没有任何变量设置为 $(tablename)，则使用以下语句返回该行。

C:\\> sqlcmd 

>1 SELECT Col1 FROM dbo.VariableTest WHERE Col1 = '$(tablename)'; 

>2 GO 

>3 SELECT Col1 FROM dbo.VariableTest WHERE Col1 = N'$(tablename)'; 

>4 GO 

下面是结果集：

>1 Col1

>2 ------------------

>3 $(tablename)

>4

>5 (1 rows affected)

假设将变量 MyVar 设置为 $(tablename)。

>6 :setvar MyVar $(tablename) 

这些语句返回该行，并且还返回了消息：“未定义‘tablename’脚本变量”。

>6 SELECT Col1 FROM dbo.VariableTest WHERE Col1 = '$(tablename)';

>7 GO

>1 SELECT Col1 FROM dbo.VariableTest WHERE Col1 = N'$(tablename)';

>2 GO

这些语句返回该行。

>1 SELECT Col1 FROM dbo.VariableTest WHERE Col1 = '$(MyVar)';

>2 GO

>1 SELECT Col1 FROM dbo.VariableTest WHERE Col1 = N'$(MyVar)';

>2 GO

请参阅 

参考

sqlcmd 实用工具 

概念

使用 sqlcmd 实用工具 

命令提示实用工具 

社区内容 添加 

常见问题 

© 2011 Microsoft. 版权所有。 

保留所有权利 | 商标 | 隐私权声明 | 个人信息中心 | 法律信息 | MSDN Flash 中心 | 联系我们 | 反馈信息 

窗体顶端

反馈信息

x 

请与我们分享您的经历… 

页面加载速度够快吗？ 

是 否 

您喜欢网页的设计吗？ 

是 否 

这一主题的内容是否实用？ 

请告诉我们更多意见 

窗体底端