Partilhar via

Gerenciador de conexões de arquivo simples

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

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

O gerenciador de conexões Flat File pode acessar apenas um arquivo. Para referenciar vários arquivos, use um gestor de conexões de múltiplos arquivos planos em vez de um gestor de conexões de arquivo plano. Para obter mais informações, consulte Multiple Flat Files Connection Manager.

Comprimento da coluna

Por padrão, o gerenciador de conexões de arquivo 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 Arquivo Simples , você pode avaliar dados de exemplo e redimensionar automaticamente o comprimento dessas colunas para evitar truncamento de dados ou excesso de largura da coluna. Além disso, a menos que você redimensione posteriormente o comprimento da coluna em uma fonte de arquivo simples ou em uma transformação, o comprimento da coluna da cadeia de caracteres permanece o mesmo durante todo o fluxo de dados. Se essas colunas de cadeia de caracteres forem mapeadas para colunas de destino mais estreitas, os avisos aparecerão na interface do usuário. Além disso, em tempo de execução, erros podem ocorrer devido ao truncamento de dados. Para evitar erros ou truncamento, pode-se redimensionar as colunas para serem compatíveis com as colunas de destino no gestor de ligações Ficheiro Plano, a fonte Ficheiro Plano ou uma transformação. Para modificar o comprimento das colunas de saída, defina 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 os comprimentos das colunas no gerenciador de conexões de arquivo simples depois de adicionar e configurar a fonte de arquivo simples que usa o gerenciador de conexões, não será necessário redimensionar manualmente as colunas de saída na fonte de arquivo simples. Quando você abre a caixa de diálogo Fonte de arquivo simples , a fonte de arquivo simples fornece uma opção para sincronizar os metadados da coluna.

Configuração do Flat File Connection Manager

Quando você adiciona um gerenciador de conexões de Arquivo Simples a um pacote, o SQL Server Integration Services cria um gerenciador de conexões que será resolvido para uma conexão de Arquivo Simples em tempo de execução, define as propriedades de conexão de Arquivo Simples e adiciona o gerenciador de conexões de Arquivo Simples à coleção Connections do pacote.

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

Por padrão, o gerenciador de conexões de arquivo simples sempre verifica se há um delimitador de linha em dados não citados e inicia uma nova linha quando um delimitador de linha é encontrado. Isso permite que o gestor de conexões analise corretamente os arquivos com linhas em que faltam campos de coluna.

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

Você pode configurar o gestor de conexões de arquivo plano das seguintes formas:

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

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

  • Especifique uma linha de cabeçalho, linha de dados e delimitadores de coluna. Os delimitadores de coluna podem ser definidos no nível do arquivo e substituídos no nível da coluna.

  • Indique se a primeira linha do arquivo contém nomes de coluna.

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

    O uso de um caractere qualificador para incorporar um caractere qualificador em uma cadeia de caracteres qualificada é suportado pelo Gerenciador de Conexões de Arquivo Simples. A instância dupla de um qualificador de texto é interpretada como uma instância literal e única dessa cadeia de caracteres. Por exemplo, se o qualificador de texto for uma única citação 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 incorporado em uma cadeia de caracteres qualificada faz com que a fonte de arquivo simples falhe com o erro DTS_E_PRIMEOUTPUTFAILED.

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

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

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

  • Defina a propriedade DelayValidation no gerenciador de conexões de arquivo simples como True.

Pode usar uma expressão para criar um nome de ficheiro durante a execução utilizando o gestor de ligações Flat File com o destino Flat File.

Você pode definir propriedades por meio do SSIS Designer 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 Arquivo Simples (Página Geral)

Use a página Geral da caixa de diálogo Editor do Gerenciador de Conexões de Arquivo Simples para selecionar um arquivo e um formato de dados. Uma conexão de arquivo simples permite que um pacote se conecte a um arquivo de texto.

Para saber mais sobre o gerenciador de conexões de arquivo simples, consulte Gerenciador de conexões de arquivo simples.

Opções

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

Descrição
Descreva a conexão. Como prática recomendada, descreva a conexão em termos de sua finalidade, para tornar os pacotes auto-documentáveis e mais fáceis de manter.

Nome do ficheiro
Digite o caminho e o nome do ficheiro a ser usado na conexão de ficheiro plano.

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

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

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

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

