Conectando-se a fontes de dados no componente de Script

Aplica-se a: Tempo de execução de integração do SSIS do SQL Server no Azure Data Factory

Um gerenciador de conexões é uma unidade conveniente que encapsula e armazena as informações necessárias para conexão com uma fonte de dados de um tipo específico. Para obter mais informações, confira Conexões do SSIS (Integration Services).

Você pode tornar os gerenciadores de conexões existentes disponíveis para acesso por meio de script personalizado no componente de origem ou destino, clicando nos botões Adicionar e Remover na página Gerenciadores de Conexões do Editor de Transformação Scripts. Entretanto, você deverá gravar seu próprio código personalizado para carregar ou salvar seus dados e, possivelmente, abrir e fechar a conexão com a fonte de dados. Para obter mais informações sobre a página Gerenciador de Conexões do Editor de Transformação Scripts, confira Configurando o componente Script no Editor de Componente Script e Editor de Transformação Scripts (Página Gerenciadores de Conexão).

O componente Script cria uma classe de coleção Connections no item do projeto ComponentWrapper que contém um acessador fortemente tipado para cada gerenciador de conexões que tem o mesmo nome que o gerenciador de conexões propriamente dito. Esta coleção é exposta pela propriedade Connections da classe ScriptMain. A propriedade de acessador retorna uma referência ao gerenciador de conexões como uma instância de IDTSConnectionManager100. Por exemplo, se você adicionou um gerenciador de conexões nomeado MyADONETConnection na página Gerenciadores de Conexões da caixa de diálogo, poderá obter uma referência a ele em seu script adicionando o seguinte código:

Dim myADONETConnectionManager As IDTSConnectionManager100 = _

Me.Connections.MyADONETConnection

Observação

Você deve saber o tipo de conexão retornado pelo gerenciador de conexões antes de chamar AcquireConnection. Já que a tarefa Script tem Option Strict habilitada, você deve converter a conexão, que é retornada como tipo Object, para o tipo de conexão adequado antes de poder usá-la.

Em seguida, chame o método AcquireConnection do gerenciador de conexões específico para obter a conexão subjacente ou as informações necessárias para se conectar à fonte de dados. Por exemplo, você obtém uma referência ao System.Data.SqlConnection encapsulada por um gerenciador de conexões do ADO.NET com o uso do código a seguir:

Dim myADOConnection As SqlConnection = _

CType(MyADONETConnectionManager.AcquireConnection(Nothing), SqlConnection)

Em contraste, a mesma chamada para um gerenciador de conexões de arquivo simples retorna somente o caminho e nome de arquivo da fonte de dados de arquivo.

Dim myFlatFile As String = _

CType(MyFlatFileConnectionManager.AcquireConnection(Nothing), String)

Em seguida, forneça esse caminho e nome de arquivo a um System.IO.StreamReader ou Streamwriter para ler ou gravar os dados no arquivo simples.

Importante

Quando você grava um código gerenciado em um componente Script, você não pode chamar o método AcquireConnection de gerenciadores de conexões que retornam objetos não gerenciados, tais como o gerenciador de conexões OLE DB e o gerenciador de conexões do Excel. Entretanto, você pode gravar a propriedade ConnectionString desses gerenciadores de conexões e conectar-se à fonte de dados diretamente em seu código por meio da cadeia de conexão de uma conexão OLE DB do namespace System.Data.OleDb.

Se você precisar chamar o método AcquireConnection de um gerenciador de conexões que retorna um objeto não gerenciado, use um gerenciador de conexões ADO.NET. Quando você configurar o gerenciador de conexões ADO.NET para usar um provedor OLE DB, ele se conectará usando o provedor de dados .NET Framework para OLE DB. Nesse caso, o método AcquireConnection retorna um System.Data.OleDb.OleDbConnection em vez de um objeto não gerenciado. Para configurar um gerenciador de conexões ADO.NET para uso com uma fonte de dados Excel, selecione o Microsoft OLE DB Provider for Jet, especifique uma pasta de trabalho do Excel e, em seguida, insira Excel 8.0 (para o Excel 97 e versões posteriores) como o valor de Propriedades Estendidas na página Todos da caixa de diálogo Gerenciador de Conexões.

Para obter mais informações sobre como usar gerenciadores de conexões com o componente Script, consulte Criar uma origem com o componente de Script e Criar um destino com o componente Script.

Consulte Também

Conexões do SSIS (Integration Services)
Criar Gerenciadores de Conexões