Partilhar via

Transformação da Coluna de Exportação

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

A transformação Export Column lê dados num fluxo de dados e insere os dados num ficheiro. Por exemplo, se o fluxo de dados contiver informação do produto, como uma imagem de cada produto, pode usar a transformação Exportar Coluna para guardar as imagens em ficheiros.

Adicionar e Truncar Opções

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

Append Truncar O arquivo existe Results
Falso Falso Não A transformação cria um novo ficheiro e escreve os dados no ficheiro.
Verdade Falso Não A transformação cria um novo ficheiro e escreve os dados no ficheiro.
Falso Verdade Não A transformação cria um novo ficheiro e escreve os dados no ficheiro.
Verdade Verdade Não A transformação falha na validação em tempo de projeto. Não é válido definir ambas as propriedades como verdadeiras.
Falso Falso Yes Ocorre um erro em tempo de execução. O ficheiro existe, mas a transformação não consegue escrever nele.
Falso Verdade Yes A transformação apaga e recria o ficheiro e grava os dados no ficheiro.
Verdade Falso Yes A transformação abre o ficheiro e escreve os dados no final do ficheiro.
Verdade Verdade Yes A transformação falha na validação em tempo de projeto. Não é válido definir ambas as propriedades como verdadeiras.

Configuração da Transformação da Coluna de Exportação

Pode configurar a transformação da Coluna de Exportação das seguintes formas:

  • Especifique as colunas de dados e as colunas que contêm o caminho dos ficheiros para onde escrever os dados.

  • Especifique se a operação de inserção de dados acrescenta ou trunca ficheiros existentes.

  • Especifique se uma marca de ordem de bytes (BOM) é escrita no ficheiro.

    Observação

    Uma BOM é escrita apenas quando os dados não são anexados a um ficheiro existente e os dados têm o tipo de dados DT_NTEXT.

A transformação utiliza pares de colunas de entrada: uma coluna contém um nome de ficheiro e a outra coluna contém dados. Cada linha do conjunto de dados pode especificar um ficheiro diferente. À medida que a transformação processa uma linha, os dados são inseridos no ficheiro especificado. Em tempo de execução, a transformação cria os ficheiros, caso ainda não existam, e depois a transformação escreve os dados nos ficheiros. Os dados a escrever devem ter um tipo de dado DT_TEXT, DT_NTEXT ou DT_IMAGE. Para obter mais informações, consulte Tipos de dados do Integration Services.

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

Editor de Transformação de Colunas para Exportação (Página de Colunas)

Use a página Colunas da caixa de diálogo Export Column Transformation Editor para especificar colunas no fluxo de dados a extrair para ficheiros. Pode especificar se a transformação da Coluna de Exportação acrescenta dados a um ficheiro ou sobrescreve um ficheiro existente.

Opções

Coluna de Excertos
Selecione da lista de colunas de entrada que contenham texto ou dados de imagem. Todas as linhas devem ter definições para Extrair Coluna e Coluna de Caminho de Ficheiro.

Coluna do Caminho do Ficheiro
Selecione da lista de colunas de entrada que contenham caminhos e nomes de ficheiros. Todas as linhas devem ter definições para Coluna de Extração e Coluna de Caminho de Ficheiro.

Permitir Anexar
Especifique se a transformação adiciona dados a ficheiros existentes. O padrão é false.

Forçar Truncamento
Especifique se a transformação elimina o conteúdo dos ficheiros existentes antes de escrever os dados. O padrão é false.

Escrever BOM
Especifique se deve escrever uma marca de ordem de bytes (BOM) no ficheiro. Um BOM só é escrito se os dados tiverem o tipo de dados DT_NTEXT ou DT_WSTR e não forem anexados a um ficheiro de dados existente.

Editor de Transformação de Colunas de Exportação (Página de Resultado de Erro)

Use a página Saída de Erros da caixa de diálogo do Editor de Transformação de Exportação de Coluna para especificar como lidar com erros.

Opções

de entrada/saída
Verifique o nome do resultado. Clique no nome para expandir a vista e incluir colunas.

Coluna
Veja as colunas de saída que selecionou na página Colunas da caixa de diálogo Editor de Transformação de Colunas de Exportação.

Error
Especifica o que queres que aconteça se ocorrer um erro: ignora a falha, redireciona a linha ou falha o componente.

Truncamento
Especifica o que queres que aconteça se ocorrer um truncamento: ignora a falha, redireciona a linha ou falha o componente.

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

Defina esse valor para células selecionadas
Especifique o que deve acontecer com todas as células selecionadas quando ocorrer um erro ou truncamento: ignore a falha, redirecione a linha ou falhe o componente.

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

  • Last updated on