Gestionnaire de connexions OLE DBOLE DB Connection Manager

APPLIES TO: yesSQL Server, including on Linux yesAzure SQL Database yesAzure SQL Data Warehouse noParallel Data Warehouse

Un gestionnaire de connexions OLE DB permet à un package de se connecter à une source de données à l'aide d'un fournisseur OLE DB.An OLE DB connection manager enables a package to connect to a data source by using an OLE DB provider. Par exemple, un gestionnaire de connexions OLE DB qui se connecte à SQL ServerSQL Server peut utiliser le fournisseur MicrosoftMicrosoft OLE DB pour SQL ServerSQL Server.For example, an OLE DB connection manager that connects to SQL ServerSQL Server can use the MicrosoftMicrosoft OLE DB Provider for SQL ServerSQL Server.

Notes

Le fournisseur OLEDB SQL ServerSQL Server Native Client 11.0 ne prend pas en charge les mots clés de la nouvelle chaîne de connexion (MultiSubnetFailover=True) pour le clustering de basculement de sous-réseaux multiples.The SQL ServerSQL Server Native Client 11.0 OLEDB provider does not support the new connection string key words (MultiSubnetFailover=True) for Multi-Subnet Failover Clustering. Pour plus d’informations, consultez les Notes de publication de SQL Server et la publication de blog Basculement de sous-réseaux multiples Always On et SSISsur www.mattmasson.com.For more information, see the SQL Server Release Notes and the blog post, Always On Multi-Subnet Failover and SSIS, on www.mattmasson.com.

Notes

Si la source de données est MicrosoftMicrosoft Office Excel 2007 ou MicrosoftMicrosoft Office Access 2007, elle requiert un fournisseur de données différent des versions antérieures d’Excel ou d’Access.If the data source is MicrosoftMicrosoft Office Excel 2007 or MicrosoftMicrosoft Office Access 2007, the data source requires a different data provider than earlier versions of Excel or Access. Pour plus d’informations, consultez Établir une connexion à un classeur Excel et Établir une connexion à une base de données Access.For more information, see Connect to an Excel Workbook and Connect to an Access Database.

Plusieurs tâches et composants de flux de données SQL ServerSQL Server Integration ServicesIntegration Services utilisent un gestionnaire de connexions OLE DB.Several SQL ServerSQL Server Integration ServicesIntegration Services tasks and data flow components use an OLE DB connection manager. Ainsi, la source et la destination OLE DB utilisent ce gestionnaire de connexions pour extraire et charger des données, tandis que la tâche d’exécution SQL utilise ce gestionnaire pour se connecter à une base de données SQL ServerSQL Server afin d’exécuter des requêtes.For example, the OLE DB source and OLE DB destination use this connection manager to extract and load data, and the Execute SQL task can use this connection manager to connect to a SQL ServerSQL Server database to run queries.

Le gestionnaire de connexions OLE DB est également utilisé pour accéder à des sources de données OLE DB dans des tâches personnalisées écrites dans du code non géré utilisant un langage comme C++.The OLE DB connection manager is also used to access OLE DB data sources in custom tasks written in unmanaged code that uses a language such as C++.

Quand vous ajoutez un gestionnaire de connexions OLE DB à un package, Integration ServicesIntegration Services crée un gestionnaire de connexions qui sera résolu en une connexion OLE DB au moment de l’exécution, définit les propriétés du gestionnaire de connexions et ajoute le gestionnaire de connexions à la collection Connections sur le package.When you add an OLE DB connection manager to a package, Integration ServicesIntegration Services creates a connection manager that will resolve to an OLE DB connection at run time, sets the connection manager properties, and adds the connection manager to the Connections collection on the package.

La propriété ConnectionManagerType du gestionnaire de connexions a pour valeur OLEDB.The ConnectionManagerType property of the connection manager is set to OLEDB.

