Partilhar via

Gerenciador de conexões de vários arquivos simples

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

Um gerenciador de conexões de vários arquivos simples permite que um pacote acesse dados em vários arquivos simples. Por exemplo, uma fonte de arquivo plano pode usar um gestor de conexões de múltiplos arquivos planos quando a tarefa de fluxo de dados está 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.

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

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

Você pode configurar o gestor de ligação de múltiplos ficheiros planos das seguintes maneiras:

  • Especifique os arquivos, 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 dos arquivos contém nomes de coluna.

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

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

Quando o gerenciador de conexões Multiple Flat Files faz referência a vários arquivos, os caminhos dos arquivos são separados pelo caractere pipe (|). A propriedade ConnectionString do gerenciador de conexões tem o seguinte formato:

< caminho>|<caminho>

Você também pode especificar vários arquivos usando caracteres curinga. Por exemplo, para fazer referência a todos os arquivos de texto na unidade C, o valor da propriedade ConnectionString pode ser definido como C:\*.txt.

Se um gerenciador de conexões Multiple Flat Files fizer referência a vários arquivos, todos os arquivos deverão ter o mesmo formato.

Por padrão, o gerenciador de conexões Multiple Flat Files define o comprimento das colunas de cadeia de caracteres como 50 caracteres. Na caixa de diálogo Editor do Gerenciador de Conexões de Vários Arquivos 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. A menos que você redimensione o comprimento da coluna em uma fonte de arquivo simples ou em uma transformação, o comprimento da coluna permanece o mesmo durante todo o fluxo de dados. Se essas colunas forem mapeadas para colunas de destino mais estreitas, avisos aparecerão na interface do usuário e, em tempo de execução, poderão ocorrer erros devido ao truncamento de dados. Você pode redimensionar as colunas para serem compatíveis com as colunas de destino no gerenciador de conexões de Flat File, a origem de Flat File 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 vários arquivos 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 Gestor de Conexão de Múltiplos Ficheiros Planos

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 Gestor de Conexões de Múltiplos Ficheiros Planos (Página Geral)

Use a página Geral da caixa de diálogo Editor do Gerenciador de Conexões de Vários Arquivos Simples para selecionar um grupo de arquivos que tenham o mesmo formato de dados e especificar seu formato de dados. Uma conexão de vários arquivos simples permite que um pacote se conecte a um grupo de arquivos de texto que têm o mesmo formato.

Para saber mais sobre o gerenciador de conexões de vários arquivos simples, consulte Gerenciador de conexões de vários arquivos simples.

Opções

Nome do gestor de ligações
Forneça um nome exclusivo para a conexão Vários arquivos simples 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.

Nomes de ficheiros
Digite o caminho e os nomes de ficheiros a usar na conexão de vários ficheiros planos. Você pode especificar vários arquivos usando caracteres curinga, como no exemplo "C:\*.txt", ou usando o caractere de pipe vertical (|) para separar vários nomes de arquivo. Todos os arquivos devem ter o mesmo formato de dados.

Navegar
Procure os nomes de arquivo a serem usados na conexão Vários arquivos simples. Você pode selecionar vários arquivos. Todos os arquivos devem ter o mesmo formato de dados.

Localidade
Especifique o local para fornecer informações para pedidos e para conversão de data e hora.

Unicode
Indique se deseja usar Unicode. O uso de Unicode impede a especificação de 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 pretende usar formatação delimitada, de largura fixa ou alinhamento irregular à direita. Todos os arquivos devem ter o mesmo formato de dados.

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, especificada arrastando linhas de marcador na página Colunas .
Direita esfarrapada Arquivos com alinhamento irregular à direita são arquivos nos quais cada coluna tem uma largura fixa, exceto a última coluna, que é delimitada pelo separador de linha, especificado na página Colunas.

Qualificador de texto
Especifique o qualificador de texto a ser usado. Por exemplo, você pode especificar para colocar texto entre aspas.

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 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 Vários Arquivos Simples (Página Colunas)

Use o nó Colunas da caixa de diálogo Editor do Gestor de Conexões de Vários Arquivos Simples para especificar as informações de linha e coluna e prever o primeiro arquivo selecionado.

Para saber mais sobre o gerenciador de conexões de vários arquivos simples, consulte Gerenciador de conexões de vários arquivos simples.

Opções estáticas

Nome do gestor de ligações
Forneça um nome exclusivo para a conexão Vários arquivos simples 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.

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 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 vertical na janela de visualização para marcar o fim 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 com margem direita irregular são os que têm uma largura fixa para cada coluna, 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 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 Ligações de Múltiplos Ficheiros Planos (Página Avançada)

Use a página Avançado da janela de diálogo Gestor de Conexão de Vários Ficheiros Planos Editor para definir propriedades como tipo de dados e delimitadores de cada coluna nos ficheiros de texto aos quais o gestor de ligação de ficheiro plano se conecta.

Por padrão, o comprimento das colunas de cadeia de caracteres é de 50 caracteres. Você pode avaliar dados de amostra e redimensionar automaticamente 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.

Para saber mais sobre o gerenciador de conexões de vários arquivos simples, consulte Gerenciador de conexões de vários arquivos simples.

Opções

Nome do gestor de ligações
Forneça um nome exclusivo para o gerenciador de conexões Multiple Flat Files no fluxo de trabalho. O nome fornecido será exibido na área Gerenciadores de Conexões do 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 com alinhamento à esquerda são arquivos nos quais cada coluna tem uma largura fixa, exceto a última coluna, que é encerrada pelo delimitador de linha.
OutputColumnWidth Especifique um valor a ser armazenado como uma contagem de bytes; para arquivos Unicode, isso será exibido como 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.

Nota: 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 são qualificados usando um caractere qualificador de texto:

True: Os dados de texto no arquivo simples são qualificados.

False: Os dados de texto no ficheiro plano não estão qualificados.
Nome Forneça um nome de coluna. O padrão é uma lista numerada de colunas; no entanto, você pode escolher qualquer nome exclusivo e descritivo.
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 da linha de retorno de carro

{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 ponto e vírgula

Colon {:} - 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 um separador

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 no menu pendente.

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 primeiro arquivo selecionado 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 Gestor de Conexões de Múltiplos Arquivos Planos (Página de Pré-visualização)

Use a página Visualizar da caixa de diálogo Editor do ConnectionManager de vários arquivos simples para exibir o conteúdo do primeiro arquivo de origem selecionado dividido em colunas conforme você as definiu.

Para saber mais sobre o gerenciador de conexões de vários arquivos simples, consulte Gerenciador de conexões de vários arquivos simples.

Opções

Nome do gestor de ligações
Forneça um nome exclusivo para a conexão Vários arquivos simples no fluxo de trabalho. O nome fornecido será exibido na área Gerenciadores de Conexões do 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.

Visualizar linhas
Exiba dados de exemplo no primeiro arquivo simples selecionado, dividido em colunas e linhas usando as opções selecionadas.

Ver também

Fonte de arquivo simples
Destino de Arquivo Plano
Conexões do Integration Services (SSIS)

  • Last updated on