Gerenciador de conexões do OLEDB

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

Um gerenciador de conexões OLEDB permite que um pacote se conecte a uma fonte de dados ao usar um provedor OLEDB. Por exemplo, um gerenciador de conexões OLEDB que se conecta ao SQL Server pode usar o provedor OLEDB da Microsoft para SQL Server.

Várias tarefas e componentes de fluxo de dados do SQL ServerIntegration Services usam um gerenciador de conexões OLEDB. Por exemplo, a origem e o destino do OLEDB usam esse gerenciador de conexões para extrair e carregar dados. A tarefa Executar SQL pode usar um gerenciador de conexões de modo a conectar-se a um banco de dados SQL Server para executar consultas.

Você também pode usar o gerenciador de conexões OLEDB para acessar fontes de dados OLEDB em tarefas personalizadas gravadas em código não gerenciado que usa uma linguagem como C++.

Ao adicionar um gerenciador de conexões OLE DB a um pacote, o Integration Services cria um gerenciador de conexões que disponibiliza uma conexão do OLE DB em runtime, define as propriedades do gerenciador de conexões e adiciona o gerenciador de conexões à coleção Conexões no pacote.

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

Configure o gerenciador de conexões OLEDB de uma das seguintes formas:

• Forneça uma cadeia de conexão específica configurada para atender aos requisitos do provedor selecionado.

• Dependendo do provedor, inclua o nome da fonte de dados à qual efetuar a conexão.

• Forneça credenciais de segurança apropriadas para o provedor selecionado.

• Indique se a conexão criada a partir do gerenciador de conexões será retida em runtime.

Registrar chamadas e solucionar problemas de conexão

Você pode registrar as chamadas que o gerenciador de conexões OLEDB faz para provedores de dados externos. É possível então solucionar problemas nas conexões que o gerenciador de conexões OLEDB estabelece com fontes de dados externas. Para registrar as chamadas que o gerenciador de conexões OLEDB faz aos provedores de dados externos, habilite o registro em log do pacote e selecione o evento de Diagnóstico no nível do pacote. Para obter mais informações, consulte Solucionando problemas de ferramentas para execução de pacotes.

Configurar o gerenciador de conexões OLEDB

Você pode definir propriedades pelo Designer do SSIS ou de maneira programática.

Configurar o gerenciador de conexões OLEDB

Use a caixa de diálogo Configurar o Gerenciador de Conexões OLEDB para adicionar uma conexão a uma fonte de dados. Essa conexão pode ser nova ou uma cópia de uma conexão existente.

Para saber mais sobre o gerenciador de conexões OLEDB, confira Gerenciador de Conexões OLEDB.

Opções

Conexões de dados
Selecione uma conexão de dados OLEDB existente na lista.

Propriedades de conexão de dados
Exiba as propriedades e os valores da conexão de dados OLEDB selecionada.

Novo
Crie uma conexão de dados OLEDB usando a caixa de diálogo Gerenciador de Conexões.

Delete (excluir)
Escolha uma conexão de dados e selecione Excluir para excluí-la.

Identidades gerenciadas para autenticação de recursos do Azure

Ao executar pacotes do SSIS no Azure-SSIS Integration Runtime (IR) no Azure Data Factory (ADF), você pode usar a autenticação do Microsoft Entra com identidades gerenciadas atribuídas pelo sistema ou pelo usuário para o seu ADF para acessar o Banco de Dados SQL do Azure ou a Instância Gerenciada de SQL. Seu Azure-SSIS IR pode acessar e copiar dados do seu banco de dados ou para ele usando essa identidade gerenciada.

Para usar a autenticação do Microsoft Entra com a identidade gerenciada do ADF a fim de acessar o servidor do Banco de Dados SQL do Azure, siga estas etapas:

1. Provisione um administrador do Microsoft Entra para seu servidor lógico no portal do Azure, caso ainda não tenha feito isso. O administrador do Microsoft Entra pode ser um usuário do Microsoft Entra ou um grupo do Microsoft Entra. Se você designar um grupo como administrador, poderá adicionar a identidade gerenciada do seu ADF ao grupo e pular as etapas 2 e 3. O administrador terá acesso completo ao seu servidor lógico para o Banco de Dados SQL do Azure.

2. Crie um usuário de banco de dados contido para a identidade gerenciada do seu ADF. Use o SQL Server Management Studio (SSMS) para conectar-se ao banco de dados com um usuário do Microsoft Entra que tenha pelo menos a permissão ALTER ANY USER. Execute a seguinte instrução T-SQL:

   CREATE USER [your managed identity name] FROM EXTERNAL PROVIDER;
   

   Se você usar a identidade gerenciada atribuída pelo sistema para o ADF, o nome da identidade gerenciada deverá ser o nome do ADF. Se você usar uma identidade gerenciada atribuída pelo usuário para o ADF, o nome da sua identidade gerenciada deverá ser o nome especificado da identidade gerenciada atribuída pelo usuário.

3. Conceda à identidade gerenciada do ADF as permissões necessárias, como você normalmente faz para os usuários SQL. Saiba mais sobre as funções adequadas em Funções do nível de banco de dados. Execute a seguinte instrução T-SQL. Para mais opções, confira este artigo.

   EXEC sp_addrolemember [role name], [your managed identity name];
   