Le gestionnaire de connexions OLE DB peut être configuré de plusieurs manières :The OLE DB connection manager can be configured in the following ways:

  • Indiquez une chaîne de connexion spécifique configurée pour répondre aux besoins du fournisseur sélectionné.Provide a specific connection string configured to meet the requirements of the selected provider.

  • Selon le fournisseur, incluez le nom de la source de données à laquelle se connecter.Depending on the provider, include the name of the data source to connect to.

  • Fournissez les informations d'identification de sécurité nécessaires selon le fournisseur sélectionné.Provide security credentials as appropriate for the selected provider.

  • Indiquez si la connexion créée à partir du gestionnaire de connexions est conservée au moment de l'exécution.Indicate whether the connection that is created from the connection manager is retained at run time.

JournalisationLogging

Vous pouvez consigner les appels que le gestionnaire de connexions OLE DB effectue vers des fournisseurs de données externes.You can log the calls that the OLE DB connection manager makes to external data providers. Cette fonctionnalité de journalisation permet de résoudre des problèmes liés aux connexions que le gestionnaire de connexions OLE DB établit avec des sources de données externes.You can use this logging capability to troubleshoot the connections that the OLE DB connection manager makes to external data sources. Pour consigner les appels que le gestionnaire de connexions OLE DB effectue vers des fournisseurs de données externes, activez la journalisation de package et sélectionnez l’événement Diagnostic au niveau du package.To log the calls that the OLE DB connection manager makes to external data providers, enable package logging and select the Diagnostic event at the package level. Pour plus d’informations, consultez Outils de dépannage pour l’exécution des packages.For more information, see Troubleshooting Tools for Package Execution.

Configuration du gestionnaire de connexions OLEDBConfiguration of the OLEDB Connection Manager

Vous pouvez définir les propriétés par le biais du concepteur SSISSSIS ou par programmation.You can set properties through SSISSSIS Designer or programmatically. Pour plus d’informations sur les propriétés définissables dans le concepteur SSISSSIS , consultez Configurer le gestionnaire de connexions OLE DB.For more information about the properties that you can set in SSISSSIS Designer, see Configure OLE DB Connection Manager. Pour plus d’informations sur la configuration d’un gestionnaire de connexions par programmation, consultez la documentation de la classe T:Microsoft.SqlServer.Dts.Runtime.ConnectionManager dans le Guide du développeur.For information about configuring a connection manager programmatically, see the documentation for T:Microsoft.SqlServer.Dts.Runtime.ConnectionManager class in the Developer Guide.

Configurer le gestionnaire de connexions OLE DBConfigure OLE DB Connection Manager

La boîte de dialogue Configurer le gestionnaire de connexions OLE DB vous permet d’ajouter une connexion à une source de données, qui peut être une nouvelle connexion ou la copie d’une connexion existante.Use the Configure OLE DB Connection Manager dialog box to add a connection to a data source, which can be either a new connection or a copy of an existing connection.

Notes

Si la source de données est MicrosoftMicrosoft Office Excel 2007, la source de données requiert un gestionnaire de connexions différent des versions antérieures d'Excel.If the data source is MicrosoftMicrosoft Office Excel 2007, the data source requires a different connection manager than earlier versions of Excel. Pour plus d’informations, consultez Établir une connexion à un classeur Excel.For more information, see Connect to an Excel Workbook.

Si la source de données est MicrosoftMicrosoft Office Access 2007, la source de données requiert un fournisseur OLE DB différent des versions antérieures d’Access.If the data source is MicrosoftMicrosoft Office Access 2007, the data source requires a different OLE DB provider than earlier versions of Access. Pour plus d’informations, consultez Établir une connexion à une base de données Access.For more information, see Connect to an Access Database.

Pour en savoir plus sur le gestionnaire de connexions OLE DB, consultez Gestionnaire de connexions OLE DB.To learn more about the OLE DB connection manager, see OLE DB Connection Manager.

OptionsOptions

Connexions de donnéesData connections
Sélectionnez une connexion de données OLE DB existante dans la liste.Select an existing OLE DB data connection from the list.

