Gerenciador de conexões de arquivos simples

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

Um gerenciador de conexões de Arquivos Simples permite que um pacote acesse dados em um arquivo simples. Por exemplo, a origem e o destino dos Arquivos Simples podem usar gerenciadores de conexões de Arquivos Simples para extrair e carregar dados.

O gerenciador de conexões de arquivos simples pode acessar apenas um arquivo. Para consultar vários arquivos, utilize um gerenciador de conexões de vários arquivos simples em vez de um gerenciador de conexões de arquivos simples. Para obter mais informações, consulte Gerenciador de conexões de vários arquivos simples.

Comprimento da coluna

Por padrão, o gerenciador de conexões de arquivos simples define o comprimento das colunas de cadeia de caracteres como 50 caracteres. Na caixa de diálogo Editor do Gerenciador de Conexões de Arquivos Simples , você pode avaliar dados de exemplo e redimensionar automaticamente o comprimento dessas colunas para evitar truncamento dos dados ou excesso de largura da coluna. Além disso, a menos que você redimensione posteriormente o comprimento da coluna em uma origem de arquivo simples ou em uma transformação, o comprimento da coluna de cadeia de caracteres permanece o mesmo em todo o fluxo de dados. Se essas colunas de cadeia de caracteres forem mapeadas para colunas de destino que sejam menores, serão exibidos avisos na interface do usuário. Além disso, durante no tempo de execução, podem ocorrer erros devido ao truncamento de dados. Para evitar erros ou truncação, você pode redimensionar as colunas para corresponderem às colunas de destino no gerenciador de conexões de Arquivo Simples, na origem de Arquivo Simples ou em uma transformação. Para modificar o comprimento de colunas de saída, você define a propriedade Length da coluna de saída na guia Propriedades de Entrada e Saída na caixa de diálogo Editor Avançado .

Se você atualizar o comprimento das colunas no gerenciador de conexões de Arquivo Simples depois de adicionar e configurar a origem de Arquivo Simples que usa o gerenciador de conexões, não será necessário redimensionar manualmente as colunas de saída na origem de Arquivo Simples. Quando você abre a caixa de diálogo Origem de Arquivo Simples, a origem de arquivo simples oferece a opção de sincronizar os metadados das colunas.

Configuração do gerenciador de conexões de arquivo simples

Quando você adicionar um gerenciador de conexões de arquivos simples a um pacote, o SQL Server Integration Services criará um gerenciador de conexões que determinará uma conexão de arquivo simples no momento da execução, definirá suas propriedades e adicionará o gerenciador de conexões de arquivos simples à coleção Conexões do pacote.

A propriedade ConnectionManagerType do gerenciador de conexões é definida como FLATFILE.

Por padrão, o gerenciador de conexões de arquivos simples sempre verifica se há um delimitador de linha em dados sem aspas e inicia uma nova linha quando um delimitador de linha é localizado. Isso permite que o gerenciador de conexões analise corretamente arquivos com linhas que não têm campos de coluna.

Em alguns casos, desabilitar esse recurso pode melhorar o desempenho do pacote. Você pode desabilitar esse recurso definindo a propriedade do gerenciador de conexões de arquivos simples, AlwaysCheckForRowDelimiters, como False.

