Transformação Exportar Colunas

  • Artigo

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

A transformação Exportar Coluna lê dados em um fluxo de dados e os insere em um arquivo. Por exemplo, se o fluxo de dados contiver informações de produtos, como uma imagem de cada produto, você poderá usar a transformação Exportar Coluna para salvar essas imagens em arquivos.

Opções de anexar e truncar

A tabela seguinte descreve como as definições das opções anexar e truncar afetam os resultados.

Acrescentar Truncate O arquivo existe Resultados
Falso Falso Não A transformação cria um novo arquivo e grava os dados nele.
True Falso Não A transformação cria um novo arquivo e grava os dados nele.
Falso True Não A transformação cria um novo arquivo e grava os dados nele.
True True Não A transformação falha na validação do tempo de design. Ela não é válida para definir ambas as propriedades como true.
Falso Falso Sim Ocorre um erro em tempo de execução. O arquivo existe, mas a transformação não pode ser gravada nele.
Falso True Sim A transformação exclui e recria o arquivo e grava os dados nele.
True Falso Sim A transformação abre o arquivo e grava os dados no final do arquivo.
True True Sim A transformação falha na validação do tempo de design. Ela não é válida para definir ambas as propriedades como true.

Configuração da transformação Exportar Coluna

Pode-se configurar a transformação Exportar Coluna com os seguintes procedimentos:

  • Especifique as colunas de dados e as colunas que contêm o caminho dos arquivos onde os dados são gravados.

  • Especificar se a operação de inserção de dados anexa ou trunca arquivos existentes.

  • Especificar se uma BOM (marca de ordem de byte) é gravada no arquivo.

    Observação

    Uma BOM só é gravada quando os dados não são anexados a um arquivo existente e eles são do tipo DT_NTEXT.

A transformação usa pares de colunas de entrada; uma coluna contém um nome de arquivo e a outra contém os dados. Cada linha no conjunto de dados pode especificar um arquivo diferente. Como a transformação processa uma linha, os dados são inseridos no arquivo especificado. No tempo de execução, a transformação cria os arquivos caso eles ainda não existam e, posteriormente, grava os dados nos arquivos. Os dados a serem gravados devem ser do tipo DT_TEXT, DT_NTEXT ou DT_IMAGE. Para obter mais informações, consulte Integration Services Data Types.

Essa transformação tem uma entrada, uma saída 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 as propriedades, consulte Definir as propriedades de um componente de fluxo de dados.

Editor de Transformação Exportar Colunas (página Colunas)

Use a página Colunas da caixa de diálogo Exportar Editor de Transformação Colunas para especificar as colunas no fluxo de dados a serem extraídas para arquivos. Você pode especificar se a transformação Exportar Coluna acrescenta dados a um arquivo ou substitui um arquivo existente.

Opções

Extrair Coluna
Selecione na lista de colunas de entrada que contêm dados de texto ou de imagem. Todas as linhas devem ter definições para Extrair Coluna e Coluna de Caminho de Arquivos.

Coluna de Caminho de Arquivos
Selecione na lista de colunas de entrada que contêm caminhos e nomes de arquivo. Todas as linhas devem ter definições para Extrair Coluna e Coluna de Caminho de Arquivos.

Permitir Acréscimo
Especifique se a transformação acrescenta dados a arquivos existentes. O padrão é false.

Forçar Truncamento
Especifique se a transformação exclui o conteúdo dos arquivos existentes antes de gravar dados. O padrão é false.

Gravar BOM
Especifique se deve ser gravada uma BOM (marca de ordem de byte) no arquivo. Uma BOM só será gravada se os dados forem do tipo DT_NTEXT ou DT_WSTR e não estiverem anexados a um arquivo de dados existente.

Exportar Editor de Transformação Colunas (página Saída de Erro)

Use a página Saída de Erro da caixa de diálogo do Editor de Transformação Exportar Colunas para especificar como manipular os erros.

Opções

Entrada/Saída
Visualize o nome da saída. Clique no nome para expandir a exibição a fim de incluir colunas.

Coluna
Exiba as colunas de saída que você selecionou na página Colunas da caixa de diálogo Editor de Transformação Exportar Colunas .

Erro
Especifique o que deve acontecer se ocorrer um erro: ignorar a falha, redirecionar a linha ou causar falha do componente.

Truncation
Especifique o que deve acontecer se ocorrer um truncamento: ignorar a falha, redirecionar a linha ou causar falha do componente.

Descrição
Visualize a descrição da operação.

Definir este valor para células selecionadas
Especifique o que deve acontecer a todas as células selecionadas quando ocorre um erro ou um truncamento: ignorar a falha, redirecionar a linha ou causar a falha no componente.

Aplicar
Aplique a opção de tratamento de erros às células selecionadas.