Definir as propriedades de uma variável definida pelo usuário
Para definir as propriedades de uma variável definida pelo usuário no Integration Services, você pode usar um dos seguintes recursos:
Janela Variáveis.
Janela Propriedades. A janela Propriedades lista as propriedades para configuração de variáveis que não estão disponíveis na janela de Variáveis: Description, EvaluateAsExpression, Expression, ReadOnly, ValueType e IncludeInDebugDump.
.gif "Observação") Observação |
|---|
O Integration Services também fornece um conjunto de variáveis de sistema cujas propriedades não podem ser atualizadas, com a exceção da propriedade RaiseChangedEvent. |
Definindo as expressões em variáveis
Quando você usa a janela Propriedades para definir as expressões em uma variável definida pelo usuário:
O valor de uma variável pode ser definida pela propriedade Value ou Expression. Por padrão, a propriedade EvaluateAsExpression está definida como False e o valor da variável é definido pela propriedade Value. Para usar uma expressão para definir o valor, você deve definir antes a EvaluateAsExpression como True e fornecer uma expressão na propriedade Expression. A propriedade Value é definida automaticamente como o resultado de avaliação da expressão.
A propriedade ValueType contém o tipo de dados do valor na propriedade Value. Quando Value é definido por uma expressão, o ValueType é atualizado automaticamente para um tipo de dados compatível com o resultado da avaliação da expressão. Por exemplo, se Value contiver 0 e a propriedade ValueType contiver Int32 e você definir Expression como GETDATE(), o Value conterá a data e a hora atual e o ValueType será definido como DateTime.
A janela Propriedades para a variável fornece acesso à caixa de diálogo Construtor de Expressão. É possível usar essa ferramenta para criar, validar e avaliar expressões. Para obter mais informações, consulte Construtor de Expressões e Expressões do SSIS (Integration Services).
Quando você usa a janela Variáveis para definir as expressões em uma variável definida pelo usuário:
Para usar uma expressão para definir um valor de variável, primeiro confirme que o tipo de dados da variável é compatível com o resultado da avaliação da expressão e, em seguida, forneça uma expressão na coluna Expressão da janela Variáveis. A propriedade EvaluateAsExpression na janela Propriedades é automaticamente definida como True.
Quando você atribui uma expressão a uma variável, um marcador de ícone especial é exibido ao lado da variável. Esse marcador de ícone especial também é exibido ao lado de gerenciadores de conexões e tarefas que têm expressões definidas neles.
A janela Variáveis para a variável fornece acesso à caixa de diálogo Construtor de Expressão. É possível usar essa ferramenta para criar, validar e avaliar expressões. Para obter mais informações, consulte Construtor de Expressões e Expressões do SSIS (Integration Services).
Na janela Variáveis e Propriedades, se você atribuir uma expressão à variável e EvaluateAsExpression for definido como True, você não poderá alterar o tipo de dado da variável.
Definindo o namespace e as propriedades do nome
Os valores das propriedades Name e Namespace devem começar com uma letra de caractere alfabético conforme definido pelo padrão Unicode Standard 2.0 ou um sublinhado (_). Os caracteres subsequentes podem ser letras ou números conforme definido no padrão Unicode Standard 2.0 ou o sublinhado (_).
Usando a janela Variáveis para definir propriedades
Para definir as propriedades de uma variável usando a janela Variáveis
No SSDT (SQL Server Data Tools), abra o projeto do Integration Services que contém o pacote desejado.
No Gerenciador de Soluções, clique com o botão direito do mouse no pacote para abri-lo.
No menu SSIS, clique em Variáveis.
Além disso, você pode exibir a janela Variáveis mapeando o comando Exibir Variáveis em uma combinação de teclas de sua escolha na página Teclado da caixa de diálogo Opções.
Opcionalmente, na janela Variáveis, clique em Opções de Grade e selecione as colunas para serem exibidas na janela Variáveis e selecione os filtros para serem aplicados na lista de variáveis.
Selecione a variável na lista e atualize os valores nas colunas Nome, Tipo de Dados, Valor, Namespace, Gerar Evento de Alteração, Descrição e Expressão.
Selecione a variável na lista e, em seguida, clique Mover Variável para alterar o escopo.
Para salvar o pacote atualizado, no menu Arquivo, clique em Salvar Itens Selecionados.
Usando a janela Propriedades para definir propriedades
Para definir as propriedades de uma variável usando a janela Propriedades
No SSDT (SQL Server Data Tools), abra o projeto do Integration Services que contém o pacote desejado.
No Gerenciador de Soluções, clique com o botão direito do mouse no pacote para abri-lo.
No menu Exibir, clique em Janela de Propriedades.
No Designer SSIS, clique na guia Gerenciador de Pacotes e expanda o nó do Pacote.
Para modificar variáveis com escopo no pacote, expanda o nó Variáveis; caso contrário, expanda os Manipuladores de Evento ou os nós Executáveis até que localize o nó Variáveis que contém a variável que deseja modificar.
Clique na variável cujas propriedades você deseja modificar.
Na janela Propriedades, atualize as propriedades da variável de leitura/escrita. Algumas propriedades são de leitura/somente leitura para variáveis definidas pelo usuário.
Para obter mais informações sobre as propriedades, consulte Variáveis do SSIS (Integration Services).
Para salvar o pacote atualizado, no menu Arquivo, clique em Salvar Itens Selecionados.
Consulte também
Tarefas
Adicionar, excluir, alterar o escopo de uma variável definida pelo usuário em um pacote