Você pode configurar um gerenciador de conexões de arquivos simples dos seguintes modos:

  • Especifique o arquivo, a localidade e a página de código que serão usados. A localidade é usada para interpretar dados sensíveis à localidade, como datas, e a página de código é usada para converter dados de texto em Unicode.

  • Especifique o formato de arquivo. Você pode usar um formato delimitado, de largura fixa ou irregular à direita.

  • Especifique uma linha de cabeçalho, fila de dados e delimitadores de coluna. Delimitadores de coluna podem ser definidos no nível de arquivo e ser sobrescritos no nível de coluna.

  • Indique se a primeira linha no arquivo contém os nomes das colunas.

  • Especifique um caractere de qualificador de texto. Cada coluna pode ser configurada para reconhecer um qualificador de texto.

    O uso de um caractere qualificador para inserir um caractere qualificador em uma cadeia de caracteres qualificada tem suporte de um Gerenciador de Conexões de arquivo simples. A instância dupla de um qualificador de texto é interpretada como uma instância literal única daquela cadeia de caracteres. Por exemplo, se o qualificador de texto for uma aspa simples e os dados de entrada forem 'abc', 'def', 'g'hi', os dados de saída serão abc, def, g'hi. No entanto, uma instância de um qualificador inserida em uma cadeia de caracteres qualificada faz com que a fonte de arquivo simples falhe com o erro DTS_E_PRIMEOUTPUTFAILED.

  • Defina as propriedades, como o nome, o tipo de dados e a largura máxima em colunas individuais.

Você pode definir a propriedade ConnectionString para o gerenciador de conexões de arquivos simples especificando uma expressão na janela Propriedades do SQL Server Data Tools (SSDT). Para evitar um erro de validação, siga as etapas abaixo.

  • Quando você usa uma expressão para especificar o arquivo, adiciona um caminho de arquivo na caixa Nome do Arquivo em Editor do Gerenciador de Conexões de Arquivos Simples.

  • Defina a propriedade DelayValidation no gerenciador de conexões de Arquivos Simples para True.

Você pode usar uma expressão para criar um nome de arquivo em tempo de execução usando o gerenciador de conexões de arquivo simples com o destino de arquivo simples.

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

Para obter informações sobre como configurar um gerenciador de conexões programaticamente, consulte ConnectionManager e Adicionando conexões programaticamente.

Editor do Gerenciador de Conexões de Arquivos Simples (página Geral)

Use a página Geral da caixa de diálogo Editor do Gerenciador de Conexões de Arquivos Simples para selecionar um arquivo e formato de dados. Uma conexão de arquivos simples habilita um pacote a conectar-se com um arquivo de texto.

Para obter mais informações sobre o gerenciador de conexão de arquivo simples, consulte Flat File Gerenciador de Conexões.

Opções

Nome do gerenciador de conexões
Forneça um nome exclusivo para a conexão de arquivos simples no fluxo de trabalho. O nome fornecido será exibido no Designer do SSIS .

Descrição
Descreva a conexão. Como prática recomendável, descreva a conexão em termos de objetivo, para tornar os pacotes autodocumentados e mais fáceis de manter.

Nome do arquivo
Digite o caminho e o nome do arquivo a ser usado na conexão de arquivos simples.

Navegar
Localize o nome do arquivo a ser usado na conexão de arquivos simples.

Localidade
Especifique a localidade para fornecer informações de idioma específicas para solicitações e formatos de data e hora.

Unicode
Indique se deve ser usado o Unicode. Se você usar o Unicode, não poderá especificar uma página de código.

Página de código
Especifique a página de código do texto não Unicode.

Formato
Indique se o arquivo usa formatação delimitada, de largura fixa ou com alinhamento irregular à direita.

Valor Descrição
Delimitado As colunas são separadas por delimitadores, especificados na página Colunas .
Largura fixa As colunas têm uma largura fixa.
Alinhado à esquerda Arquivos com margem direita irregular são arquivos em que todas as colunas têm largura fixa, exceto a última coluna. Ela é delimitada pelo delimitador de linha.

Qualificador de texto
Especifique o qualificador de texto a ser usado. Por exemplo, você pode especificar que os campos de texto fiquem entre aspas.

Observação

Depois de selecionar um qualificador de texto, você não pode selecionar a opção None . Digite None para anular a seleção do qualificador de texto.

Delimitador de linha de cabeçalho
Selecione na lista de delimitadores de linhas de cabeçalho ou digite o texto do delimitador.

