Définir les propriétés d'un package
S’applique à :
SQL Server SSIS Integration Runtime dans Azure Data Factory
Lorsque vous créez un package dans SQL Server Data Tools (SSDT) à l'aide de l'interface graphique fournie par Integration Services , 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 :
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
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 Restart Packages by Using Checkpoints.
| 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é. Ces valeurs sont Never, IfExistset Always. La valeur par défaut est Neverpour 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. |
Notes
L’option /CheckPointing on de dtexec revient à définir la propriété SaveCheckpoints du package sur True, et la propriété CheckpointUsage sur 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, ce qui indique 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, BelowNormalet Idle. La valeur par défaut de cette propriété 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 une valeur d'exécution facultative pour le package.
| Propriété | Description |
|---|---|
| ForcedExecutionValue | Si ForceExecutionValue a la valeur True, valeur indiquant la valeur d’exécution facultative retournée par le package. La valeur par défaut de cette propriété est 0. |
| ForcedExecutionValueType | Type de données de ForcedExecutionValue. La valeur par défaut de cette propriété est Int32. |
| ForceExecutionValue | Valeur booléenne qui indique si la valeur d'exécution facultative du conteneur doit être forcée de contenir une valeur particulière. 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. |
| Identifiant | 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. |
| Nom | Nom du package. |
| PackageType | Type de package. Les valeurs possibles sont Default, DTSDesigner, DTSDesigner100, DTSWizard, SQLDBMaintet 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 Expressions de propriété dans des packages.
| Propriété | Description |
|---|---|
| Configurations | Ensemble de configurations utilisées par le package. Cliquez sur le bouton Parcourir (...) pour afficher et configurer les configurations du package. |
| Expressions | Cliquez sur le bouton Parcourir (...) 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, et non seulement pour les propriétés énumérées dans la fenêtre Propriétés. Pour plus d’informations, consultez 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, Failureet 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. Ces valeurs sont Disabled, Enabledet UseParentSetting. La valeur par défaut de cette propriété 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 dans 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 la 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 Access Control for Sensitive Data in Packages.
| Propriété | Description |
|---|---|
| PackagePassword | Mot de passe pour les niveaux de protection de package (EncryptSensitiveWithPassword et EncryptAllWithPassword) qui nécessitent des mots de passe. |
| ProtectionLevel | Niveau de protection du package. Cette propriété peut prendre les valeurs DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPasswordet ServerStorage. La valeur par défaut de cette propriété 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 Transactions Integration Services.
| Propriété | Description |
|---|---|
| IsolationLevel | Niveau d'isolement de la transaction sur package. Cette propriété peut prendre les valeurs Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableRead, Serializableet Snapshot. La valeur par défaut de cette propriété est Serializable. Remarque : la valeur Snapshot de la propriété IsolationLevel est incompatible avec les transactions de package. Par conséquent, vous ne pouvez pas utiliser la propriété IsolationLevel pour définir le niveau d’isolation des transactions de package sur Snapshot. Utilisez plutôt une requête SQL pour définir les transactions de package sur Snapshot. Pour plus d’informations, consultez SET TRANSACTION ISOLATION LEVEL (Transact-SQL). Le système applique la propriété IsolationLevel aux transactions de package uniquement lorsque la propriété TransactionOption a la valeur Required. La valeur de la propriété IsolationLevel demandée par un conteneur enfant est ignorée lorsque les conditions suivantes sont remplies : La valeur de la propriété TransactionOption du conteneur enfant est Supported. Le conteneur enfant rejoint la transaction d'un conteneur parent. La valeur de la propriété IsolationLevel demandée par le conteneur est respectée uniquement lorsque le conteneur lance une nouvelle transaction. Un conteneur lance une nouvelle transaction lorsque les conditions suivantes sont remplies : La valeur de la propriété TransactionOption du conteneur est Required. Le parent n'a pas déjà démarré de transaction. Pour plus d’informations, consultez IsolationLevel. |
| TransactionOption | Participation transactionnelle du package. Cette propriété peut prendre les valeurs NotSupported, Supportedet Required. La valeur par défaut de cette propriété 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. |
Définir les propriétés d’un package dans la fenêtre Propriétés
Dans SQL Server Data Tools (SSDT), ouvrez le projet Integration Services contenant le package à configurer.
Dans l’Explorateur de solutions, double-cliquez sur le package pour l’ouvrir dans le concepteur SSIS , ou cliquez avec le bouton droit et sélectionnez Concepteur de vues.
Cliquez sur l’onglet Flux de contrôle , puis effectuez l’une des opérations suivantes :
Cliquez avec le bouton droit n’importe où dans l’arrière-plan de la surface de dessin du flux de contrôle, puis cliquez sur Propriétés.
Dans le menu Affichage , cliquez sur Fenêtre Propriétés.
Modifiez les propriétés du package dans la fenêtre Propriétés .
Pour enregistrer le package mis à jour, dans le menu Fichier , cliquez sur Enregistrer les éléments sélectionnés .