Usar sqlcmd com variáveis de script

As variáveis usadas em scripts normalmente são chamadas de variáveis de script. As variáveis de script habilitam um script ser usado em vários cenários. Por exemplo, se você desejar executar um script em vários servidores, em vez de modificar o script para cada servidor, pode usar uma variável de script para o nome do servidor. Alterando o nome do servidor fornecido para a variável de script, o mesmo script pode ser executado em diferentes servidores.

As variáveis de script podem ser definidas explicitamente usando o comando setvar ou implicitamente usando a opção sqlcmd-v .

Este tópico também inclui exemplos que definem variáveis ambientais no prompt de comando Cmd.exe usando SET.

Definindo variáveis de script usando o comando setvar

O comando setvar é usado para definir variáveis de script. Variáveis definidas usando o comando setvar são armazenadas internamente. As variáveis de script não devem ser confundidas com variáveis de ambiente definidas no prompt de comando usando SET. Se um script fizer referência a uma variável que não é uma variável de ambiente ou não for definida usando setvar, uma mensagem de erro será retornada e a execução do script será interrompida. Para obter mais informações, consulte a opção -b no Utilitário sqlcmd.

Precedência variável (baixa a alta)

Se mais de um tipo de variável tiver o mesmo nome, a variável com precedência mais alta será usada.

1. Variáveis ambientais do nível de sistema

2. Variáveis ambientais do nível de usuário

3. Shell de comando (SET X=Y) definido no prompt do comando antes de iniciar sqlcmd

4. sqlcmd-v X=Y

5. :Setvar X Y

Observação

Para exibir as variáveis ambientais, no Painel de Controle, abra o Sistema e clique na guia Avançado .

Configurando implicitamente variáveis de script

Ao iniciar o sqlcmd com uma opção que contém uma variável sqlcmd relacionada, a variável sqlcmd será implicitamente definida com o valor especificado com a opção. No exemplo a seguir, o sqlcmd é iniciado com a opção -l . Isso define implicitamente a variável SQLLOGINTIMEOUT.

c:\> sqlcmd -l 60

Você também pode usar a opção -v para definir uma variável de script que existe em um script. O script a seguir (o nome de arquivo é testscript.sql), ColumnName é uma variável de script.

USE AdventureWorks2012;

SELECT x.$(ColumnName)

FROM Person.Person x

WHERE c.BusinessEntityID < 5;

Assim você pode especificar o nome da coluna que deseja que retorne usando a opção -v :

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

Para retornar uma coluna diferente usando o mesmo script, altere o valor da variável de script ColumnName .

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

Diretrizes para nomes e valores de variáveis de script

Considere as seguintes diretrizes ao nomear variáveis de script:

• Os nomes das variáveis não devem conter caracteres de espaços em brancos ou aspas.

• Os nomes das variáveis não devem ter a mesma forma que uma expressão variável, como $(var) .

• As variáveis de script não diferenciam maiúsculas de minúsculas.

  Observação

  Se nenhum valor for atribuído a uma variável de ambiente sqlcmd , a variável será removida. Usar :setvar VarName sem um valor limpa a variável.

Considere as seguintes diretrizes ao especificar valores para variáveis de script:

• Os valores de variável definidos usando setvar ou a opção -v deverão ser colocados entre aspas se o valor da cadeia de caracteres contiver espaços.

• Se as aspas fizerem parte do valor da variável, elas deverão ser substituídas. Por exemplo:setvar MyVar "spac""e".

Diretrizes para valores e nomes de variáveis Cmd.exe SET

As variáveis definidas usando SET fazem parte do ambiente Cmd.exe e podem ser referenciadas pelo sqlcmd. Considere as seguintes diretrizes:

• Os nomes das variáveis não devem conter caracteres de espaços em brancos ou aspas.

• Valores de variáveis podem conter espaços ou aspas.

Variáveis de script sqlcmd

Variáveis definidas por sqlcmd são conhecidas como variáveis de script. A tabela a seguir lista variáveis de script do sqlcmd .

Variável	Opção relacionada	L/G	Padrão
SQLCMDUSER*	-U	R	""
SQLCMDPASSWORD*	-P	--	""
SQLCMDSERVER*	-S	R	"DefaultLocalInstance"
SQLCMDWORKSTATION	-H	R	Nome do Computador
SQLCMDDBNAME	-d	R	""
SQLCMDLOGINTIMEOUT	-l	L/G	"8" (segundos)
SQLCMDSTATTIMEOUT	-T	L/G	"0" = espere indefinidamente
SQLCMDHEADERS	-h	L/G	0
SQLCMDCOLSEP	-s	L/G	" "
SQLCMDCOLWIDTH	-w	L/G	0
SQLCMDPACKETSIZE	-um	R	"4096"
SQLCMDERRORLEVEL	-m	L/G	0
SQLCMDMAXVARTYPEWIDTH	-y	L/G	"256"
SQLCMDMAXFIXEDTYPEWIDTH	-Y	L/G	"0" = ilimitado
SQLCMDEDITOR		L/G	"edit.com"
SQLCMDINI		R	""