Propriétés des connexions de donnéesData connection properties
Permet d'afficher les propriétés et les valeurs relatives à la connexion de données OLE DB sélectionnée.View properties and values for the selected OLE DB data connection.

NouveauNew
Créez une connexion de données OLE DB à l’aide de la boîte de dialogue Gestionnaire de connexions .Create an OLE DB data connection by using the Connection Manager dialog box.

SupprimerDelete
Sélectionnez une connexion de données, puis supprimez-la à l’aide du bouton Supprimer .Select a data connection, and then delete it by using the Delete button.

Identités managées pour l’authentification des ressources AzureManaged Identities for Azure Resources Authentication

Lors de l’exécution de packages SSIS sur le runtime d’intégration Azure-SSIS dans Azure Data Factory, vous pouvez utiliser l’identité managée associée à votre fabrique de données pour l’authentification Azure SQL Database (ou Managed Instance).When running SSIS packages on Azure-SSIS integration runtime in Azure Data Factory, you can use the managed identity that is associated with your data factory for Azure SQL Database (or Managed Instance) authentication. La fabrique en question peut accéder à votre base de données et copier des données depuis ou vers celle-ci à l’aide de cette identité.The designated factory can access and copy data from or to your database by using this identity.

Pour utiliser l’authentification d’identité managée pour Azure SQL Database, suivez ces étapes afin de configurer votre base de données :To use managed identity authentication for Azure SQL Database, follow these steps to configure your database:

  1. Créez un groupe dans Azure AD.Create a group in Azure AD. Faites de l’identité managée un membre du groupe.Make the managed identity a member of the group.

    1. Recherchez l’identité managée de la fabrique de données à partir du portail Azure.Find the data factory managed identity from the Azure portal. Accédez aux Propriétés de votre fabrique de données.Go to your data factory's Properties. Copiez l’ID objet de l’identité managée.Copy the Managed Identity Object ID.

    2. Installez le module Azure AD PowerShell.Install the Azure AD PowerShell module. Connectez-vous à l’aide de la commande Connect-AzureAD.Sign in by using the Connect-AzureAD command. Exécutez les commandes suivantes pour créer un groupe et ajouter l’identité managée en tant que membre.Run the following commands to create a group and add the managed identity as a member.

      $Group = New-AzureADGroup -DisplayName "<your group name>" -MailEnabled $false -SecurityEnabled $true -MailNickName "NotSet"
      Add-AzureAdGroupMember -ObjectId $Group.ObjectId -RefObjectId "<your data factory managed identity object ID>"
      
  2. Provisionnez un administrateur Azure Active Directory pour votre serveur SQL Azure sur le portail Azure si ce n’est déjà fait.Provision an Azure Active Directory administrator for your Azure SQL server on the Azure portal if you haven't already done so. L’administrateur Azure AD peut être un utilisateur Azure AD ou un groupe Azure AD.The Azure AD administrator can be an Azure AD user or Azure AD group. Si vous accordez au groupe détenant l’identité managée un rôle d’administrateur, ignorez les étapes 3 et 4.If you grant the group with managed identity an admin role, skip steps 3 and 4. L’administrateur a un accès complet à la base de données.The administrator will have full access to the database.

  3. Créez des utilisateurs de base de données autonome pour le groupe Azure AD.Create contained database users for the Azure AD group. Connectez-vous à la base de données depuis ou vers laquelle vous souhaitez copier des données à l’aide d’outils tels que SSMS, avec une identité Azure AD qui a au moins l’autorisation ALTER ANY USER.Connect to the database from or to which you want to copy data by using tools like SSMS, with an Azure AD identity that has at least ALTER ANY USER permission. Exécutez la commande T-SQL suivante :Run the following T-SQL:

    CREATE USER [your AAD group name] FROM EXTERNAL PROVIDER;
    
  4. Accordez au groupe Azure AD les autorisations requises comme vous le feriez, entre autres, pour des utilisateurs SQL.Grant the Azure AD group needed permissions as you normally do for SQL users and others. Par exemple, exécutez le code suivant :For example, run the following code:

    ALTER ROLE [role name] ADD MEMBER [your AAD group name];
    