Valor Descrição
{CR}{LF} A linha do cabeçalho é delimitada por uma combinação de retorno de carro e avanço de linha.
{CR} A linha do cabeçalho é delimitada por um retorno de carro.
{LF} A linha do cabeçalho é delimitada por um avanço de linha.
Ponto-e-vírgula {;} A linha do cabeçalho é delimitada por ponto e vírgula.
Dois-pontos {:} A linha de cabeçalho é delimitada por dois pontos.
Vírgula {,} A linha do cabeçalho é delimitada por uma vírgula.
Tabulação {t} A linha de cabeçalho é delimitada por uma tabulação.
Barra vertical {|} A linha do cabeçalho é delimitada por uma barra vertical.

Linhas de cabeçalho a ignorar
Especifique o número de linhas de cabeçalho ou linhas de dados iniciais a ignorar, caso existam.

Nomes de coluna na primeira linha de dados
Indique se deseja esperar ou fornecer nomes de coluna na primeira linha de dados.

Editor do Gerenciador de Conexões de Arquivo Simples (Página Colunas)

Use a página Colunas da caixa de diálogo Editor do Gerenciador de Conexão de Arquivo Simples para especificar as informações de linhas e colunas e visualizar o arquivo.

Para obter mais informações sobre o gerenciador de conexão de arquivo simples, consulte Flat File Gerenciador de Conexões.

Opções estáticas

Nome do gerenciador de conexões
Forneça um nome exclusivo para a conexão de Arquivo Simples no fluxo de trabalho. O nome fornecido será exibido no Designer do SSIS .

Descrição
Descreva a conexão. Como prática recomendável, descreva a conexão em termos de objetivo, para tornar os pacotes autodocumentados e mais fáceis de manter.

Opções dinâmicas do formato de arquivo simples

Formato = Delimitado

Delimitador de linha
Selecione na lista de delimitadores de linha disponíveis ou digite o texto delimitador.

Valor Descrição
{CR}{LF} As linhas são delimitadas por uma combinação de retorno de carro e alimentação de linha.
{CR} As linhas são delimitadas por um retorno de carro.
{LF} As linhas são delimitadas por um avanço de linha.
Ponto-e-vírgula {;} As linhas são delimitadas por um ponto e vírgula.
Dois-pontos {:} As linhas são delimitadas por dois-pontos.
Vírgula {,} As linhas são delimitadas por uma vírgula.
Tabulação {t} As linhas são delimitadas por uma tabulação.
Barra vertical {|} As linhas são delimitadas por uma barra vertical.

Delimitador de coluna
Selecione na lista de delimitadores de coluna disponíveis ou digite o texto delimitador.

Valor Descrição
{CR}{LF} As colunas são delimitadas por uma combinação de retorno de carro e alimentação de linha.
{CR} As colunas são delimitadas por um retorno de carro.
{LF} As colunas são delimitadas por uma alimentação de linha.
Ponto-e-vírgula {;} As colunas são delimitadas por um ponto e vírgula.
Dois-pontos {:} As colunas são delimitadas por um sinal de dois-pontos.
Vírgula {,} As colunas são delimitadas por uma vírgula.
Tabulação {t} As colunas são delimitadas por uma tabulação.
Barra vertical {|} As colunas são delimitadas por uma barra vertical.

Atualizar
Veja o efeito de alterar os delimitadores a ignorar clicando em Atualizar. Esse botão só ficará visível após você alterar outras opções de conexão.

Visualizar linhas
Exiba os dados de amostra do arquivo simples, dividido em colunas e linhas, usando as opções selecionadas.

Redefinir colunas
Remova todas as colunas, exceto as originais, clicando em Redefinir Colunas.

Formato = Largura fixa

Fonte
Selecione a fonte em que os dados de visualização serão exibidos.

Colunas de dados de origem
Ajuste a largura da linha deslizando o marcador de linha vertical vermelho e ajuste a largura das colunas clicando na régua na parte superior da janela de visualização

Largura da linha
Especifique o comprimento da linha antes de adicionar delimitadores para colunas individuais. Você também pode arrastar a linha vermelha vertical na janela de visualização para marcar o fim da linha. O valor de largura da linha é atualizado automaticamente.

