Définition des propriétés d'un package

Mis à jour : 17 juillet 2006

Lorsque vous créez un package dans Business Intelligence Development Studio à l'aide de l'interface graphique fournie par SQL Server 2005 Integration Services (SSIS), vous définissez les propriétés de l'objet de package dans la fenêtre Propriétés.

La fenêtre Propriétés affiche une liste de propriétés triées par catégorie et par ordre alphabétique. Pour réorganiser la fenêtre Propriétés par catégorie, cliquez sur l'icône Catégories.

Dans cette organisation, la fenêtre Propriétés regroupe les propriétés dans les catégories suivantes :

• Points de contrôle
• Exécution
• Valeur d'exécution forcée
• Identification
• Divers
• Sécurité
• Transactions
• Version

Pour plus d'informations sur les propriétés d'un package que vous ne pouvez pas définir dans la fenêtre Propriétés, consultez Package.

Pour définir les propriétés d'un package dans la fenêtre Propriétés

• Procédure : définir les propriétés d'un package dans la fenêtre Propriétés

Propriétés par catégorie

Les tableaux qui suivent énumèrent les propriétés d'un package par catégorie.

Points de contrôle

Vous pouvez utiliser les propriétés de cette catégorie pour redémarrer le package à partir d'un point d'échec dans le flux de contrôle du package, au lieu de réexécuter le package depuis le début de son flux de contrôle. Pour plus d'informations, consultez Utilisation des points d'arrêt dans les packages.

Propriété	Description
CheckpointFileName	Nom du fichier qui capture les informations de point de contrôle permettant à un package de redémarrer. Une fois le package terminé avec succès, le fichier est supprimé.
CheckpointUsage	Indique à quel moment un package peut être redémarré. Cette propriété peut prendre les valeurs Never, IfExists et Always. La valeur par défaut est Never pour indiquer que le package ne peut pas être redémarré. Pour plus d'informations, consultez DTSCheckpointUsage.
SaveCheckpoints	Indique si les points de contrôle sont écrits dans le fichier de point de contrôle lors de l'exécution du package. La valeur par défaut de cette propriété est False.

Remarque :
L'option /CheckPointing on de dtexec revient à définir la propriété SaveCheckpoints du package à True et la propriété CheckpointUsage à Always. Pour plus d'informations, consultez Utilitaire dtexec.

Exécution

Les propriétés de cette catégorie permettent de configurer le comportement de l'objet de package au moment de l'exécution.

Propriété	Description
DelayValidation	Indique si la validation du package est retardée jusqu'à l'exécution du package. La valeur par défaut de cette propriété est False.
Disable	Indique si le package est désactivé. La valeur par défaut de cette propriété est False.
DisableEventHandlers	Indique si les gestionnaires d'événements du package sont exécutés. La valeur par défaut de cette propriété est False.
FailPackageOnFailure	Indique si le package échoue en cas d'erreur dans un composant du package. La seule valeur possible pour cette propriété est False.
FailParentOnError	Indique si le conteneur parent échoue en cas d'erreur dans un conteneur enfant. La valeur par défaut de cette propriété est False.
MaxConcurrentExecutables	Nombre de fichiers exécutables pouvant être exécutés simultanément par le package. La valeur par défaut de cette propriété est -1 pour indiquer qu'aucune limite n'est appliquée.
MaximumErrorCount	Nombre maximal d'erreurs pouvant se produire avant arrêt de l'exécution d'un package. La valeur par défaut de cette propriété est 1.
PackagePriorityClass	Classe de priorité du thread Win32 du package. Cette propriété peut prendre les valeurs Default, AboveNormal, Normal, BelowNormal et Idle. La valeur par défaut est Default. Pour plus d'informations, consultez DTSPriorityClass.

Valeur d'exécution forcée

Les propriétés de cette catégorie permettent de configurer les résultats d'exécution du package.

Propriété	Description
ForcedExecutionValue	Si ForceExecutionValue a pour valeur True, valeur indiquant la valeur d'exécution renvoyée par le package. La valeur par défaut de cette propriété est 0.
ForcedExecutionValueType	Type de données de ForcedExecutionValue.
ForceExecutionValue	Indique si la valeur d'exécution du package est forcée. La valeur par défaut de cette propriété est False.

Identification

Les propriétés de cette catégorie fournissent des informations telles que l'identificateur unique et le nom du package.

Propriété	Description
CreationDate	Date de création du package.
CreatorComputerName	Nom de l'ordinateur sur lequel le package a été créé.
CreatorName	Nom de la personne qui a créé le package.
Description	Description des fonctionnalités du package.
ID	Identificateur global unique du package, affecté lors de la création du package. Cette propriété est en lecture seule. Pour générer une nouvelle valeur aléatoire pour la propriété ID, sélectionnez <Générer un nouvel ID> dans la liste déroulante.
Name	Nom du package.
PackageType	Type de package. Cette propriété peut prendre les valeurs Default, DTSDesigner, DTSDesigner90, DTSWizard, SQLDBMaint et SQLReplication. La valeur par défaut de cette propriété est Default. Pour plus d'informations, consultez DTSPackageType.

