Transformation de commande OLE DB
Mis à jour : 12 décembre 2006
La transformation de commande OLE DB exécute une instruction SQL pour chaque ligne d'un flux de données. Par exemple, vous pouvez exécuter une instruction SQL qui insère, met à jour ou supprime des lignes d'une table de base de données.
Vous pouvez configurer la transformation de commande OLE DB de plusieurs manières :
- Spécifiez l'instruction SQL exécutée par la transformation pour chaque ligne.
- Spécifiez le nombre de secondes accordées pour l'exécution de l'instruction SQL.
- Spécifiez la page de codes par défaut.
En général, l'instruction SQL inclut des paramètres. Les valeurs des paramètres sont stockées dans des colonnes externes dans l'entrée de transformation et le mappage d'une colonne d'entrée à une colonne externe mappe une colonne d'entrée à un paramètre. Par exemple, pour rechercher des lignes dans la table DimProduct par la valeur de leur colonne ProductKey et pour les supprimer, vous pouvez mapper la colonne externe nommée Param_0 à la colonne d'entrée nommée ProductKey, puis exécuter l'instruction SQL DELETE FROM DimProduct WHERE ProductKey = ?. La transformation de commande OLE DB fournit les noms des paramètres, que vous ne pouvez pas modifier. Les noms des paramètres sont Param_0, Param_1 et ainsi de suite.
Si vous configurez la transformation de commande OLE DB à l'aide de la boîte de dialogue Éditeur avancé, les paramètres de l'instruction SQL peuvent être mappés automatiquement à des colonnes externes dans l'entrée de transformation (et les caractéristiques de chaque paramètre définis) en cliquant sur le bouton Actualiser. Toutefois, si le fournisseur OLE DB utilisé par la transformation de commande OLE DB ne prend pas en charge la dérivation d'informations de paramètres à partir du paramètre, vous devez configurer les colonnes externes manuellement. Cela signifie que vous devez ajouter une colonne pour chaque paramètre à l'entrée externe de la transformation, mettre à jour les noms de colonnes de façon à utiliser des noms tels que Param_0, spécifier la valeur de la propriété DBParamInfoFlags, puis mapper les colonnes d'entrée qui contiennent des valeurs de paramètres aux colonnes externes.
La valeur de DBParamInfoFlags représente les caractéristiques du paramètre. Par exemple, la valeur 1 indique qu'il s'agit d'un paramètre d'entrée et la valeur 65 indique qu'il s'agit d'un paramètre d'entrée pouvant contenir une valeur nulle. Les valeurs doivent correspondre aux valeurs de l'énumération OLE DB DBPARAMFLAGSENUM. Pour plus d'informations, consultez la documentation de référence OLE DB.
La transformation de commande OLE DB inclut la propriété personnalisée SQLCommand. Cette propriété peut être mise à jour par une expression de propriété lors du chargement du package. Pour plus d'informations, consultez Informations de référence des expressions Integration Services, Utilisation des expressions de propriété dans des packages et Transformation Custom Properties.
Cette transformation possède une entrée, une sortie normale et une sortie d'erreur.
Résolution des problèmes liés à la transformation de commande OLE DB
À partir de Microsoft SQL Server 2005 Service Pack 2 (SP2), vous avez la possibilité de consigner les appels que la transformation de commande OLE DB effectue auprès de fournisseurs de données externes. Vous pouvez utiliser cette nouvelle fonctionnalité de journalisation pour résoudre des problèmes liés aux connexions et aux commandes que la transformation de commande OLE DB effectue vers des sources de données externes. Pour journaliser les appels que la transformation de commande OLE DB adresse à un fournisseur de données externes, activez la journalisation des packages et sélectionnez l'événement Diagnostic au niveau du package. Pour plus d'informations, consultez Dépannage de l'exécution des packages.
Configuration de la transformation de commande OLE DB
Vous pouvez définir les propriétés par le biais du concepteur SSIS ou par programme.
Pour plus d'informations sur les propriétés que vous pouvez définir dans la boîte de dialogue Éditeur avancé ou par programme, cliquez sur l'une des rubriques suivantes :
Pour plus d'informations sur la façon de définir des propriétés, cliquez sur l'une des rubriques suivantes :
- Procédure : configurer la transformation de commande OLE DB
- Procédure : définir les propriétés d'un composant de flux de données dans la fenêtre Propriétés
- Procédure : définir les propriétés d'un composant de flux de données à l'aide de l'éditeur avancé
Voir aussi
Concepts
Création du flux de données d'un package
Transformations Integration Services
Aide et Informations
Assistance sur SQL Server 2005
Historique des modifications
| Version | Historique |
|---|---|
12 décembre 2006 |
|
5 décembre 2005 |
|