Share via


Transformation de commande OLE DB

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 Expressions Integration Services (SSIS), Expressions de propriété dans des packages et Propriétés personnalisées des transformations.

Cette transformation a une entrée, une sortie standard et une sortie d'erreur.

Journalisation

Vous pouvez consigner les appels émis par la transformation de commande OLE DB vers les fournisseurs de données externes. Vous pouvez utiliser cette fonctionnalité de journalisation pour résoudre des problèmes liés aux connexions et aux commandes vers des sources de données externes effectuées par la transformation de commande OLE DB. Pour consigner les appels que la transformation de commande OLE DB adresse à des fournisseurs 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 Outils de dépannage pour l'exécution des packages.

Tâches associées

Vous pouvez configurer la transformation à l'aide du concepteur SSIS ou du modèle objet. Pour plus d'informations sur la configuration de la transformation à l'aide du concepteur SSIS, consultez Configurer la transformation de commande OLE DB. Pour plus d'informations sur la configuration par programme de cette transformation, consultez le Guide du développeur.

Contenu connexe

Icône Integration Services (petite) Rester à jour avec Integration Services

Pour obtenir les derniers téléchargements, articles, exemples et vidéos de Microsoft, ainsi que des solutions sélectionnées par la communauté, visitez la page Integration Services sur MSDN :


Pour recevoir une notification automatique de ces mises à jour, abonnez-vous aux flux RSS disponibles sur la page.

Voir aussi

Concepts

Flux de données

Transformations Integration Services