Formato
Indique se o ficheiro usa formatação delimitada, largura fixa, ou 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.
Direita esfarrapada Arquivos irregulares à direita são arquivos nos quais cada coluna tem uma largura fixa, exceto a última coluna. É delimitado 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 sejam colocados entre aspas.

Observação

Depois de selecionar um qualificador de texto, não é possível selecionar novamente a opção Nenhum . Digite None para desmarcar o qualificador de texto.

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

Valor Descrição
{CR}{LF} A linha de cabeçalho é delimitada por uma combinação de alimentação de linha de retorno de carro.
{CR} A linha de cabeçalho é delimitada por um retorno de carro.
{LF} A linha de cabeçalho é delimitada por um feed de linha.
Ponto e vírgula {;} A linha de cabeçalho é delimitada por ponto-e-vírgula.
Colón {:} A linha de cabeçalho é delimitada por dois pontos.
Vírgula {,} A linha de cabeçalho é delimitada por uma vírgula.
Tab {t} A linha de cabeçalho é delimitada por uma guia.
Barra vertical {|} A linha de cabeçalho é delimitada por uma barra vertical.

Linhas de cabeçalho a serem ignoradas
Especifique o número de linhas de cabeçalho ou linhas de dados iniciais a serem ignoradas, se houver.

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

Editor do Gestor de Conexões de Ficheiro Plano (Página das Colunas)

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

Para saber mais sobre o gerenciador de conexões de arquivo simples, consulte Gerenciador de conexões de arquivo simples.

Opções estáticas

Nome do gestor de ligações
Forneça um nome único para a ligação de arquivo plano no fluxo de trabalho. O nome fornecido será exibido no SSIS Designer.

Descrição
Descreva a conexão. Como prática recomendada, descreva a conexão em termos de sua finalidade, para tornar os pacotes auto-documentáveis e mais fáceis de manter.

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

Formato = Delimitado

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

