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 Informations de référence des expressions Integration Services, Utilisation des expressions de propriété dans des packages et Propriétés personnalisées des transformations.

Cette transformation possède une entrée, une sortie normale et une sortie d'erreur.