Gerenciador de conexões de arquivos

Aplica-se a: SQL Server (todas as versões com suporte) 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 .