Transformação Coluna Derivada

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

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

É possível usar essa transformação para executar as seguintes tarefas:

  • Concatenar dados de colunas diferentes em uma coluna derivada. Por exemplo, você pode combinar valores das colunas FirstName e LastName em uma única coluna derivada chamada FullNameusando a expressão FirstName + " " + LastName.

  • Extrair caracteres de dados de cadeia de caracteres utilizando funções, como SUBSTRING, e armazenar o resultado em uma coluna derivada. Por exemplo, é possível extrair a inicial de uma pessoa da coluna FirstName utilizando a expressão SUBSTRING(FirstName,1,1).

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

  • Criar expressões que comparam colunas de entrada e variáveis. Por exemplo, você pode comparar a variável Version com os dados na coluna ProductVersione, dependendo do resultado da comparação, utilizar o valor de Version ou de ProductVersionutilizando a expressão ProductVersion == @Version? ProductVersion : @Version.

  • Extrair partes de um valor de data e hora. Por exemplo, você pode usar as funções GETDATE e DATEPART para extrair o ano atual por meio da expressão DATEPART("year",GETDATE()).

  • Converta cadeias de caracteres de dados em um formato específico usando uma expressão.

Configuração da transformação Coluna Derivada

Você pode configurar a transformação Coluna Derivada das seguintes maneiras:

  • Forneça uma expressão para cada coluna de entrada ou coluna nova a ser alterada. Para saber mais, confira Expressões do Integration Services (SSIS).

    Observação

    Se uma expressão fizer referência a uma coluna de entrada substituída pela transformação Coluna Derivada, a expressão utilizará o valor original da coluna e não o valor derivado.

  • Se estiver adicionando resultados às novas colunas e o tipo de dados for string, especifique uma página de código. Para obter mais informações, consulte Comparing String Data.

A transformação Coluna Derivada inclui a propriedade personalizada FriendlyExpression. Essa propriedade pode ser atualizada por uma expressão de propriedade quando o pacote é carregado. Para obter mais informações, consulte Usar expressões de propriedade em pacotese Propriedades personalizadas da transformação.

Essa transformação tem uma entrada, uma saída comum e uma saída de erro.

Você pode definir propriedades pelo Designer do SSIS ou programaticamente.

A caixa de diálogo Editor Avançado reflete as propriedades que podem ser definidas programaticamente. Para obter mais informações sobre as propriedades que podem ser definidas na caixa de diálogo Editor Avançado 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 Colunas Derivadas

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

Opções

Variáveis e Colunas
Crie uma expressão que use 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 linha nova no final da lista.

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

Nome de Coluna Derivada
Forneça um nome de coluna derivada. O padrão é uma lista numerada de colunas derivadas; no entanto, é possível escolher qualquer nome descritivo exclusivo.

Coluna Derivada
Selecione uma coluna derivada da lista. Escolha se deseja adicionar a coluna derivada como uma nova coluna de saída ou substituir os dados em uma coluna existente.

Expression
Digite uma expressão ou compile uma arrastando da lista anterior de colunas, variáveis, funções e operadores disponíveis.

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

Tópicos relacionados: Expressões do Integration Services (SSIS), Operadores (Expressão do SSIS) e Funções (Expressão do SSIS)

Tipo de Dados
Se acrescentar dados a uma nova coluna, a caixa de diálogo TransformationEditor de Coluna Derivada avaliará a expressão automaticamente e definirá o tipo de dados adequadamente. O valor desta coluna é somente leitura. Para obter mais informações, consulte Integration Services Data Types.

Comprimento
Se acrescentar dados a uma nova coluna, a caixa de diálogo TransformationEditor de Coluna Derivada avaliará a expressão automaticamente e definirá a largura de coluna para os dados da cadeia de caracteres. O valor desta coluna é somente leitura.

Precisão
Se acrescentar dados a uma nova coluna, a caixa de diálogo TransformationEditor de Coluna Derivada automaticamente definirá a precisão de dados numéricos com base no tipo de dados. O valor desta coluna é somente leitura.

Escala
Se acrescentar dados a uma nova coluna, a caixa de diálogo TransformationEditor de Coluna Derivada automaticamente definirá a escala dos dados numéricos com base no tipo de dados. O valor desta coluna é somente leitura.

Página de Código
Se acrescentar dados a uma nova coluna, a caixa de diálogo TransformationEditor de Coluna Derivada automaticamente definirá a página de código para o tipo de dados DT_STR. Será possível atualizar a Página de Código.

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