* SQLCMDUSER, SQLCMDPASSWORD e SQLCMDSERVER são definidos quando :Connect é usado.

R indica que o valor só pode ser definido uma vez durante a inicialização do programa.

R/W indica que o valor pode ser redefinido usando o comando setvar e os comandos subsequentes usarão o novo valor.

Exemplos

Um. Usando o comando setvar em um script

Muitas opções do sqlcmd podem ser controladas em um script usando o comando setvar . No exemplo a seguir, o script test.sql é criado e nele a variável SQLCMDLOGINTIMEOUT é definida como 60 segundos e outra variável de script, server, é definida como testserver. O código a seguir está em test.sql.

:setvar SQLCMDLOGINTIMEOUT 60

:setvar server "testserver"

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

USE AdventureWorks2012;

SELECT FirstName, LastName

FROM Person.Person;

The script is then called by using sqlcmd:

sqlcmd -i c:\test.sql

B. Usando o comando setvar interativamente

O exemplo a seguir mostra como definir interativamente uma variável de script usando o comando setvar .

sqlcmd

:setvar MYDATABASE AdventureWorks2012

USE $(MYDATABASE);

GO

Aqui está o conjunto de resultados.

Changed database context to 'AdventureWorks2012'

1>

C. Usando variáveis de ambiente de prompt de comando no SQLCMD

No exemplo a seguir, quatro variáveis de ambiente são definidas are e chamadas de sqlcmd.

C:\>SET tablename=Person.Person

C:\>SET col1=FirstName

C:\>SET col2=LastName

C:\>SET title=Ms.

C:\>sqlcmd -d AdventureWorks2012

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

2> FROM $(tablename)

3> WHERE Title ='$(title)'

4> GO

D. Usando variáveis de ambiente no nível do usuário no sqlcmd

No exemplo a seguir, a variável %Temp% ambiental no nível do usuário é definida no prompt de comando e passada para o sqlcmd arquivo de entrada. Para obter a variável de ambiente de nível de usuário: em Painel de Controle, clique duas vezes em Sistema. Clique na guia Avançar e clique em Variáveis de Ambiente.

O código a seguir está no arquivo de entrada c:\testscript.txt:

:OUT $(MyTempDirectory)

USE AdventureWorks2012;

SELECT FirstName

FROM AdventureWorks2012.Person.Person

WHERE BusinessEntityID < 5;

O código a seguir é inserido no prompt de comando:

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

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

O resultado a seguir é enviado para o arquivo de saída C:\Documents and Settings\<user>\Local Settings\Temp\output.txt.

Changed database context to 'AdventureWorks2012'.

FirstName

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

Gustavo

Catherine

Kim

Humberto

(4 rows affected)

E. Usando um script de inicialização

Um script de inicialização sqlcmd é executado quando sqlcmd é iniciado. O exemplo a seguir define a variável de ambiente de SQLCMDINI. Este é o conteúdo de 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

Isso chama o arquivo init.sql quando o sqlcmd for iniciado.

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

>1 Sqlcmd

Essa é a saída.

>1 < user > is connected to < server > (9.00.2047.00)

Observação

A opção -X desabilita o recurso de script de inicialização.

F. Expansão de variável

O exemplo a seguir mostra o trabalho com dados no formato de uma variável sqlcmd .

USE AdventureWorks2012;

CREATE TABLE AdventureWorks2012.dbo.VariableTest

(

Col1 nvarchar(50)

);

GO

Insira uma linha em Col1 de dbo.VariableTest que contém o valor $(tablename).

INSERT INTO AdventureWorks2012.dbo.VariableTest(Col1)

VALUES('$(tablename)');

GO

sqlcmd No prompt, quando nenhuma variável é definida como igual a$(tablename), as instruções a seguir retornam a linha.

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

Aqui está o conjunto de resultados.

>1 Col1

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

>3 $(tablename)

>4

>5 (1 rows affected)

Dado que a variável MyVar foi definida como $(tablename).

>6 :setvar MyVar $(tablename)

Estas instruções retornam a linha e também a mensagem "variável de script 'tablename' não definida".

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

>7 GO

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

>2 GO

Essas instruções retornam a linha.

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

>2 GO

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

>2 GO

Consulte Também

Usar o utilitário sqlcmd
Utilitário sqlcmd
Referência de programa utilitário do prompt de comando (Mecanismo de Banco de Dados)