Trabalhando programaticamente com gerenciadores de conexões

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

No Integration Services, o método AcquireConnection da classe do gerenciador de conexões associado é o método chamado com maior frequência quando você trabalha com gerenciadores de conexões em código gerenciado. Ao escrever código gerenciado, chame o método AcquireConnection para usar a funcionalidade de um gerenciador de conexões. Chame esse método independentemente de estar escrevendo o código gerenciado em uma tarefa Script, em um componente Script, em um objeto personalizado ou em uma aplicação personalizada.

Para chamar o método AcquireConnection com êxito, você precisa saber as respostas para as seguintes perguntas:

• Quais gerenciadores de conexões retornam um objeto gerenciado do método AcquireConnection?

  Muitos gerenciadores de conexões retornam objetos COM não gerenciados (System.__ComObject) e esses objetos não podem ser usados com facilidade por meio do código gerenciado. A lista desses gerenciadores de conexões inclui o OLE DB, que é usado com frequência.

• Que objetos são retornados pelos métodos AcquireConnection dos gerenciadores de conexões que retornam um objeto gerenciado?

  Para converter o valor retornado no tipo apropriado, você precisa saber que tipo de objeto é retornado pelo método AcquireConnection. Por exemplo, o método AcquireConnection do gerenciador de conexões ADO.NET retorna um objeto aberto do SqlConnection quando você usa o provedor SqlClient. Porém, o método AcquireConnection do gerenciador de conexões do arquivo só retorna uma cadeia de caracteres.

Este tópico responde a essas perguntas para os gerenciadores de conexões incluídos no Integration Services.

Gerenciadores de conexões que não retornam um objeto gerenciado

A tabela a seguir lista os gerenciadores de conexões que retornam um objeto COM nativo (System.__ComObject) do método AcquireConnection. Esses objetos não gerenciados não podem ser usados facilmente pelo código gerenciado.

Tipo do gerenciador de conexões	Nome do gerenciador de conexões
ADO	Gerenciador de conexões ADO
MSOLAP90	Gerenciador de conexões do Analysis Services
EXCEL	Gerenciador de conexões do Excel
FTP	Gerenciador de conexões FTP
HTTP	Gerenciador de conexões HTTP
ODBC	gerenciador de conexões ODBC
OLEDB	gerenciador de conexões OLE DB

Em geral, você pode usar um gerenciador de conexões ADO.NET de código gerenciado para se conectar a um ADO, Excel, ODBC ou fonte de dados OLE DB.

Valores de retorno do método AcquireConnection

A tabela a seguir lista os gerenciadores de conexões que retornam um objeto gerenciado do método AcquireConnection. Esses objetos gerenciados podem ser usados facilmente pelo código gerenciado.

Tipo do gerenciador de conexões	Nome do gerenciador de conexões	Tipo de valor de retorno	Informações adicionais
ADO.NET	Gerenciador de conexões ADO.NET	System.Data.SqlClient.SqlConnection
FILE	Gerenciador de conexões de arquivos	System.String	Caminho para o arquivo.
FLATFILE	Gerenciador de conexões de arquivos simples	System.String	Caminho para o arquivo.
MSMQ	Gerenciador de conexões MSMQ	System.Messaging.MessageQueue
MULTIFILE	Gerenciador de conexões de vários arquivos	System.String	Caminho para um dos arquivos.
MULTIFLATFILE	Gerenciador de conexões de vários arquivos simples	System.String	Caminho para um dos arquivos.
SMOServer	gerenciador de conexões SMO	Microsoft.SqlServer.Management.Smo.Server
SMTP	Gerenciador de conexões SMTP	System.String	Por exemplo: SmtpServer=<server name>;UseWindowsAuthentication=True;EnableSsl=False;
WMI	Gerenciador de conexões WMI	System.Management.ManagementScope
SQLMOBILE	Gerenciador de conexões do SQL Server Compact	System.Data.SqlServerCe.SqlCeConnection

Consulte Também

Conectando a fontes de dados na tarefa Script
Conectando-se a fontes de dados no componente de Script
Conectar-se a fontes de dados em uma tarefa personalizada