Variáveis do sistema

O SQL Server Integration Services fornece um conjunto de variáveis de sistema que armazena informações sobre o pacote em execução e seus objetos. Essas variáveis podem ser usadas em expressões e expressões de propriedade para personalizar pacotes, contêineres, tarefas e manipuladores de eventos.

Todas as variáveis do sistema e as definidas pelo usuário podem ser usadas nas associações de parâmetro que a tarefa Executar SQL usa para mapear variáveis para parâmetros.

Variáveis do sistema para pacotes

A tabela a seguir descreve as variáveis do sistema que o Integration Services fornece para pacotes.

Variável do sistema	Tipo de dados	Descrição
CancelEvent	Int32	O manipulador de um objeto de Evento do Windows que a tarefa pode sinalizar para indicar que a execução da tarefa deve ser interrompida.
CreationDate	Data/Hora	A data em que o pacote foi criado.
CreatorComputerName	Cadeia de caracteres	O computador no qual o pacote foi criado.
CreatorName	Cadeia de caracteres	O nome da pessoa que criou o pacote.
ExecutionInstanceGUID	Cadeia de caracteres	O identificador exclusivo da instância de execução de um pacote.
InteractiveMode	Booleano	Indica se o pacote é executado em modo interativo. Se um pacote estiver sendo executado no Designer SSIS, essa propriedade será definida como True. Se um pacote estiver sendo executado com o utilitário de prompt de comando DTExec, a propriedade será definida como False.
LocaleId	Int32	A localidade que o pacote usa.
MachineName	Cadeia de caracteres	O nome do computador no qual o pacote está sendo executado.
OfflineMode	Booleano	Indica se o pacote está no modo offline. O modo offline não obtém conexões com fontes de dados.
PackageID	Cadeia de caracteres	O identificador exclusivo do pacote.
PackageName	Cadeia de caracteres	O nome do pacote.
StartTime	Data/Hora	A hora de início da execução do pacote.
UserName	Cadeia de caracteres	A conta do usuário que iniciou o pacote. O nome do usuário é qualificado pelo nome do domínio.
VersionBuild	Int32	A versão do pacote.
VersionComment	Cadeia de caracteres	Comentários sobre a versão do pacote.
VersionGUID	Cadeia de caracteres	O identificador exclusivo da versão.
VersionMajor	Int32	A versão principal do pacote.
VersionMinor	Int32	A versão secundária do pacote.

Variáveis do sistema para contêineres

A tabela a seguir descreve as variáveis do sistema que o Integration Services fornece para os contêineres Loop For, Loop Foreach e Sequência.

Variável do sistema	Tipo de dados	Descrição	Contêiner
LocaleId	Int32	A localidade que o contêiner usa.	Contêiner Loop For Contêiner Loop Foreach Contêiner Sequência

Variáveis do sistema para tarefas

A tabela a seguir descreve as variáveis do sistema que o Integration Services fornece para tarefas.

Variável do sistema	Tipo de dados	Descrição
CreationName	Cadeia de caracteres	O nome da tarefa.
LocaleId	Int32	A localidade que a tarefa usa.
TaskID	Cadeia de caracteres	O identificador exclusivo da instância de uma tarefa.
TaskName	Cadeia de caracteres	O nome da instância da tarefa.
TaskTransactionOption	Int32	A opção de transação que a tarefa usa.

Variáveis do sistema para Manipuladores de Eventos

A tabela seguinte descreve as variáveis do sistema que o Integration Services fornece para manipuladores de eventos. Nem todas as variáveis estão disponíveis para todos os manipuladores de eventos.