Pour utiliser l’authentification par identité managée pour Azure SQL Database Managed Instance, suivez ces étapes afin de configurer votre base de données :To use managed identity authentication for Azure SQL Database Managed Instance, follow these steps to configure your database:

  1. Provisionnez un administrateur Azure Active Directory pour votre instance managée sur le portail Azure si ce n’est déjà fait.Provision an Azure Active Directory administrator for your managed instance on the Azure portal if you haven't already done so. L’administrateur Azure AD peut être un utilisateur Azure AD ou un groupe Azure AD.The Azure AD administrator can be an Azure AD user or Azure AD group. Si vous accordez au groupe détenant l’identité managée un rôle d’administrateur, ignorez les étapes 2 à 5.If you grant the group with managed identity an admin role, skip steps 2-5. L’administrateur a un accès complet à la base de données.The administrator will have full access to the database.

  2. Recherchez l’identité managée de la fabrique de données à partir du portail Azure .Find the data factory managed identity from the Azure portal. Accédez aux Propriétés de votre fabrique de données.Go to your data factory's Properties. Copiez l’ID d’application de l’identité managée (pas l’ID d’objet de l’identité managée).Copy the Managed Identity Application ID (NOT Managed Identity Object ID).

  3. Convertissez l’identité managée de la fabrique de données en type binaire.Convert the data factory managed identity to binary type. Connectez-vous à la base de données MASTER dans votre instance managée à l’aide d’outils tels que SSMS, avec votre compte d’administrateur SQL/Active Directory.Connect to master database in your managed instance by using tools like SSMS, with your SQL/Active Directory admin account. Exécutez la commande T-SQL suivante sur la base de données MASTER pour obtenir votre ID d’application de l’identité managée sous forme binaire :Run the following T-SQL against master database to get your managed identity application ID as binary:

    DECLARE @applicationId uniqueidentifier = '{your managed identity application ID}'
    select CAST(@applicationId AS varbinary)
    
  4. Ajoutez l’identité managée de la fabrique de données en tant qu’utilisateur dans Azure SQL Database Managed Instance.Add the data factory managed identity as a user in Azure SQL Database Managed Instance. Exécutez la commande T-SQL suivante sur la base de données MASTER :Run the following T-SQL against master database:

    CREATE LOGIN [{a name for the managed identity}] FROM EXTERNAL PROVIDER with SID = {your managed identity application ID as binary}, TYPE = E
    
  5. Octroyez à l’identité managée de la fabrique de données les autorisations requises.Grant the data factory managed identity needed permissions. Exécutez la commande T-SQL suivante sur la base de données depuis ou vers laquelle vous souhaitez copier des données :Run the following T-SQL against the database from or to which you want to copy data:

    CREATE USER [{the managed identity name}] FOR LOGIN [{the managed identity name}] WITH DEFAULT_SCHEMA = dbo
    ALTER ROLE db_owner ADD MEMBER [{the managed identity name}]
    

