Usando 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 -v de sqlcmd.
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. Variáveis de script não devem ser confundidas com variáveis de ambiente, que são definidas no prompt de comando usando SET. Se um script fizer referência a uma variável que não é variável de ambiente ou não foi definida usando setvar, uma mensagem de erro será retornada e a execução do script parará. Para obter mais informações, consulte a opção -b em Utilitário sqlcmd.
Precedência de variável (baixa para alta)
Se mais de um tipo de variável tiver o mesmo nome, a variável com precedência mais alta será usada.
Variáveis ambientais do nível de sistema
Variáveis ambientais do nível de usuário
Shell de comando (SET X=Y) definido no prompt de comando antes de iniciar o sqlcmd
sqlcmd-v X=Y
:Setvar X Y
.gif "Observação") Observação |
|---|
Para exibir as variáveis ambientais: no Painel de Controle, abra Sistema e depois clique na guia Avançado. |
Definindo implicitamente variáveis de script
Ao iniciar o sqlcmd com uma opção que possui uma variável do sqlcmd relacionada, a variável sqlcmd é implicitamente definida no valor especificado usando a opção. No exemplo a seguir, o sqlcmd é iniciado com a opção -l . Isto define implicitamente a variável SQLLOGINTIMEOUT.
c:\> sqlcmd -l 60
Também é possível usar a opção -v para definir uma variável de script existente em um script. O script a seguir (o nome de arquivo é testscript.sql), ColumnName é uma variável de script.
USE AdventureWorks2008R2;
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).
Variáveis de script não diferenciam maiúsculas de minúsculas.
ObservaçãoSe nenhum valor for atribuído a uma variável de ambiente do 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:
Valores de variáveis definidos usando setvar ou a opção -v devem ser mantidos entre aspas se o valor da cadeia contiver espaços.
Se houver aspas no valor da variável, elas devem ser substituídas. Por exemplo: setvar MyVar "spac""e".
Diretrizes para nomes e valores da variável SET de Cmd.exe
Variáveis definidas usando SET fazem parte do ambiente de Cmd.exe e sqlcmd pode fazer referências a elas. 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 do 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 |
R/W |
Padrão |
|---|---|---|---|
SQLCMDUSER* |
-U |
R |
"" |
SQLCMDPASSWORD* |
-P |
-- |
"" |
SQLCMDSERVER* |
-S |
R |
"DefaultLocalInstance" |
SQLCMDWORKSTATION |
-H |
R |
"ComputerName" |
SQLCMDDBNAME |
-d |
R |
"" |
SQLCMDLOGINTIMEOUT |
-l |
R/W |
"8" (segundos) |
SQLCMDSTATTIMEOUT |
-t |
R/W |
"0" = espere indefinidamente |
SQLCMDHEADERS |
-h |
R/W |
"0" |
SQLCMDCOLSEP |
-s |
R/W |
" " |
SQLCMDCOLWIDTH |
-w |
R/W |
"0" |
SQLCMDPACKETSIZE |
-a |
R |
"4096" |
SQLCMDERRORLEVEL |
-m |
R/W |
"0" |
SQLCMDMAXVARTYPEWIDTH |
-y |
R/W |
"256" |
SQLCMDMAXFIXEDTYPEWIDTH |
-Y |
R/W |
"0" = ilimitado |
SQLCMDEDITOR |
R/W |
"edit.com" |
|
SQLCMDINI |
R |
"" |
* SQLCMDUSER, SQLCMDPASSWORD e SQLCMDSERVER são definidos ao usar :Conectar.
R indica que o valor pode ser definido apenas uma vez durante a inicialização do programa.
R/W indica que o valor pode ser redefinido usando o comando setvar e que comandos subsequentes usarão o novo valor.
Exemplos
A. Usando o comando setvar em um script
Muitas opções de 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 AdventureWorks2008R2;
SELECT FirstName, LastName
FROM Person.Person;
The script is then called by using sqlcmd:
sqlcmd -i c:\test.sql
B. Usando interativamente o comando setvar
O exemplo a seguir mostra como definir interativamente uma variável de script usando o comando setvar.
sqlcmd
:setvar MYDATABASE AdventureWorks2008R2
USE $(MYDATABASE);
GO
Aqui está o conjunto de resultados.
Contexto de banco de dados alterado para 'AdventureWorks2008R2'
1>
C. Usando variáveis de ambiente de prompt de comando no sqlcmd
No exemplo a seguir, quatro variáveis de ambiente are são definidas e depois chamadas a partir do 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. Usando variáveis de ambiente de nível de usuário no sqlcmd
No exemplo a seguir, a variável de ambiente de nível de usuário %Temp% está definida no prompt de comando e foi passada para o arquivo de entrada do sqlcmd. 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çado e depois em Variáveis de Ambiente.
O código a seguir está no arquivo de entrada c:\testscript.txt:
:OUT $(MyTempDirectory)
USE AdventureWorks2008R2;
SELECT FirstName
FROM AdventureWorks2008R2.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 ao arquivo de saída C:\Documents and Settings\<user>\Local Settings\Temp\output.txt.
Contexto de banco de dados alterado para 'AdventureWorks2008R2'.
FirstName
--------------------------------------------------
Gustavo
Catherine
Kim
Humberto
(4 linhas afetadas)
E. Usando um script de inicialização
Um script de inicialização do sqlcmd é executado quando o 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
Isto chama o arquivo init.sql quando o sqlcmd é iniciado.
C:\> SET sqlcmdini=c:\init.sql
>1 Sqlcmd
Esta é 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 funcionamento com dados no formato de uma variável do sqlcmd.
USE AdventureWorks2008R2;
CREATE TABLE AdventureWorks2008R2.dbo.VariableTest
(
Col1 nvarchar(50)
);
GO
Insira uma linha em Col1 de dbo.VariableTest que contém o valor $(tablename).
INSERT INTO AdventureWorks2008R2.dbo.VariableTest(Col1)
VALUES('$(tablename)');
GO
No prompt do sqlcmd, quando nenhuma variável for definida igual a $(tablename), as instruções a seguir retornarão 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 linha afetada)
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
Estas 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