Composant Script

Mis à jour : 17 juillet 2006

Le composant Script héberge le script et permet à un package d'inclure du code de script personnalisé et de l'exécuter. Vous pouvez utiliser le composant Script dans des packages pour :

• Appliquer plusieurs transformations aux données, au lieu d'utiliser plusieurs transformations dans le flux de données. Par exemple, un script peut ajouter les valeurs de deux colonnes, puis calculer la moyenne de la somme.
• Accéder aux règles métier dans un assembly .NET existant. Par exemple, un script peut appliquer une règle métier qui spécifie la plage de valeurs correctes dans une colonne Income.
• Utiliser des formules et des fonctions personnalisées en plus des fonctions et des opérateurs fournis par la grammaire des expressions Integration Services. Par exemple, validez les numéros de carte de crédit à l'aide de la formule LUHN.
• Valider les données des colonnes et ignorer les enregistrements contenant des données non valides. Par exemple, un script peut évaluer un montant de frais de port raisonnable et ignorer les enregistrements présentant des montants extrêmement élevés ou bas.

Le composant Script est un moyen simple et rapide d'inclure des fonctions personnalisées dans un flux de données. Néanmoins, si vous envisagez de réutiliser le code de script dans plusieurs packages, vous devez envisager de programmer un composant personnalisé au lieu d'utiliser le composant Script. Pour plus d'informations, consultez Developing a Custom Data Flow Component.

Le composant Script peut être utilisé en tant que source, transformation ou destination. Il prend en charge une entrée et plusieurs sorties. En fonction de l'utilisation qui est faite du composant, il prendra en charge une entrée ou des sorties, ou bien les deux. Le script est appelé par chaque ligne de l'entrée ou de la sortie.

• Utilisé comme source, le composant Script prend en charge plusieurs sorties.
• Utilisé comme transformation, le composant Script prend en charge une entrée et plusieurs sorties.
• Utilisé comme destination, le composant Script prend en charge une entrée.

Le composant Script ne prend pas en charge les affichages des erreurs.

Vous pouvez configurer le composant Script de plusieurs manières :

• Sélectionnez les colonnes d'entrée à référencer.
• Indiquez le script exécuté par le composant.
• Indiquez si le script est précompilé.
• Fournissez des listes de variables en lecture seule et en lecture/écrite séparées par des virgules.
• Ajoutez des sorties supplémentaires et ajoutez des colonnes de sortie auxquelles le script affecte des valeurs.

La boîte de dialogue Éditeur de transformation de script du concepteur SSIS permet de configurer une seule entrée.

Pour écrire vos scripts, vous devez accéder à l'environnement VSA (Visual Studio pour Applications) à partir de la boîte de dialogue Éditeur de transformation de script. VSA contient l'ensemble des fonctionnalités standard de l'environnement Visual Studio .NET, comme l'éditeur Visual Studio à code de couleur, IntelliSense et l'Explorateur d'objets. Le script utilisé par le composant Script est stocké dans la définition du package. Aucun fichier de script distinct n'est créé.

Modes du composant Script

Dans le concepteur SSIS, le composant Script est disponible en mode Création des métadonnées et en mode Création du code. En mode Création des métadonnées, vous pouvez ajouter et modifier les entrées et les sorties du composant Script, mais vous ne pouvez pas écrire de code. Une fois toutes les entrées et sorties configurées, vous devez basculer en mode Création du code afin d'écrire le script. Le composant Script génère automatiquement le code de base à partir des métadonnées des entrées et des sorties. Si vous modifiez les métadonnées une fois que le composant Script a généré le code de base, votre code risque de ne plus se compiler, car le code de base compilé mis à jour sera peut-être incompatible avec votre code.

Script

Le composant Script propose un projet VSA qui inclut une classe auto-générée, nommée ScriptMain, qui représente les métadonnées du composant. Par exemple, si le composant Script est utilisé en tant que transformation avec trois sorties, ScriptMain inclut une méthode pour chaque sortie. ScriptMain est le point d'entrée dans le script.

L'environnement de développement Visual Studio for Applications pour scripts prend uniquement en charge Microsoft Visual Basic .NET en tant que langage de script.

Pour plus d'informations sur la programmation du composant Script, consultez Extending the Data Flow with the Script Component. Pour obtenir des informations spécifiques sur la configuration du composant Script en tant que source, transformation ou destination, consultez Developing Specific Types of Script Components. Pour vous procurer d'autres exemples, notamment une destination ODBC, démontrant l'utilisation du composant Script, consultez Additional Script Component Examples.

Script précompilé

Vous pouvez configurer le composant Script de sorte qu'il précompile le script. Le script démarrera alors plus rapidement et pourra être utilisé dans un environnement 64 bits. Néanmoins, les packages contenant des scripts précompilés sont plus volumineux. Qui plus est, tout script compilé ne peut être débogué. Vous devez tenir compte de ces facteurs si vous décidez de précompiler le script.

Par défaut, le composant de script est configuré pour précompiler son script et la propriété PreCompile du composant prend la valeur True. La propriété PreCompile prend généralement la valeur False pendant le développement et le débogage d'un package, puis reprend la valeur True avant le déploiement du package.

Configuration du composant Script

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 de transformation de script, cliquez sur l'une des rubriques suivantes :

• Éditeur de transformation de script (page Colonnes d'entrée)
• Éditeur de transformation de script (page Entrées et sorties)
• Éditeur de transformation de script (page Script)
• Éditeur de transformation de script (Page Gestionnaire de connexions)

Pour plus d'informations sur les propriétés que vous pouvez définir dans la fenêtre Propriétés ou par programme, cliquez sur l'une des rubriques suivantes :

• Common Properties
• Source Custom Properties
• Transformation Custom Properties
• Destination Custom Properties

Pour plus d'informations sur la définition des propriétés, cliquez sur l'une des rubriques suivantes :

• Procédure : définir les propriétés d'un composant de flux de données à l'aide d'un éditeur de composant
• Procédure : définir les propriétés d'un composant de flux de données dans la fenêtre Propriétés

Voir aussi

Concepts

Transformations Integration Services
Observations relatives à Integration Services sur des ordinateurs 64 bits

Autres ressources

Extending the Data Flow with the Script Component

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications