Simulation d'une sortie d'erreur pour le composant Script
S’applique à : 
SQL Server SSIS Integration Runtime dans Azure Data Factory
Bien qu'il soit impossible de configurer directement une sortie en tant que sortie d'erreur dans le composant Script à des fins de gestion automatique des lignes d'erreur, vous pouvez reproduire les fonctionnalités d'une sortie d'erreur intégrée en créant une sortie supplémentaire et en utilisant une logique conditionnelle dans votre script afin de diriger des lignes vers cette sortie, le cas échéant. Vous pouvez imiter le comportement d'une sortie d'erreur intégrée en ajoutant deux colonnes de sortie supplémentaires pour recevoir le numéro d'erreur et l'ID de la colonne dans laquelle une erreur s'est produite.
Si vous souhaitez ajouter la description d'erreur qui correspond à un code d'erreur Integration Services prédéfini spécifique, vous pouvez utiliser la méthode GetErrorDescription de l'interface IDTSComponentMetaData100, disponible via la propriété ComponentMetaData du composant Script.
Exemple
L'exemple indiqué ici utilise un composant Script configuré en tant que transformation qui possède deux sorties synchrones. L'objectif du composant Script est de filtrer les lignes d'erreur parmi les données d'adresse dans l'exemple de base de données AdventureWorks. Cet exemple fictif suppose que nous préparons une promotion pour les clients d'Amérique du Nord et que nous avons besoin d'éliminer les adresses qui ne se trouvent pas en Amérique du Nord par filtrage.
Pour configurer l'exemple
Avant de créer le composant Script, créez un gestionnaire de connexions et configurez une source de flux de données qui sélectionne les données d'adresse de l'exemple de base de données AdventureWorks. Pour cet exemple, qui examine uniquement la colonne CountryRegionName, vous pouvez utiliser simplement la vue Person.vStateCountryProvinceRegion, ou vous pouvez sélectionner des données en liant les tables Person.Address, Person.StateProvince et Person.CountryRegion.
Ajoutez un nouveau composant Script à l'aire du concepteur de flux de données et configurez-le en tant que transformation. Ouvrez l' Éditeur de transformation de script.
Dans la page Script, définissez la propriété ScriptLanguage sur le langage de script que vous souhaitez utiliser pour coder le script.
Cliquez sur Modifier le script pour ouvrir Microsoft Visual Studio Tools for Applications (VSTA).
Dans la méthode Input0_ProcessInputRow, tapez ou collez l’exemple de code suivant.
Fermez VSTA.
Dans la page Colonnes d’entrée, sélectionnez les colonnes que vous souhaitez traiter dans la transformation de script. Cet exemple utilise uniquement la colonne CountryRegionName. Les colonnes d'entrée disponibles que vous n'avez pas sélectionnées seront tout simplement transférées sans être modifiées dans le flux de données.
Dans la page Entrées et sorties, ajoutez une nouvelle deuxième sortie et définissez sa valeur SynchronousInputID sur l’ID de l’entrée, qui correspond également à la valeur de la propriété SynchronousInputID de la sortie par défaut. Définissez la propriété ExclusionGroup des deux sorties sur la même valeur différente de zéro (par exemple, 1) pour indiquer que chaque ligne sera dirigée vers une seule des deux sorties. Attribuez à la nouvelle sortie d'erreur un nom distinct, tel que « MyErrorOutput ».
Ajoutez des colonnes de sortie supplémentaires à la nouvelle sortie d'erreur pour capturer les informations d'erreur souhaitées, qui peuvent inclure le code de l'erreur, l'ID de la colonne dans laquelle l'erreur s'est produite et éventuellement la description de l'erreur. Cet exemple crée les nouvelles colonnes, ErrorColumn et ErrorMessage. Si vous interceptez des erreurs Integration Services prédéfinies dans votre propre implémentation, assurez-vous d'ajouter une colonne ErrorCode pour le numéro d'erreur.
Notez la valeur d'ID de la ou des colonnes d'entrée dans lesquelles le composant Script va rechercher des conditions d'erreur. Cet exemple utilise cet identificateur de colonne pour renseigner la valeur ErrorColumn.
Fermez l’Éditeur de transformation de script.
Attachez les sorties du composant Script aux destinations appropriées. Les destinations de fichiers plats sont les plus faciles à configurer pour les tests ad hoc.
Exécutez le package.
Public Overrides Sub Input0_ProcessInputRow(ByVal Row As Input0Buffer)
If Row.CountryRegionName <> "Canada" _
And Row.CountryRegionName <> "United States" Then
Row.ErrorColumn = 68 ' ID of CountryRegionName column
Row.ErrorMessage = "Address is not in North America."
Row.DirectRowToMyErrorOutput()
Else
Row.DirectRowToOutput0()
End If
End Sub
public override void Input0_ProcessInputRow(Input0Buffer Row)
{
if (Row.CountryRegionName!="Canada"&&Row.CountryRegionName!="United States")
{
Row.ErrorColumn = 68; // ID of CountryRegionName column
Row.ErrorMessage = "Address is not in North America.";
Row.DirectRowToMyErrorOutput();
}
else
{
Row.DirectRowToOutput0();
}
}
Voir aussi
Gestion des erreurs dans les données
Utilisation de sorties d'erreur dans un composant de flux de données
Création d'une transformation synchrone à l'aide du composant Script