• Artigo

Como definir as propriedades de uma variável

Para definir as propriedades de uma variável definida pelo usuário no Integration Services, você pode usar um dos seguintes recursos:

  • A janela Variáveis.

  • A janela Propriedades. A janela Propriedades lista as propriedades para configuração de variáveis que não estão disponíveis na janela Variáveis: Description, EvaluateAsExpression, Expression, ReadOnly e ValueType.

ObservaçãoObservação

O Integration Services também fornece um conjunto de variáveis de sistema cujas propriedades não podem ser atualizadas.

Usando a janela Variáveis para definir propriedades

Para definir as propriedades de uma variável usando a janela Variáveis

  1. No Business Intelligence Development Studio, 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. Na janela Variáveis, clique em Mostrar Todas as Variáveis.

  5. Se preferir, clique em Escolher Colunas de Variáveis e marque e desmarque as opções de coluna na caixa de diálogo Escolher Colunas de Variáveis.

  6. Selecione a variável na lista e atualize os valores nas colunas Tipo de Dados, Valor, Namespace e Elevar Evento de Alteração.

    ObservaçãoObservação

    Os valores na coluna Valor devem ser compatíveis com o tipo de dados especificado na coluna Tipo de Dados.

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

Usando a janela Propriedades para definir propriedades

Quando você usa a janela Propriedades para definir as propriedades de 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 Referência de Expressão do Integration Services.

Para definir as propriedades de uma variável usando a janela Propriedades

  1. No Business Intelligence Development Studio, 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 de Propriedades.

  4. No Designer SSIS, clique na guia Gerenciador 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.

    A seguinte tabela lista as variáveis que podem ser atualizáveis.

    Propriedade de leitura/gravação

    Ação de atualizar

    Description

    Modifique a descrição.

    EvaluateAsExpression

    Defina como Verdadeiro para usar o resultado de avaliação de uma expressão na propriedade Value.

    Expression

    Clique em (…) para abrir a caixa de diálogo Construtor de Expressão e construa a expressão usando essa ferramenta gráfica ou digite uma expressão.

    Name

    Para variáveis definidas pelo usuário, modifique o nome de variável.

    Namespace

    Para variáveis definidas pelo usuário, modifique o espaço para nome.

    RaiseChangedEvent

    Defina como True para acionar um evento quando a variável mudar de valor.

    ReadOnly

    Para variáveis definidas pelo usuário, defina como Verdadeiro para tornar a variável possível de leitura/gravação.

    Value

    Para variáveis definidas pelo usuário, especifique um valor. O valor deve ser compatível com o tipo de valor na propriedade ValueType.

    ValueType

    Para variáveis definidas pelo usuário, especifique o tipo de dados do valor da variável.
    Observação importanteImportante

    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 subseqüentes podem ser letras ou números conforme definido no padrão Unicode Standard 2.0 ou o sublinhado (_).

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