Gerenciador de conexões de arquivos

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

Um gerenciador de conexões de Arquivo permite que um pacote faça referência a um arquivo ou pasta existente ou crie um arquivo ou pasta em tempo de execução. Por exemplo, você pode fazer referência a um arquivo do Excel. Alguns componentes em Microsoft SQL Server Integration Services usam as informações nos arquivos para executar seu trabalho. Por exemplo, uma tarefa Executar SQL pode fazer referência a um arquivo que contém as instruções SQL que a tarefa executa. Outros componentes executam operações em arquivos. Por exemplo, a tarefa Sistema de Arquivos pode fazer referência a um arquivo para copiá-lo para um novo local.

Tipos de uso do gerenciador de conexões de arquivos

A propriedade FileUsageType do gerenciador de conexões de arquivos especifica como a conexão de arquivos é utilizada. O gerenciador de conexões de arquivos pode criar tanto um arquivo quanto uma pasta e utilizar um arquivo ou uma pasta existente.

A tabela a seguir lista os valores de FileUsageType.

Valor Descrição
0 O gerenciador de conexões de arquivos utiliza um arquivo existente.
1 O gerenciador de conexões de arquivos cria um arquivo.
2 O gerenciador de conexões de arquivos utiliza um arquivo existente.
3 O gerenciador de conexões de arquivos cria um arquivo.

Várias conexões de arquivo ou pasta

O gerenciador de conexões de arquivos pode fazer referência a apenas um arquivo ou a uma pasta. Para consultar vários arquivos ou pastas, utilize um gerenciador de conexões para vários arquivos em vez de um gerenciador de conexões de arquivos. Para obter mais informações, consulte Multiple Files Connection Manager.

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

Quando você adicionar um gerenciador de conexões de arquivos a um pacote, o Integration Services criará um gerenciador de conexões que será resolvido para uma conexão de arquivos em tempo de execução, definirá as propriedades da conexão de arquivos e adicionará a conexão de arquivos à coleção Connections do pacote.

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

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

  • Especificando o tipo de uso.

  • Especificando um arquivo ou uma pasta.

Você pode definir a propriedade ConnectionString para o gerenciador de conexões de arquivos especificando uma expressão na janela Propriedades do SQL Server Data Tools (SSDT). No entanto, para evitar um erro de validação ao usar uma expressão para especificar o arquivo ou a pasta, no Editor do Gerenciador de Conexões de Arquivos, para Arquivo/Pasta, adicione um caminho de arquivo ou de pasta.

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

Para obter mais informações sobre as propriedades que podem ser definidas no Designer do SSIS , consulte Editor do Gerenciador de Conexões de Arquivos.

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

Use a caixa de diálogo Editor do Gerenciador de Conexões de Arquivos para especificar as propriedades usadas para conectar a um arquivo ou pasta.

Observação

Você pode definir a propriedade ConnectionString para o gerenciador de conexões de arquivos especificando uma expressão na janela Propriedades do SQL Server Data Tools (SSDT). No entanto, para evitar um erro de validação ao usar uma expressão para especificar o arquivo ou a pasta, no Editor do Gerenciador de Conexões de Arquivos, para Arquivo/Pasta, adicione um caminho de arquivo ou de pasta.

Para obter mais informações sobre o gerenciador de conexões de Arquivos, consulte File Connection Manager.

Opções

Tipo de Uso
Especifique se o Gerenciador de Conexões de Arquivos conecta a um arquivo ou pasta existente ou crie um novo arquivo ou pasta.

Valor Descrição
Criar arquivo Crie um novo arquivo em tempo de execução.
Arquivo existente Use um arquivo existente.
Criar pasta Crie uma nova pasta em tempo de execução.
Pasta existente Use uma pasta existente.

Arquivo / Pasta
Se Arquivo, especifique o arquivo a usar.

Se Pasta, especifique a pasta a usar.

Procurar
Selecione o arquivo ou pasta usando a caixa de diálogo Selecionar Arquivo ou Procurar Pasta .

Referência de IU da caixa de diálogo Adicionar Gerenciador de Conexões de Arquivos

Use a caixa de diálogo do Adicionar Gerenciador de Conexões de Arquivos para definir uma conexão com um grupo de arquivos ou pastas.

Para obter mais informações sobre o gerenciador de conexões de Vários Arquivos, consulte Multiple Files Connection Manager.

Observação

As tarefas internas e os componentes de fluxo de dados do Integration Services não usam o gerenciador de conexões de vários arquivos. No entanto você pode usar o gerenciador de conexões na tarefa Script ou no componente Script.

Opções da caixa de diálogo para Adicionar Gerenciador de Conexões de Arquivos

Tipo de uso
Especifique os tipos de arquivos a serem usados para o gerenciador de conexões de vários arquivos.

Valor Descrição
Criar arquivos O gerenciador de conexões criará os arquivos.
Arquivos existentes O gerenciador de conexões utilizará arquivos existentes.
Criar pastas O gerenciador de conexões criará as pastas.
Pastas existentes O gerenciador de conexões utilizará pastas existentes.

Arquivos/Pastas
Exiba os arquivos ou pastas que você adicionou usando os botões descritos abaixo.

Adicionar
Adicione um arquivo usando a caixa de diálogo Selecionar Arquivos ou adicione uma pasta usando a caixa de diálogo Procurar pasta .

Editar
Selecione um arquivo ou pasta e substitua-o por um arquivo ou pasta diferente usando a caixa de diálogo Selecionar arquivos ou Procurar pasta .

Remover
Selecione um arquivo ou pasta e remova-o da lista usando o botão Remover .

Botões de seta
Selecione um arquivo ou pasta e use os botões de seta para movê-los para cima ou para baixo para especificar a sequência de acesso.

Referência da interface do usuário da caixa de diálogo Sugerir Tipos de Coluna

Use a caixa de diálogo Sugerir Tipos de Coluna para identificar o tipo de dados e o tamanho das colunas em um Gerenciador de Conexões de Arquivos Simples, com base em uma amostragem do conteúdo dos arquivos.

Para saber mais sobre os tipos de dados usados pelo Integration Services, consulte Tipos de dados do Integration Services.

Opções da caixa de diálogo para Sugerir Tipos de Colunas

Número de linhas
Digite ou selecione o número de linhas na amostra que o algoritmo usa.

Sugerir o menor tipo de dados inteiros
Desmarque esta caixa de seleção para ignorar a avaliação. Se selecionada, determina o menor tipo de dados inteiro possível para colunas que contêm dados numéricos integrais.

Sugerir o menor tipo de dados reais
Desmarque esta caixa de seleção para ignorar a avaliação. Se selecionada, determina se as colunas que contêm dados numéricos reais podem usar o menor tipo de dados reais, DT_R4.

Identificar colunas de Boolianos usando os seguintes valores
Digite os dois valores que deseja usar como valores Boolianos verdadeiro e falso. Os valores devem ser separados por uma vírgula, com o primeiro valor representando Verdadeiro.

Preencher colunas de cadeia de caracteres
Marque esta caixa de seleção para habilitar o preenchimento da cadeia de caracteres.

Porcentagem de enchimento
Digite ou selecione a porcentagem pela qual aumentar o tamanho de coluna para tipos de dados de caracteres. A porcentagem deve ser um inteiro.

Referência de mensagens e erros do Integration Services