Divers

Les propriétés de cette catégorie sont utilisées pour accéder aux configurations et aux expressions utilisées par un package et pour fournir des informations sur les paramètres régionaux et le mode de journalisation du package. Pour plus d'informations, consultez Utilisation des expressions de propriété dans des packages.

Propriété

Description

Configurations

Ensemble de configurations utilisées par le package. Cliquez sur le bouton (…) pour afficher et configurer les configurations du package.

Expressions

Cliquez sur le bouton (…) pour créer des expressions pour les propriétés du package.

Remarque :

Vous pouvez créer des expressions pour toutes les propriétés du package incluses dans le modèle d'objet, pas seulement pour les propriétés énumérées dans la fenêtre Propriétés.

Pour plus d'informations, consultez Utilisation des expressions de propriété dans des packages.

Pour afficher les expressions de propriétés existantes, développez Expressions. Cliquez sur le bouton (…) dans la zone de texte d'une expression pour modifier et évaluer une expression.

ForceExecutionResult

Résultat d'exécution du package. 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.

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 package. Cette propriété peut prendre les valeurs Disabled, Enabled et UseParentSetting. La valeur par défaut est UseParentSetting. Pour plus d'informations, consultez DTSLoggingMode.

OfflineMode

Indique si le package est en mode hors connexion. Cette propriété est en lecture seule. Elle est définie au niveau du projet. Normalement, le concepteur SSIS tente de se connecter à chaque source de données utilisée par votre package pour valider les métadonnées associées aux sources et aux destinations. Vous pouvez activer l'option Travailler hors connexion du menu SSIS, avant même d'ouvrir un package, pour empêcher ces tentatives de connexion et les erreurs de validation qui en résultent lorsque les sources de données ne sont pas disponibles. Vous pouvez également activer l'option Travailler hors connexion pour accélérer les opérations exécutées depuis le concepteur, puis la désactiver dès que vous souhaitez valider votre package.

SuppressConfigurationWarnings

Indique sur les avertissements générés par les configurations sont supprimés. La valeur par défaut de cette propriété est False.

UpdateObjects

Indique si le package est mis à jour pour utiliser des versions plus récentes des objets qu'il contient, si des versions plus récentes sont disponibles. Par exemple, si cette propriété a pour valeur True, un package incluant une tâche d'insertion en bloc est mis à jour pour utiliser la version plus récente de cette tâche fournie par Integration Services. La valeur par défaut de cette propriété est False.

Sécurité

Les propriétés de cette catégorie sont utilisées pour définir le niveau de protection du package. Pour plus d'informations, consultez Définition du niveau de protection des packages.

Propriété	Description
PackagePassword	Mot de passe des niveaux de protection du package (EncryptSensitiveWithPassword et EncryptAllWithPassword) nécessitant un mot de passe.
ProtectionLevel	Niveau de protection du package. Cette propriété peut prendre les valeurs DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPassword et ServerStorage. La valeur par défaut est EncryptSensitiveWithUserKey. Pour plus d'informations, consultez DTSProtectionLevel.

Transactions

Les propriétés de cette catégorie permettent de configurer le niveau d'isolement et l'option de transaction du package. Pour plus d'informations, consultez Incorporation des transactions dans les packages.

Propriété	Description
IsolationLevel	Niveau d'isolement de la transaction sur package. Cette propriété peut prendre les valeurs Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializable et Snapshot. La valeur par défaut est Serializable. Pour plus d'informations, consultez IsolationLevel.
TransactionOption	Participation transactionnelle du package. Cette propriété peut prendre les valeurs NotSupported, Supported et Required. La valeur par défaut est Supported. Pour plus d'informations, consultez DTSTransactionOption.

Version

Les propriétés de cette catégorie fournissent des informations sur la version de l'objet de package.

Propriété	Description
VersionBuild	Numéro de version de la build du package.
VersionComments	Commentaires sur la version du package.
VersionGUID	Identificateur global unique de la version du package. Cette propriété est en lecture seule.
VersionMajor	Dernière version majeure du package.
VersionMinor	Dernière version mineure du package.

Voir aussi

Autres ressources

Création de packages dans le concepteur SSIS

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
17 juillet 2006	Contenu modifié : Ajout d'informations sur la manière d'empêcher des erreurs de validation en travaillant hors connexion.
14 avril 2006	Contenu modifié : Ajout d'informations sur la propriété ForceExecutionResult.