Variável do sistema	Tipo de dados	Descrição	Manipulador de eventos
Cancel	Booleano	Indica se a execução do manipulador de eventos é interrompida quando ocorre um erro, aviso ou cancelamento de consulta.	Manipulador de eventos OnError Manipulador de eventos OnWarning Manipulador de eventos OnQueryCancel
ErrorCode	Int32	O identificador do erro.	Manipulador de eventos OnError Manipulador de eventos OnInformation Manipulador de eventos OnWarning
ErrorDescription	Cadeia de caracteres	A descrição do erro.	Manipulador de eventos OnError Manipulador de eventos OnInformation Manipulador de eventos OnWarning
ExecutionStatus	Booleano	O status de execução atual.	Manipulador de eventos OnExecStatusChanged
ExecutionValue	DBNull	O valor da execução.	Manipulador de eventos OnTaskFailed
LocaleId	Int32	A localidade que o manipulador de eventos usa.	Todos os manipuladores de eventos
PercentComplete	Int32	A porcentagem do trabalho concluído.	Manipulador de eventos OnProgress
ProgressCountHigh	Int32	A parte alta de um valor de 64 bits que indica o número total de operações processadas pelo evento OnProgress.	Manipulador de eventos OnProgress
ProgressCountLow	Int32	A parte baixa de um valor de 64 bits que indica o número total de operações processadas pelo evento OnProgress.	Manipulador de eventos OnProgress
ProgressDescription	Cadeia de caracteres	Descrição do progresso.	Manipulador de eventos OnProgress
Propagate	Booleano	Indica se o evento é propagado para um manipulador de eventos de nível mais alto. Observação O valor da variável Propagate é desconsiderado durante a validação do pacote. Se você definir Propagate como False em um pacote filho, isto não impedirá que um evento seja propagado até o pacote pai. Para impedir que o pacote pai controle o evento, defina a propriedade DisableEventHandlers da tarefa Executar Pacote como True.	Todos os manipuladores de eventos
SourceDescription	Cadeia de caracteres	A descrição do executável no manipulador de eventos que ativou o evento.	Todos os manipuladores de eventos
SourceID	Cadeia de caracteres	O identificador exclusivo do executável no manipulador de eventos que ativou o evento.	Todos os manipuladores de eventos
SourceName	Cadeia de caracteres	O nome do executável no manipulador de eventos que ativou o evento.	Todos os manipuladores de eventos
VariableDescription	Cadeia de caracteres	A descrição da variável.	Manipulador de eventos OnVariableValueChanged
VariableID	Cadeia de caracteres	O identificador exclusivo da variável.	Manipulador de eventos OnVariableValueChanged

Usando variáveis do sistema em associações de parâmetro

É muito útil salvar os valores de variáveis do sistema em tabelas quando o pacote é executado. Por exemplo, um pacote que cria dinamicamente uma tabela e grava o GUID da instância de execução do pacote que criou a tabela em uma coluna da tabela.

Se você usar variáveis do sistema para mapear parâmetros na instrução SQL que uma tarefa Executar SQL usa, é importante definir o tipo de dados de cada parâmetro associado ao tipo de dados da variável do sistema. Caso contrário, os valores de variáveis do sistema poderão ser convertidos incorretamente. Por exemplo, se a variável do sistema ExecutionInstanceGUID, que contém o tipo de dados de cadeia de caracteres e a cadeia que representa o GUID da instância de execução de um pacote, for usada em um parâmetro associado ao tipo de dados GUID, o GUID da instância do pacote será convertido incorretamente.

Essa regra se aplica também a variáveis definidas pelo usuário. Mas, enquanto os tipos de dados de variáveis do sistema não podem ser alterados e você precisa moldar o uso dessas variáveis para se ajustar aos tipos de dados, aqueles definidos pelo usuário são mais flexíveis. As variáveis definidas pelo usuário e usadas em associações de parâmetro são geralmente definidas com tipos de dados compatíveis aos tipos de dados dos parâmetros para os quais são mapeados.

Fique atualizado com o Integration Services Para obter os mais recentes downloads, artigos, exemplos e vídeos da Microsoft, bem como soluções selecionadas da comunidade, visite a página do Integration Services no MSDN ou TechNet: Visite a página do Integration Services no MSDN Visite a página do Integration Services no TechNet Para receber uma notificação automática das atualizações, assine os feeds RSS disponíveis na página.

Consulte também

Conceitos

Pacotes do Integration Services

Contêineres do Integration Services

Tarefas do Integration Services

Manipuladores de eventos do Integration Services

Variáveis do Integration Services