Gerenciador de conexões OLEDB

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

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

Várias tarefas do SQL Server Integration Services e componentes de fluxo de dados usam um gerenciador de conexões OLEDB. Por exemplo, a origem OLEDB e o destino OLEDB usam esse gerenciador de conexões para extrair e carregar dados. A tarefa Executar SQL pode usar esse gerenciador de conexões para se conectar a um banco de dados do 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 escritas em código não gerenciado que usa uma linguagem como C++.

Quando você adiciona um gerenciador de conexões OLEDB a um pacote, o Integration Services cria um gerenciador de conexões que resolve para uma conexão OLEDB em tempo de execução, define as propriedades do gerenciador de conexões e adiciona o gerenciador de conexões à coleção Connections no pacote.

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

Configure o gerenciador de conexões OLEDB das seguintes maneiras:

• 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 se conectar.

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

• Indique se a conexão criada a partir do gerenciador de conexões é mantida em tempo de execução.

Registrar chamadas e solucionar problemas de conexões

Você pode registrar as chamadas que o gerenciador de conexões OLEDB faz para provedores de dados externos. Em seguida, você pode solucionar problemas de conexões que o gerenciador de conexões OLEDB faz com fontes de dados externas. Para registrar as chamadas que o gerenciador de conexões OLEDB faz para provedores de dados externos, habilite o log de pacotes e selecione o evento Diagnóstico no nível do pacote. Para obter mais informações, consulte Ferramentas de solução de problemas para execução de pacotes.

Configurar o gerenciador de conexões OLEDB

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

Configurar o gerenciador de conexões OLEDB

Use a caixa de diálogo Configurar 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, consulte 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 propriedades e valores para a conexão de dados OLEDB selecionada.

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

Eliminar
Selecione uma conexão de dados e exclua-a selecionando Excluir.

Identidades gerenciadas para autenticação de recursos do Azure

Ao executar pacotes SSIS em Azure-SSIS tempo de execução de integração (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 que seu ADF acesse seu Banco de Dados SQL do Azure ou a Instância Gerenciada do SQL. Seu Azure-SSIS IR pode acessar e copiar dados de ou para seu banco de dados usando essa identidade gerenciada.

Para usar a autenticação do Microsoft Entra com a identidade gerenciada do ADF para 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, se ainda não tiver feito isso. O administrador do Microsoft Entra pode ser um usuário ou grupo do Microsoft Entra. Se você atribuir um grupo como administrador, poderá adicionar a identidade gerenciada do ADF ao grupo e ignorar as etapas 2 e 3. O administrador tem acesso total 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 se conectar 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 seu ADF, seu nome de identidade gerenciada deverá ser o nome de identidade gerenciado atribuído pelo usuário especificado.

3. Conceda à identidade gerenciada para seu ADF as permissões necessárias, como você normalmente faz para usuários SQL. Consulte Funções ao nível da base de dados para funções apropriadas. Execute a seguinte instrução T-SQL. Para obter mais opções, consulte este artigo.

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

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

1. Provisionar um administrador do Microsoft Entra para a sua Instância Gerenciada SQL do Azure no portal do Azure, se ainda não tiver feito isso. O administrador do Microsoft Entra pode ser um usuário ou grupo do Microsoft Entra. Se você atribuir um grupo como administrador, poderá adicionar a identidade gerenciada do ADF ao grupo e ignorar as etapas 2 e 3. O administrador tem acesso total à sua Instância Gerenciada SQL do Azure.

2. Crie um login atribuído à identidade gerenciada para seu ADF. No SSMS, conecte-se à sua Azure SQL Managed Instance usando uma conta do SQL Server que seja um sysadmin. No master banco de dados, 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 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 seu ADF, seu nome de identidade gerenciada deverá ser o nome de identidade gerenciado atribuído pelo usuário especificado.

3. Crie um usuário de banco de dados contido que represente a identidade gerenciada para seu ADF. Conecte-se ao banco de dados do 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 para seu ADF as permissões necessárias, como você normalmente faz para usuários SQL. Execute a seguinte instrução T-SQL. Para obter mais opções, consulte este artigo.

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

Em seguida, você pode configurar o provedor OLEDB no seu gerenciador de conexões OLEDB. Aqui estão as opções para fazer isso:

• Configure em tempo de desenvolvimento. No Designer SSIS, clique duas vezes no 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 oferecer suporte à autenticação do Microsoft Entra com a identidade gerenciada do ADF.

• Configure em tempo de execução. Ao executar o seu pacote via SSMS ou Executar a atividade do pacote SSIS no pipeline do ADF, encontre a propriedade do gerenciador de conexões ConnectionString para o gerenciador de conexões OLEDB. Atualize a propriedade Provider de conexão 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 do Microsoft Entra com a identidade gerenciada do seu ADF no gerenciador de conexões OLEDB. Aqui estão as opções para fazer isso:

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

  Observação

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

• Configure em tempo de execução. Ao executar seu pacote via SSMS ou executar a atividade do 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 integrada e senha) pré-configurados no 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 para seu ADF em seus pacotes existentes, a maneira preferida é reconstruir seu projeto SSIS com o SSIS Designer mais recente pelo menos uma vez. Reimplante seu projeto SSIS para ser executado em Azure-SSIS IR, para que a nova propriedade ConnectUsingManagedIdentity do gerenciador de conexões seja adicionada automaticamente a todos os gerenciadores de conexões OLEDB em seu projeto. Como alternativa, pode usar substituições de propriedade, através do caminho da propriedade \Package.Connections[{o nome do seu gestor de conexões}].Propriedades[ConnectUsingManagedIdentity] atribuídas à hora da True execução.

Ver também

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