Para usar a autenticação do Microsoft Entra com a identidade gerenciada atribuída do ADF a fim de acessar a Instância Gerenciada de SQL do Azure, siga estas etapas:

1. Provisione um administrador do Microsoft Entra para sua Instância Gerenciada de SQL do Azure no portal do Azure, caso ainda não tenha feito isso. O administrador do Microsoft Entra pode ser um usuário do Microsoft Entra ou um grupo do Microsoft Entra. Se você designar um grupo como administrador, poderá adicionar a identidade gerenciada do seu ADF ao grupo e pular as etapas 2 e 3. O administrador terá acesso completo à Instância Gerenciada de SQL do Azure.

2. Crie um login atribuído à identidade gerenciada do seu ADF. No SSMS, conecte-se à sua Instância Gerenciada de SQL do Azure usando a conta do SQL Server que seja um sysadmin. No banco de dados master, execute a seguinte instrução T-SQL:

   CREATE LOGIN [your managed identity name] FROM EXTERNAL PROVIDER;
   

   Se você usar a identidade gerenciada pelo sistema para seu ADF, seu nome de identidade gerenciada deverá ser o nome do seu ADF. Se você usar uma identidade gerenciada atribuída pelo usuário para seu ADF, o nome da sua identidade gerenciada deve ser o nome especificado da identidade gerenciada atribuída pelo usuário.

3. Crie um usuário de banco de dados independente para representar a identidade gerenciada para o ADF. Conecte-se ao banco de dados do qual ou para o qual você deseja copiar dados usando o SSMS e execute a seguinte instrução T-SQL:

   CREATE USER [your managed identity name] FROM EXTERNAL PROVIDER;
   

4. Conceda à identidade gerenciada do ADF as permissões necessárias, como você normalmente faz para os usuários SQL. Execute a seguinte instrução T-SQL. Para mais opções, confira este artigo.

   ALTER ROLE [role name e.g., db_owner] ADD MEMBER [your managed identity name];
   

Você pode configurar o provedor OLEDB no seu gerenciador de conexões OLEDB. Veja a seguir as opções para fazer isso:

• Configurar em tempo de design. No Designer do SSIS, clique duas vezes em seu gerenciador de conexões OLEDB para abrir a janela do Gerenciador de Conexões. Na lista suspensa Provedor, selecione Microsoft OLEDB Driver for SQL Server.

  Observação

  Outros provedores na lista suspensa podem não ser compatíveis com a autenticação do Microsoft Entra usando a identidade gerenciada do seu ADF.

• Configurar em tempo de execução. Ao executar o pacote por meio do SSMS ou Executar a atividade de Pacote do SSIS no pipeline do ADF, localize a propriedade do gerenciador de conexões ConnectionString para o gerenciador de conexões OLEDB. Atualize a propriedade de conexão Provider para MSOLEDBSQL (que é o Microsoft OLEDB Driver para SQL Server).

  Data Source=serverName;Initial Catalog=databaseName;Provider=MSOLEDBSQL;...
  

Agora, você pode configurar a autenticação com o Microsoft Entra usando a identidade gerenciada do seu ADF no gerenciador de conexão OLEDB. Veja a seguir as opções para fazer isso:

• Configurar em tempo de design. No Designer do SSIS, clique com o botão direito do mouse em seu gerenciador de conexões OLEDB e selecione Propriedades. Atualize a propriedade ConnectUsingManagedIdentity para True.

  Observação

  Atualmente, a propriedade do gerenciador de conexões ConnectUsingManagedIdentity não entra em vigor quando você executa o pacote SSIS no SSIS Designer ou no SQL Server, indicando que a autenticação com a identidade gerenciada do ADF não funciona.

• Configurar em tempo de execução. Ao executar o pacote por meio do SSMS ou Executar a atividade de Pacote SSIS no pipeline do ADF, localize o gerenciador de conexões OLEDB e atualize sua propriedade ConnectUsingManagedIdentity para True.

  Observação

  No Azure-SSIS IR, todos os outros métodos de autenticação (por exemplo, segurança e senha integradas) pré-configurados em seu gerenciador de conexões OLEDB são substituídos ao usar a autenticação do Microsoft Entra com uma identidade gerenciada.

Para configurar a autenticação do Microsoft Entra com a identidade gerenciada do seu ADF nos seus pacotes existentes, a maneira preferida é recompilar seu projeto SSIS com o SSIS Designer mais recente pelo menos uma vez. Reimplante seu projeto do SSIS para executar no Azure-SSIS IR, para que a nova propriedade do gerenciador de conexões ConnectUsingManagedIdentity seja automaticamente adicionada a todos os gerenciador de conexões do OLEDB em seu projeto. Como alternativa, você pode usar substituições de propriedades, com o caminho da propriedade \Package.Connections[{o nome do seu gerenciador de conexões}].Properties[ConnectUsingManagedIdentity] definido como True em tempo de execução.

Confira também

• Origem do OLEDB
• Destino do OLEDB
• Conexões do SSIS (Integration Services)