Share via


Gerenciador de conexões de vários arquivos

Um gerenciador de conexões de vários arquivos habilita um pacote para fazer referência a arquivos e pastas existentes ou para criar arquivos e pastas no tempo de execução.

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

Quando você adicionar um gerenciador de conexões de vários arquivos a um pacote, o Integration Services criará um gerenciador de conexões que será resolvido como um gerenciador de conexões de vários arquivos no tempo de execução, definirá as propriedades de conexão de vários arquivos e adicionará 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 consultar todos os arquivos de texto na unidade C, o valor da propriedade ConnectionString poderá ser definido como C:\*.txt.

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.

Configurando O gerenciador de conexões de vários arquivos

Você pode definir as propriedades por meio do Designer SSIS ou programaticamente.

Para obter mais informações sobre as propriedades que podem ser definidas no Designer SSIS, consulte 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.

Ícone do Integration Services (pequeno) Fique atualizado com o Integration Services

Para obter os mais recentes downloads, artigos, exemplos e vídeos da Microsoft, bem como soluções selecionadas da comunidade, visite a página Integration Services no MSDN ou TechNet:

Para receber uma notificação automática das atualizações, assine os feeds RSS disponíveis na página.

Consulte também

Conceitos