Partilhar via


Transformação de Coluna Derivada

Aplica-se a:SQL Server SSIS Integration Runtime em Azure Data Factory

A transformação Coluna Derivada cria novos valores de coluna ao aplicar expressões às colunas de entrada da transformação. Uma expressão pode conter qualquer combinação de variáveis, funções, operadores e colunas da entrada da transformação. O resultado pode ser adicionado como uma nova coluna ou inserido numa coluna existente como valor de substituição. A transformação de Coluna Derivada pode definir múltiplas colunas derivadas, e qualquer variável ou coluna de entrada pode aparecer em múltiplas expressões.

Pode usar esta transformação para realizar as seguintes tarefas:

  • Concatene dados de diferentes colunas numa coluna derivada. Por exemplo, pode combinar valores das colunas Primeiro Nome e Apelido numa única coluna derivada chamada Nome Completo, usando a expressão FirstName + " " + LastName.

  • Extrai caracteres dos dados da cadeia usando funções como SUBSTRING, e depois armazena o resultado numa coluna derivada. Por exemplo, pode extrair a inicial de uma pessoa a partir da coluna Primeiro Nome , usando a expressão SUBSTRING(FirstName,1,1).

  • Aplicar funções matemáticas a dados numéricos e armazenar o resultado numa coluna derivada. Por exemplo, pode alterar o comprimento e a precisão de uma coluna numérica, SalesTax, para um número com duas casas decimais, usando a expressão ROUND(SalesTax, 2).

  • Crie expressões que comparem colunas e variáveis de entrada. Por exemplo, pode comparar a variável Version com os dados na coluna ProductVersion e, dependendo do resultado da comparação, usar o valor de Version ou ProductVersion, usando a expressão ProductVersion == @Version? ProductVersion : @Version.

  • Extrai partes de um valor de data-hora. Por exemplo, pode usar as funções GETDATE e DATEPART para extrair o ano atual, usando a expressão DATEPART("year",GETDATE()).

  • Converta cadeias de data para um formato específico usando uma expressão.

Configuração da transformação de coluna derivada

Pode configurar a transformação da coluna Derivada das seguintes formas:

  • Forneça uma expressão para cada coluna de entrada ou nova coluna que será alterada. Para obter mais informações, consulte Expressões dos Serviços de Integração (SSIS).

    Observação

    Se uma expressão faz referência a uma coluna de entrada que é sobrescrevida pela transformação da Coluna Derivada, a expressão utiliza o valor original da coluna, não o valor derivado.

  • Se adicionar resultados a novas colunas e o tipo de dado for string, especifique uma página de código. Para mais informações, consulte Comparando Dados de Strings.

A transformação da Coluna Derivada inclui a propriedade personalizada FriendlyExpression. Essa propriedade pode ser atualizada por uma expressão de propriedade quando o pacote é carregado. Para mais informações, veja Usar Expressões de Propriedades em Pacotes e Propriedades Personalizadas de Transformação.

Esta transformação tem uma entrada, uma saída regular e uma saída de erro.

Você pode definir propriedades por meio do SSIS Designer ou programaticamente.

A caixa de diálogo Advanced Editor reflete as propriedades que podem ser definidas programaticamente. Para obter mais informações sobre as propriedades que você pode definir na caixa de diálogo Advanced Editor ou programaticamente, clique em um dos seguintes tópicos:

Para obter mais informações sobre como definir propriedades, clique em um dos seguintes tópicos:

Editor de Transformação de Colunas Derivadas

Use a caixa de diálogo Editor de Transformação de Colunas Derivadas para criar expressões que preencham colunas novas ou de substituição.

Opções

Variáveis e Colunas
Construa uma expressão que utilize uma variável ou uma coluna de entrada arrastando a variável ou coluna da lista de variáveis e colunas disponíveis para uma linha de tabela existente no painel abaixo, ou para uma nova linha no final da lista.

Funções e Operadores
Construa uma expressão que use uma função ou um operador para avaliar dados de entrada e dados de saída direta, arrastando funções e operadores da lista para o painel abaixo.

Nome da Coluna Derivada
Forneça um nome de coluna derivada. O padrão é uma lista numerada de colunas derivadas; No entanto, pode escolher qualquer nome único e descritivo.

Coluna derivada
Selecione uma coluna derivada da lista. Escolha se adiciona a coluna derivada como nova coluna de saída, ou substitui os dados numa coluna existente.

Expressão
Tipa uma expressão ou construa-a arrastando da lista anterior de colunas, variáveis, funções e operadores disponíveis.

O valor dessa propriedade pode ser especificado usando uma expressão de propriedade.

Tópicos relacionados: Expressões de Serviços de Integração (SSIS), Operadores (SSIS Expression) e Funções (SSIS Expression)

Tipo de Dados
Ao adicionar dados a uma nova coluna, a caixa de diálogo Derived Column TransformationEditor avalia automaticamente a expressão e define o tipo de dado de forma adequada. O valor desta coluna é só de leitura. Para obter mais informações, consulte Tipos de dados do Integration Services.

Comprimento
Ao adicionar dados a uma nova coluna, a caixa de diálogo Derived Column TransformationEditor avalia automaticamente a expressão e define automaticamente o comprimento da coluna para dados de texto. O valor desta coluna é somente de leitura.

Precision
Se adicionar dados a uma nova coluna, a caixa de diálogo Derived Column TransformationEditor define automaticamente a precisão dos dados numéricos com base no tipo de dado. O valor desta coluna é só de leitura.

Scale
Se adicionar dados a uma nova coluna, a caixa de diálogo Editor de Transformação da Coluna Derivada define automaticamente a escala para dados numéricos com base no tipo de dado. O valor desta coluna é só de leitura.

Página de código
Ao adicionar dados a uma nova coluna, a caixa de diálogo Editor de Transformação da Coluna Derivada define automaticamente a página de código para o tipo de dado DT_STR. Pode atualizar a Página de Códigos.

Configurar saída de erro
Especifique como lidar com erros usando a caixa de diálogo Configurar Saída de Erro .