Conteneurs Integration Services

Mis à jour : 14 avril 2006

Les conteneurs sont des objets de SQL Server 2005 Integration Services (SSIS) qui fournissent une structure aux packages et des services aux tâches. Ils prennent en charge les flux de contrôle répétitifs dans les packages, et regroupent les tâches et les conteneurs en unités de travail significatives. Outre des tâches, les conteneurs peuvent comprendre d'autres conteneurs.

Les packages utilisent les conteneurs aux fins suivantes :

  • Répéter des tâches pour tous les éléments d'une collection, tels que les fichiers d'un dossier, des schémas ou des objets SMO (SQL Server Management Objects). Par exemple, un package peut exécuter des instructions Transact-SQL résidant dans plusieurs fichiers.
  • Répéter des tâches jusqu'à ce qu'une expression spécifiée renvoie la valeur false. Par exemple, un package peut envoyer un message électronique différent sept fois, à raison d'une fois par jour de la semaine.
  • Regrouper les tâches et les conteneurs qui doivent réussir ou échouer en tant qu'unité. Par exemple, un package peut regrouper les tâches qui suppriment et ajoutent des lignes dans une table de base de données, puis valider ou annuler toutes les tâches si l'une d'elles échoue.

Types de conteneurs

Integration Services met à votre disposition quatre types de conteneurs pour la création de packages. Le tableau suivant décrit ces types de conteneurs.

Conteneur Description

Conteneur de boucles Foreach

Exécute un flux de contrôle de façon répétitive à l'aide d'un énumérateur.

Conteneur de boucles For

Exécute un flux de contrôle de façon répétitive en testant une condition.

Conteneur de séquences

Regroupe les tâches et les conteneurs en flux de contrôle représentant des sous-ensembles du flux de contrôle des packages.

Conteneur d'hôte de tâche

Fournit des services à une seule tâche.

Les packages et les gestionnaires d'événements sont également des types de conteneurs. Pour plus d'informations, consultez Packages Integration Services et Gestionnaires d'événements d'Integration Services.

Résumé des propriétés de conteneur

Tous les types de conteneurs possèdent un ensemble de propriétés communes. Si vous créez des packages à l'aide des outils graphiques fournis par Integration Services, la fenêtre Propriétés répertorie les propriétés suivantes pour les conteneurs de boucle Foreach, les conteneurs de boucle For et les conteneurs Sequence. Les propriétés du conteneur d'hôte de tâche sont configurées dans le cadre de la configuration de la tâche encapsulée par l'hôte de tâche. Définissez les propriétés de l'hôte de tâche lorsque vous configurez la tâche.

Propriété Description

DelayValidation

Indique si la validation du conteneur est retardée jusqu'à l'exécution. La propriété contient une valeur booléenne dont la valeur est False.

Description

Description du conteneur. La propriété contient une chaîne mais peut être est vide.

Disable

Indique si le conteneur s'exécute. La propriété contient une valeur booléenne dont la valeur par défaut est False.

DisableEventHandlers

Indique si les gestionnaires d'événements associés au conteneur s'exécutent. La propriété contient une valeur booléenne dont la valeur par défaut est False.

FailPackageOnFailure

Indique si le package échoue en cas d'erreur dans le conteneur. La propriété contient une valeur booléenne dont la valeur par défaut est False.

FailParentOnFailure

Indique si le conteneur parent échoue en cas d'erreur dans le conteneur. La propriété contient une valeur booléenne dont la valeur par défaut est False.

ForcedExecutionValue

Si ForceExecutionValue a pour valeur True, correspond à une valeur indiquant la valeur d'exécution renvoyée par le conteneur. La valeur par défaut de cette propriété est 0.

ForcedExecutionValueType

Type de données de ForcedExecutionValue.

ForceExecutionResult

Indique si la valeur d'exécution du conteneur est forcée. La propriété contient une valeur booléenne dont la valeur par défaut est False.

ForceExecutionValue

Résultat de l'exécution du conteneur. Cette propriété peut prendre les valeurs None, Success, Failure et Completion. La valeur par défaut de cette propriété est None. Pour plus d'informations, consultez T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult.

ID

Identificateur global unique du conteneur, affecté lors de la création du package. Cette propriété est en lecture seule.

IsolationLevel

Niveau d'isolement de la transaction sur conteneur. Cette propriété peut prendre les valeurs Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializable et Snapshot. La valeur par défaut de cette propriété est Serializable. Pour plus d'informations, consultez IsolationLevel.

LocaleID

Paramètre régional Microsoft Win32. La valeur par défaut de cette propriété est le paramètre régional du système d'exploitation sur l'ordinateur local.

LoggingMode

Valeur qui indique le comportement de journalisation du conteneur. Cette propriété peut prendre les valeurs Disabled, Enabled et UseParentSetting. La valeur par défaut de cette propriété est UseParentSetting. Pour plus d'informations, consultez DTSLoggingMode.

MaximumErrorCount

Nombre maximal d'erreurs pouvant se produire avant l'arrêt d'un conteneur. La valeur par défaut de cette propriété est 1.

Name

Nom du conteneur.

TransactionOption

Participation transactionnelle du conteneur. Cette propriété peut prendre les valeurs NotSupported, Supported et Required. La valeur par défaut de cette propriété est Supported. Pour plus d'informations, consultez DTSTransactionOption.

Pour plus d'informations sur toutes les propriétés disponibles pour les conteneurs de boucle Foreach, les conteneurs de boucle For, les conteneurs Sequence et les conteneurs d'hôte de tâche lorsqu'ils sont configurés par programmation, consultez les rubriques API Integration Services suivantes :

Objets étendant les fonctionnalités des conteneurs

Les conteneurs comprennent des flux de contrôle composés d'exécutables et de contraintes de précédence, et peuvent utiliser des gestionnaires d'événements et des variables. Le conteneur d'hôte de tâche est une exception : étant donné que celui-ci encapsule une seule tâche, il n'utilise pas de contraintes de priorité.

Exécutables

Les exécutables désignent les tâches de niveau conteneur et tous les conteneurs se trouvant dans le conteneur. Un exécutable peut être l'une des tâches ou l'un des conteneurs fournis par Integration Services, ou bien une tâche personnalisée. Pour plus d'informations, consultez Tâches Integration Services et Conteneurs Integration Services.

Contraintes de priorité

Les contraintes de priorité relient en un flux de contrôle ordonné les conteneurs et les tâches figurant dans le même conteneur parent. Pour plus d'informations, consultez Contraintes de précédence.

Gestionnaires d'événements

Les gestionnaires d'événements au niveau conteneur répondent aux événements déclenchés par le conteneur ou par les objets figurant dans celui-ci. Pour plus d'informations, consultez Gestionnaires d'événements d'Integration Services.

Variables

Les variables utilisées dans les conteneurs comprennent les variables système de niveau conteneur fournies par Integration Services et les variables définies par l'utilisateur utilisées par le conteneur. Pour plus d'informations, consultez Variables Integration Services.

Voir aussi

Concepts

Éléments de flux de contrôle

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version Historique

14 avril 2006

Nouveau contenu :
  • Ajout de la section qui décrit les propriétés de conteneur.