Compartilhar via


Gerenciador de conexões de arquivos

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ê adiciona um gerenciador de conexões de arquivos a um pacote, o Integration Services cria um gerenciador de conexões que resolve a uma conexão de arquivo em tempo de execução, define as propriedades de conexão de arquivo e adiciona a conexão File à Connections coleção 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.