Valor Descrição
{CR}{LF} As linhas são delimitadas por uma combinação de alimentação de linha de retorno de carro.
{CR} As linhas são delimitadas por um retorno de carro.
{LF} As linhas são delimitadas por um feed de linha.
Ponto e vírgula {;} As linhas são delimitadas por ponto-e-vírgula.
Colón {:} As linhas são delimitadas por dois pontos.
Vírgula {,} As linhas são delimitadas por uma vírgula.
Tab {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 insira o texto do delimitador.

Valor Descrição
{CR}{LF} As colunas são delimitadas por uma combinação de alimentação de linha de retorno de carro.
{CR} As colunas são delimitadas por um retorno de carro.
{LF} As colunas são delimitadas por um feed de linha.
Ponto e vírgula {;} As colunas são delimitadas por ponto-e-vírgula.
Colón {:} As colunas são delimitadas por 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.

Atualizar
Veja o efeito de alterar os delimitadores para saltar ao clicar em Atualizar. Este botão só se torna visível depois de ter alterado outras opções de ligação.

Visualizar linhas
Exiba dados de exemplo no arquivo simples, divididos 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 na qual os dados de visualização serão exibidos.

Colunas de dados de origem
Ajuste a largura da linha deslizando o marcador de linha vermelho vertical 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. Ou arraste a linha vermelha vertical na janela de visualização para marcar o final da linha. O valor da largura da linha é atualizado automaticamente.

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

Formato = Direita irregular

Observação

Arquivos irregulares à direita são arquivos nos quais cada coluna tem uma largura fixa, exceto a última coluna. É delimitado pelo delimitador de linha.

Fonte
Selecione a fonte na qual os dados de visualização serão exibidos.

Colunas de dados de origem
Ajuste a largura da linha deslizando o marcador de linha vermelho vertical 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 insira o texto do delimitador.

Valor Descrição
{CR}{LF} As linhas são delimitadas por uma combinação de alimentação de linha de retorno de carro.
{CR} As linhas são delimitadas por um retorno de carro.
{LF} As linhas são delimitadas por um feed de linha.
Ponto e vírgula {;} As linhas são delimitadas por ponto-e-vírgula.
Colón {:} As linhas são delimitadas por dois pontos.
Vírgula {,} As linhas são delimitadas por uma vírgula.
Tab {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 Gestor de Conexões de Arquivo Flat (Página Avançada)

Use a página Avançado da caixa de diálogo Editor do Gerenciador de Conexões de Arquivo 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 para cada coluna no arquivo.

Por padrão, o comprimento das colunas de cadeia de caracteres é de 50 caracteres. Você pode redimensionar o comprimento dessas colunas para evitar truncamento de dados ou excesso de largura da coluna. Você também pode 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éricos, 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 exemplo e fazer algumas dessas alterações automaticamente.

Para saber mais sobre o gerenciador de conexões de arquivo simples, consulte Gerenciador de conexões de arquivo simples.

Opções

Nome do gestor de ligaçõ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 SSIS Designer.

Descrição
Descreva o gerenciador de conexões. Como prática recomendada, descreva o gerenciador de conexões em termos de sua finalidade, para tornar os pacotes autodocumentáveis 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 do tipo de dados. Algumas das propriedades listadas são configuráveis apenas para alguns formatos de arquivo simples.

Propriedade Descrição
Tipo de coluna Indica se a coluna é delimitada, de largura fixa, ou alinhada à direita irregularmente. Esta propriedade é somente leitura. Arquivos irregulares à direita são arquivos nos quais cada coluna tem uma largura fixa, exceto a última coluna. É delimitado pelo delimitador de linha.
OutputColumnWidth Especifique um valor a ser armazenado como uma 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 da coluna de saída da fonte Ficheiro Plano. No modelo de objeto, o nome dessa propriedade é MaximumWidth.
Tipo de Dados Selecione na lista de tipos de dados disponíveis. Para obter mais informações, consulte Tipos de dados do Integration Services.
TextQualified Indique se os dados de texto estão cercados por caracteres qualificadores de texto, como caracteres de 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 inserir um nome, o Integration Services criará automaticamente um nome no formato Coluna 0, Coluna 1 e assim por diante.
Escala de dados Especifique a escala de dados numéricos. A escala refere-se ao número de casas decimais. Para obter mais informações, consulte Tipos de dados do Integration Services.
ColumnDelimiter Selecione na lista de delimitadores de coluna disponíveis. Escolha delimitadores que não são prováveis de ocorrer no texto. Esse valor é ignorado para colunas de largura fixa.

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

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

{LF}. As colunas são delimitadas por um feed de linha.

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

Colón {:}. As colunas são delimitadas por 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 Especifique a precisão dos dados numéricos. A precisão refere-se ao número de dígitos. Para obter mais informações, consulte Tipos de dados do Integration Services.
LarguraDaColunaDeEntrada Especifique um valor a ser armazenado como uma contagem de bytes; para arquivos Unicode, isso será exibido como uma contagem de caracteres. Esse valor é ignorado para colunas delimitadas.

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

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

Valor Descrição
Adicionar coluna Adicione uma nova coluna no final da lista.
Inserir antes Insira uma nova coluna antes da coluna selecionada.
Inserir após Insira uma nova coluna após a coluna selecionada.

Eliminar
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 exemplo no arquivo e obter sugestões para o tipo de dados e o comprimento de cada coluna. Para obter mais informações, consulte Referência da Interface do Utilizador da Caixa de Diálogo Sugestão de Tipos de Coluna.

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

Use o nó Visualizar da caixa de diálogo Editor do Gerenciador de Conexões de Arquivo Simples para exibir o conteúdo do arquivo de origem em um formato tabular.

Para saber mais sobre o gerenciador de conexões de arquivo simples, consulte Gerenciador de conexões de arquivo simples.

Opções

Nome do gestor de ligações
Forneça um nome único para a ligação de arquivo plano no fluxo de trabalho. O nome fornecido será exibido no SSIS Designer.

Descrição
Descreva a conexão. Como prática recomendada, descreva a conexão em termos de sua finalidade, para tornar os pacotes auto-documentáveis e mais fáceis de manter.

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

Atualizar
Exiba o efeito de alterar o número de linhas a serem ignoradas clicando em Atualizar. Este botão só se torna visível depois de ter alterado outras opções de ligação.

Visualizar linhas
Exiba dados de exemplo no arquivo simples, divididos em colunas e linhas de acordo com as opções selecionadas.

  • Last updated on