Gerenciador de conexões de vários arquivos

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

Um gerenciador de conexões de Vários Arquivos permite que um pacote faça referência a arquivos e pastas existentes ou crie arquivos e pastas em tempo de execução.

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. Para obter informações sobre como usar gerenciadores de conexões na tarefa Script, consulte Conectando-se a fontes de dados na tarefa Script. Para obter informações sobre como usar gerenciadores de conexões no componente Script, consulte Conectando-se a fontes de dados no componente Script.

Tipos de uso do gerenciador de conexões de vários arquivos

A propriedade FileUsageType do gerenciador de conexões de vários arquivos especifica como a conexão é utilizada. O gerenciador de conexões de vários arquivos pode criar arquivos, pastas e usar arquivos e pastas existentes.

A tabela a seguir lista os valores de FileUsageType.

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

Configuração do gerenciador de conexões de vários arquivos

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

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

Você pode configurar um gerenciador de conexões de vários arquivos da seguinte maneira:

  • Especifique o tipo de uso de arquivos e pastas.

  • Especifique as pastas e os arquivos.

  • Se estiver usando vários arquivos ou pastas, especifique a ordem na qual devem ser acessados os arquivos e as pastas.

Se o gerenciador de conexões de vários arquivos consultar vários arquivos e pastas, os caminhos dos arquivos e pastas serão separados pelo caractere pipe (|). A propriedade ConnectionString do gerenciador de conexões tem o seguinte formato:

<path>|<path>

Você também pode especificar vários arquivos ou pastas usando caracteres curingas. 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.

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 Referência da interface do usuário da caixa de diálogo Adicionar 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.