Partilhar via


Fonte de arquivo simples

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

A fonte Arquivo Plano lê dados de um arquivo de texto. O arquivo de texto pode ser em formato delimitado, de largura fixa ou misto.

  • O formato delimitado usa delimitadores de coluna e linha para definir colunas e linhas.

  • O formato de largura fixa usa a largura para definir colunas e linhas. Esse formato também inclui um caractere para preencher campos em sua largura máxima.

  • O formato irregular à direita usa a largura para definir todas as colunas, exceto a última coluna, que é delimitada pelo delimitador de linha.

Você pode configurar a fonte de arquivo plano das seguintes maneiras:

  • Adicione uma coluna à saída de transformação, que contenha o nome do arquivo de texto do qual a fonte de Arquivo Plano extrai dados.

  • Especifique se a origem do arquivo simples interpreta cadeias de caracteres de comprimento zero em colunas como valores nulos.

    Observação

    O gestor de ligações de ficheiro flat que a fonte de ficheiro flat usa deve ser configurado para usar um formato delimitado para interpretar cadeias de comprimento zero como nulas. Se o gestor de ligações usar formatos de largura fixa ou alinhamento à direita irregular, os dados que compõem-se de espaços não poderão ser interpretados como valores nulos.

As colunas de saída da fonte Flat File incluem a propriedade FastParse. O FastParse indica se a coluna usa as rotinas de análise mais rápidas, mas sem distinção de localidade, que o Integration Services fornece ou as rotinas de análise padrão sensíveis à localidade. Para obter mais informações, consulte Fast Parse e Standard Parse.

As colunas de saída também incluem a propriedade UseBinaryFormat. Use essa propriedade para implementar suporte para dados binários, como dados com o formato decimal compactado, em arquivos. Por padrão, UseBinaryFormat é definido como false. Se você quiser usar um formato binário, defina UseBinaryFormat como true e o tipo de dados na coluna de saída como DT_BYTES. Quando fizer isso, a fonte de ficheiro plano ignora a conversão de dados e passa os dados para a coluna de saída tal como está. Em seguida, você pode usar uma transformação, como a Coluna Derivada ou a Conversão de Dados, para converter os dados DT_BYTES para um tipo de dados diferente, ou pode escrever um script personalizado em uma transformação de Script para interpretar os dados. Você também pode escrever um componente de fluxo de dados personalizado para interpretar os dados. Para obter mais informações sobre os tipos de dados para os quais é possível converter DT_BYTES, consulte Cast (Expressão SSIS).

Esta fonte usa um gestor de ligações de ficheiro plano para aceder ao ficheiro de texto. Ao definir propriedades no gerenciador de conexões de arquivo simples, você pode fornecer informações sobre o arquivo e cada coluna nele e especificar como a fonte de arquivo simples deve lidar com os dados no arquivo de texto. Por exemplo, você pode especificar os caracteres que delimitam colunas e linhas no arquivo, bem como o tipo de dados e o comprimento de cada coluna. Para obter mais informações, consulte Flat File Connection Manager.

Esta fonte tem uma saída e uma saída de erro.

Configuração da fonte de arquivo plano

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 detalhes sobre como definir propriedades de um componente de fluxo de dados, consulte Definir as propriedades de um componente de fluxo de dados.

Editor de fonte de arquivo simples (página Gerenciador de conexões)

Use a página do Gerenciador de Conexões da caixa de diálogo Editor de Fonte de Arquivo Simples do para selecionar o gerenciador de conexões que a fonte de Arquivo Simples usará. A fonte Arquivo Plano lê dados de um arquivo de texto, que pode estar num formato delimitado, de largura fixa ou misto.

Uma fonte de arquivo simples pode usar um dos seguintes tipos de gerenciadores de conexões:

  • Um gerenciador de conexões de arquivo simples se a origem for um único arquivo simples. Para mais informações, consulte Flat File Connection Manager.

  • Um gestor de conexões para múltiplos ficheiros de texto plano se a origem forem vários ficheiros de texto plano e a tarefa de fluxo de dados estiver dentro de um contêiner de ciclo, como o contêiner For Loop. Em cada ciclo do contêiner, a fonte de ficheiro plano carrega dados do próximo nome de ficheiro fornecido pelo gestor de ligações para múltiplos ficheiros planos. Para obter mais informações, consulte Multiple Flat Files Connection Manager.

Opções

Gerenciador de conexões de arquivo simples
Selecione um gerenciador de conexões existente na lista ou crie um novo gerenciador de conexões clicando em Novo.

Nova
Crie um novo gerenciador de conexões usando a caixa de diálogo Flat File Connection Manager Editor.

Reter valores nulos da origem como valores nulos no fluxo de dados
Especifique se os valores nulos devem ser mantidos quando os dados forem extraídos. O valor padrão dessa propriedade é false. Quando este valor é falso, a fonte de dados do ficheiro plano substitui valores nulos dos dados de origem por valores padrão apropriados para cada coluna, como strings vazias para colunas de texto e zero para colunas numéricas.

Pré-visualização
Visualize os resultados usando a caixa de diálogo Modo de Exibição de Dados . A pré-visualização pode apresentar até 200 linhas.

Editor de Fonte de Ficheiro Plano (Página Colunas)

Use o nó Colunas da caixa de diálogo Editor de Origem de Ficheiro Plano para mapear uma coluna de saída para cada coluna externa (origem).

Observação

A propriedade FileNameColumnName da fonte Flat File e a propriedade FastParse de suas colunas de saída não estão disponíveis no Flat File Source Editor, mas podem ser definidas usando o Advanced Editor. Para obter mais informações sobre essas propriedades, consulte a seção Fonte de arquivo simples de Propriedades personalizadas de arquivo simples.

Opções

Colunas externas disponíveis
Exiba a lista de colunas externas disponíveis na fonte de dados. Não é possível usar esta tabela para adicionar ou excluir colunas.

Coluna Externa
Exiba colunas externas (fonte) na ordem em que a tarefa as lerá. Você pode alterar essa ordem limpando primeiro as colunas selecionadas na tabela e, em seguida, selecionando colunas externas da lista em uma ordem diferente.

Coluna de saída
Forneça um nome exclusivo para cada coluna de saída. O padrão é o nome da coluna externa (fonte) selecionada; no entanto, você pode escolher qualquer nome exclusivo e descritivo. O nome fornecido será exibido no SSIS Designer.

Editor de fonte de arquivo simples (página de saída de erro)

Use a página de saída de erro da caixa de diálogo Editor de fonte de arquivo simples para selecionar opções de tratamento de erros e definir propriedades em colunas de saída de erro.

Opções

de entrada/saída
Exiba o nome da fonte de dados.

Coluna
Exiba as colunas externas (origem) que selecionou na página Gerenciador de Conexões da caixa de diálogo Editor de Fonte de Arquivo Simples.

Erro
Especifique o que deve acontecer quando ocorrer um erro: ignore a falha, redirecione a linha ou falhe o componente.

Tópicos relacionados:Tratamento de erros em dados

Truncamento
Especifique o que deve acontecer quando ocorrer um truncamento: ignorar a falha, redirecionar a linha ou provocar a falha do componente.

Descrição
Veja a descrição do erro.

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.

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

Ver também

Destino de Arquivo Plano
fluxo de dados