Redefinir colunas
Remova todas as colunas, exceto as originais, clicando em Redefinir Colunas.

Formato = Alinhado à esquerda

Observação

Arquivos com margem direita irregular são arquivos em que todas as colunas têm largura fixa, exceto a última coluna. Ela é delimitada pelo delimitador de linha.

Fonte
Selecione a fonte em que os dados de visualização serão exibidos.

Colunas de dados de origem
Ajuste a largura da linha deslizando o marcador de linha vertical vermelho e ajuste a largura das colunas clicando na régua na parte superior da janela de visualização

Delimitador de linha
Selecione na lista de delimitadores de linha disponíveis ou digite o texto delimitador.

Valor Descrição
{CR}{LF} As linhas são delimitadas por uma combinação de retorno de carro e alimentação de linha.
{CR} As linhas são delimitadas por um retorno de carro.
{LF} As linhas são delimitadas por um avanço de linha.
Ponto-e-vírgula {;} As linhas são delimitadas por um ponto e vírgula.
Dois-pontos {:} As linhas são delimitadas por dois-pontos.
Vírgula {,} As linhas são delimitadas por uma vírgula.
Tabulação {t} As linhas são delimitadas por uma tabulação.
Barra vertical {|} As linhas são delimitadas por uma barra vertical.

Redefinir colunas
Remova todas as colunas, exceto as originais, clicando em Redefinir Colunas.

Editor do Gerenciador de Conexões de Arquivos Simples (página Avançado)

Use a página Avançado da caixa de diálogo Editor do Gerenciador de Conexões de Arquivos Simples para definir propriedades que especificam como o Integration Services lê e grava dados em arquivos simples. Você pode alterar os nomes das colunas no arquivo simples e definir propriedades que incluem tipo de dados e delimitadores em cada coluna no arquivo.

Por padrão, o tamanho da coluna de cadeia de caracteres é de 50 caracteres. Você pode redimensionar o tamanho dessas colunas para prevenir truncamento de dados ou excesso de largura nas colunas. Também é possível atualizar outros metadados para habilitar a compatibilidade com as colunas de destino. Por exemplo, você pode alterar o tipo de dados de uma coluna que contém apenas dados inteiros para um tipo de dados numérico, como DT_I2. Você pode fazer essas modificações manualmente ou clicar no botão Selecionar Tipos para usar a caixa de diálogo Sugerir Tipos de Coluna para avaliar dados de amostra e tornar automáticas algumas dessas alterações.

Para obter mais informações sobre o gerenciador de conexão de arquivo simples, consulte Flat File Gerenciador de Conexões.

Opções

Nome do gerenciador de conexões
Forneça um nome exclusivo para o gerenciador de conexões de arquivo simples no fluxo de trabalho. O nome fornecido será exibido no Designer do SSIS .

Descrição
Descreva o gerenciador de conexões. Como prática recomendável, descreva o gerenciador de conexões em termos de objetivo, para tornar os pacotes autodocumentados e mais fáceis de manter.

Configurar as propriedades de cada coluna
Selecione uma coluna no painel esquerdo para exibir suas propriedades no painel direito. Consulte a tabela a seguir para obter uma descrição das propriedades dos tipos de dados. Algumas das propriedades listadas são configuráveis apenas para alguns formatos de arquivo simples.

Propriedade Descrição
ColumnType Denota se a coluna é delimitada, de largura fixa ou com imperfeição à direita. Essa propriedade é somente leitura. Arquivos com margem direita irregular são arquivos em que todas as colunas têm largura fixa, exceto a última coluna. Ela é delimitada pelo delimitador de linha.
OutputColumnWidth Especifique um valor a ser armazenado como contagem de bytes; para arquivos Unicode, esse valor corresponde a uma contagem de caracteres. Na tarefa Fluxo de Dados, esse valor é usado para definir a largura de coluna de saída para a fonte de Arquivo Simples. No modelo de objeto, o nome desta propriedade é MaximumWidth.
tipo de dado Seleciona na lista de tipos de dados disponíveis. Para obter mais informações, consulte Integration Services Data Types.
TextQualified Indique se os dados de texto são delimitados por caracteres qualificadores de texto, como aspas.