Ensuite, configurez le fournisseur OLE DB pour le gestionnaire de connexions OLE DB.Then configure OLE DB provider for the OLE DB connection manager. Pour ce faire, vous disposez de deux options.There are two options to do this.

  1. Effectuez la configuration au moment du design.Configure at design time. Dans le concepteur SSIS, double-cliquez sur le gestionnaire de connexions OLE DB pour ouvrir la fenêtre Gestionnaire de connexions.In SSIS Designer, double-click the OLE DB connection manager to open the Connection Manager window. Dans la liste déroulante Fournisseur, sélectionnez Microsoft OLE DB Driver pour SQL Server.In the Provider drop-down list, select Microsoft OLE DB Driver for SQL Server.

    Notes

    Il est possible que les autres fournisseurs dans la liste déroulante ne prennent pas en charge l’authentification d’identité managée.Other providers in the drop-down list MIGHT NOT support managed identity authentication.

  2. Effectuez la configuration au moment de l’exécution.Configure at run time. Quand vous exécutez le package par le biais de SQL Server Management Studio (SSMS) ou de l’activité Exécuter le package SSIS d’Azure Data Factory, recherchez la propriété de gestionnaire de connexions ConnectionString pour le gestionnaire de connexions OLE DB et définissez la propriété de connexion Fournisseur sur MSOLEDBSQL (autrement dit, Microsoft OLE DB Driver pour SQL Server).When you execute the package via SQL Server Management Studio (SSMS) or Azure Data Factory Execute SSIS Package activity, find the connection manager property ConnectionString for the OLE DB connection manager and update the connection property Provider to MSOLEDBSQL (i.e, Microsoft OLE DB Driver for SQL Server).

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

Enfin, configurez l’authentification d’identité managée pour le gestionnaire de connexions OLE DB.Finally configure managed identity authentication for the OLE DB connection manager. Pour ce faire, vous disposez de deux options.There are two options to do this.

  1. Effectuez la configuration au moment du design.Configure at design time. Dans le concepteur SSIS, cliquez avec le bouton droit sur le gestionnaire de connexions OLE DB et cliquez sur Propriétés pour ouvrir la fenêtre Propriétés.In SSIS Designer, right-click the OLE DB connection manager and click Properties to open the Properties Window. Définissez la propriété ConnectUsingManagedIdentity sur True.Update the property ConnectUsingManagedIdentity to True.

    Notes

    La propriété du gestionnaire de connexions ConnectUsingManagedIdentity NE prend PAS effet (indiquant que l’authentification d’identité managée ne fonctionne pas) quand vous exécutez le package SSIS dans le concepteur SSIS ou MicrosoftMicrosoft SQL Server.Currently the connection manager property ConnectUsingManagedIdentity DOES NOT take effect (indicating that managed identity authentication does not work) when you run SSIS package in SSIS Designer or MicrosoftMicrosoft SQL Server.

  2. Effectuez la configuration au moment de l’exécution.Configure at run time. Quand vous exécutez le package par le biais de SSMS ou de l’activité Exécuter le package SQL, recherchez le gestionnaire de connexions OLE DB et définissez sa propriété ConnectUsingManagedIdentity sur True.When you execute the package via SSMS or Execute SQL Package activity, find the OLE DB connection manager and update its property ConnectUsingManagedIdentity to True.

    Notes

    Dans le runtime d’intégration Azure-SSIS, toutes les autres méthodes d’authentification (par exemple, sécurité intégrée, mot de passe) préconfigurées sur le gestionnaire de connexions OLE DB sont remplacées quand l’authentification d’identité managée est utilisée pour établir la connexion de base de données.In Azure-SSIS integration runtime, all other authentication methods (e.g., integrated security, password) preconfigured on the OLE DB connection manager will be overridden when managed identity authentication is used to establish database connection.

Notes

Pour configurer l’authentification d’identité managée sur les packages existants, regénérez votre projet SSIS avec le dernier concepteur SSIS au moins une fois et redéployez ce projet SSIS sur votre runtime d’intégration Azure-SSIS afin que la nouvelle propriété de gestionnaire de connexions ConnectUsingManagedIdentity soit automatiquement ajoutée à tous les gestionnaires de connexions OLE DB dans votre projet SSIS.To configure managed identity authentication on existing packages, please be sure to rebuild your SSIS project with the latest SSIS Designer at least once and redeploy that SSIS project to your Azure-SSIS integration runtime so that the new connection manager property ConnectUsingManagedIdentity will automatically be added to all OLE DB connection managers in your SSIS project.

Voir aussiSee Also

Source OLE DB OLE DB Source
Destination OLE DB OLE DB Destination
Tache d'exécution de requêtes SQL Execute SQL Task
Connexions Integration Services (SSIS)Integration Services (SSIS) Connections