Compartilhar via

Definir as propriedades de uma variável definida pelo usuário

  • Artigo

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 propriedades para configurar variáveis não disponíveis na janela Variáveis : Description, EvaluateAsExpression, Expression, ReadOnly, ValueType e IncludeInDebugDump.

Observação

O Integration Services também fornece um conjunto de variáveis do 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 definido pela propriedade Value ou Expression. Por padrão, a propriedade EvaluateAsExpression é definida False como e o valor da variável é definido pela propriedade Value. Para usar uma expressão para definir o valor, primeiro você deve definir EvaluateAsExpression como Truee, em seguida, 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, 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(), Value conterá a data e a hora atuais e ValueType será definido como DateTime.

  • A janela Propriedades para a variável fornece acesso à caixa de diálogo Construtor de Expressões . É 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 o valor da variável, primeiro confirme se o tipo de dados da variável é compatível com o resultado de avaliação da expressão e, em seguida, forneça uma expressão na Expression coluna da janela Variáveis . A propriedade EvaluateAsExpression na janela Propriedades é definida automaticamente 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ões . É 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 estiver definido como True, não será possível alterar o tipo de dados 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 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

  1. No SQL Server Data Tools (SSDT), abra o projeto do Integration Services que contém o pacote desejado.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no pacote para abri-lo.

  3. No menu SSIS , clique em Variáveis.

    Além disso, você pode exibir a janela Variáveis mapeando o comando View.Variables para uma combinação de teclas de sua escolha na página Teclado da caixa de diálogo Opções .

  4. Opcionalmente, na janela Variáveis , clique em Opções de Gradee selecione as colunas para serem exibidas na janela Variáveis e selecione os filtros para serem aplicados na lista de variáveis.

  5. Selecione a variável na lista e atualize os Namevalores nas colunas , Tipo de Dados, Value, Namespace, Gerar Evento de Alteração, Descrição e Expression .

  6. Selecione a variável na lista e, em seguida, clique Mover Variável para alterar o escopo.

  7. 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

  1. No SQL Server Data Tools (SSDT), abra o projeto do Integration Services que contém o pacote desejado.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no pacote para abri-lo.

  3. No menu Exibir , clique em Janela Propriedades.

  4. No Designer SSIS , clique na guia Explorador de Pacotes e expanda o nó do Pacote.

  5. 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.

  6. Clique na variável cujas propriedades você deseja modificar.

  7. 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, confira Variáveis do SSIS (Integration Services).

  8. Para salvar o pacote atualizado, no menu Arquivo , clique em Salvar Itens Selecionados.

Consulte Também

Variáveis do SSIS (Integration Services)
Usar variáveis em pacotes
Adicionar, excluir, alterar o escopo de uma variável definida pelo usuário em um pacote