True: os dados de texto no arquivo simples são qualificados. False: os dados de texto no arquivo simples NÃO são qualificados.
Nome Forneça um nome de coluna descritivo. Se você não digitar um nome, o Integration Services criará um nome automaticamente, no formato Coluna 0, Coluna 1 e assim por diante.
DataScale Especifica a escala de dados numéricos. A escala se refere ao número de casas decimais. Para obter mais informações, consulte Integration Services Data Types.
ColumnDelimiter Seleciona na lista de delimitadores de coluna disponíveis. Escolha delimitadores que provavelmente não ocorram no texto. Esse valor é ignorado para colunas de largura fixa.

{CR}{LF} . As colunas são delimitadas por uma combinação de retorno de carro e alimentação de linha.

{CR} . As colunas são delimitadas por um retorno de carro.

{LF} . As colunas são delimitadas por uma alimentação de linha.

Ponto e vírgula {;}. As colunas são delimitadas por um ponto e vírgula.

Dois pontos {:}. As colunas são delimitadas por um sinal de dois-pontos.

Vírgula {,} . As colunas são delimitadas por uma vírgula.

Tab {t}. As colunas são delimitadas por uma tabulação.

Barra vertical {|}. As colunas são delimitadas por uma barra vertical.
DataPrecision Especifica a precisão de dados numéricos. A precisão se refere ao número de dígitos. Para obter mais informações, consulte Integration Services Data Types.
LarguraDaColunaDeEntrada Especifica um valor a ser armazenado como contagem de bytes; no caso de arquivos Unicode, isso será exibido como contagem de caracteres. Este valor é ignorado nas colunas delimitadas.

Observação No modelo de objeto, o nome desta propriedade é ColumnWidth.

Novo
Adicione uma nova coluna, clicando em Nova. Por padrão, o botão Nova adiciona uma nova coluna ao final da lista. O botão também oferece as seguintes opções, disponíveis na lista suspensa.

Valor Descrição
Adicionar Coluna Adicione uma nova coluna ao final da lista.
Inserir Antes Insere uma nova coluna antes da coluna selecionada.
Inserir Depois Insere uma nova coluna depois da coluna selecionada.

Delete (excluir)
Selecione uma coluna e remova-a, clicando em Excluir.

Sugerir Tipos
Use a caixa de diálogo Sugerir Tipos de Coluna para avaliar dados de amostra no arquivo e obter sugestões de tipo de dados e tamanho de cada coluna. Para obter mais informações, consulte Referência da interface do usuário da caixa de diálogo Sugerir Tipos de Coluna.

Editor do Gerenciador de Conexão de Arquivo Simples (Página de Visualização)

Use o nó Visualização da caixa de diálogo Editor do Gerenciador de Conexões de Arquivos Simples para exibir os conteúdos do arquivo de origem em um formato tabular.

Para obter mais informações sobre o gerenciador de conexão de arquivo simples, consulte Flat File Gerenciador de Conexões.

Opções

Nome do gerenciador de conexões
Forneça um nome exclusivo para a conexão de Arquivo Simples no fluxo de trabalho. O nome fornecido será exibido no Designer do SSIS .

Descrição
Descreva a conexão. Como prática recomendável, descreva a conexão em termos de objetivo, para tornar os pacotes autodocumentados e mais fáceis de manter.

Linhas de dados a ignorar
Especifique quantas linhas serão ignoradas no início do arquivo simples.

Atualizar
Exiba o efeito de alterar o número de linhas a ignorar, clicando em Atualizar. Esse botão só ficará visível após você alterar outras opções de conexão.

Visualizar linhas
Exiba os dados no arquivo simples, dividido em colunas e linhas, de acordo com as opções que você selecionou.

  • Last updated on