Paramètres Integration Services (SSIS)

Les paramètres Integration Services (SSIS) vous permettent d'affecter des valeurs aux propriétés dans des packages au moment de l'exécution du package. Vous pouvez créer des paramètres de projet au niveau du projet et des paramètres de package au niveau du package. Les paramètres du projet sont utilisés pour fournir une entrée externe que le projet reçoit à un ou plusieurs packages du projet. L'utilisation de paramètres de package vous permet de modifier l'exécution du package sans avoir à modifier et à redéployer le package.

Dans Outils de données SQL Server vous créez, modifiez ou supprimez les paramètres d'un projet à l'aide de la fenêtre Project.params. Vous créez, modifiez et supprimez les paramètres d'un package à l'aide de l'onglet Paramètres dans le Concepteur SSIS. Vous associez un nouveau paramètre ou un paramètre existant à une propriété de tâche à l'aide de la boîte de dialogue Paramétrer. Pour plus d'informations sur l'utilisation de la fenêtre Project.params et l'onglet Paramètres, consultez Créer des paramètres. Pour plus d'informations sur la boîte de dialogue Paramétrer, consultez Paramétrer (boîte de dialogue).

Paramètres et modèle de déploiement de package

En général, si vous déployez un package à l'aide du modèle de déploiement de package, vous devez utiliser les configurations au lieu des paramètres.

Lorsque vous déployez un package qui contient des paramètres à l'aide du modèle de déploiement de package, puis exécutez le package, les paramètres ne sont pas appelés au moment de l'exécution. Si le package contient des paramètres de package et des expressions dans le package utilisent les paramètres, les valeurs résultantes sont appliquées au moment de l'exécution. Si le package contient des paramètres de projet, l'exécution du package peut échouer.

Paramètres et modèle de déploiement de projet

Lorsque vous déployez un projet sur le serveur Integration Services, vous utilisez des vues, des procédures stockées et l'interface utilisateur SQL Server Management Studio pour exécuter le projet et les paramètres du package. Pour plus d'informations, consultez les rubriques ci-dessous.

• Vues (catalogue Integration Services)

• Procédures stockées (catalogue Integration Services)

• Boîte de dialogue Configurer

• Boîte de dialogue d'exécution de package

Valeurs des paramètres

Attribuez au plus trois types différents de valeurs à un paramètre. Lorsque l'exécution d'un package démarre, une valeur unique est utilisée pour le paramètre, et le paramètre est résolu à sa valeur littérale finale.

Le tableau qui suit énumère les types de valeurs.

Utilisez un paramètre unique pour affecter une valeur à plusieurs propriétés des packages. Il n'est possible d'affecter une valeur à une propriété de package unique qu'à partir d'un paramètre unique.

Exécutions et valeurs de paramètres

L'exécution est un objet qui représente une instance unique de l'exécution du package. Lorsque vous créez une exécution, vous spécifiez tous les détails nécessaires pour exécuter un package, tel que les valeurs de paramètres d'exécution. Vous pouvez également modifier les valeurs de paramètres pour les exécutions existantes.

Lorsque vous définissez de manière explicite une valeur de paramètre d'exécution, cette valeur s'applique uniquement à cette instance d'exécution particulière. La valeur d'exécution est utilisée à la place d'une valeur de serveur ou d'une valeur de conception. Si vous ne définissez pas de valeur d'exécution de manière explicite, et qu'une valeur de serveur a été spécifiée, la valeur de serveur est utilisée.

Lorsqu'un paramètre est marqué comme requis, une valeur de serveur ou une valeur d'exécution doit être spécifiée pour ce paramètre. Sinon, le package correspondant ne s'exécute pas. Bien que le paramètre dispose d'une valeur par défaut au moment de la conception, elle ne sera jamais utilisée une fois le projet déployé.

Variables d'environnement

Si un paramètre référence une variable d'environnement, la valeur littérale de cette variable est résolue par l'intermédiaire de la référence environnementale spécifiée et est appliquée au paramètre. La valeur de paramètre littérale finale utilisée pour l'exécution du package est appelée « valeur de paramètre d'exécution ». Vous spécifiez la référence environnementale pour une exécution à l'aide de la boîte de dialogue Exécuter.

Si un paramètre de projet référence une variable d'environnement et la valeur littérale de la variable n'est pas résolue au moment de l'exécution, la valeur de conception est utilisée. La valeur de serveur n'est pas utilisée.

Pour afficher les variables d'environnement affectées aux valeurs de paramètre, interrogez l'affichage catalog.object_parameters. Pour plus d'informations, consultez catalog.object_parameters (base de données SSISDB).

Détermination des valeurs de paramètre d'exécution

La procédure stockée et les vues Transact-SQL suivantes peuvent être utilisées pour afficher et définir des valeurs de paramètre.

• catalog.execution_parameter_values (base de données SSISDB) (vue)
  Affiche les valeurs de paramètre effectives qui seront utilisées par une exécution spécifique

• catalog.get_parameter_values (base de données SSISDB) (procédure stockée)
  Résout et affiche les valeurs effectives du package et de la référence environnementale spécifiés

• catalog.object_parameters (base de données SSISDB) (vue)
  Affiche les paramètres et les propriétés de tous les packages et les projets dans le catalogue Integration Services, y compris les valeurs de conception par défaut et les valeurs de serveur par défaut.

• catalog.set_execution_parameter_value (base de données SSISDB)
  Définit la valeur d'un paramètre pour une instance d'exécution dans le catalogue Integration Services.

Vous pouvez également utiliser la boîte de dialogue Exécuter le package dans Outils de données SQL Server (SSDT) pour modifiez la valeur de paramètre. Pour plus d'informations, consultez Boîte de dialogue d'exécution de package.

Vous pouvez également utiliser l'option /Parameter dtexec pour modifier une valeur de paramètre. Pour plus d'informations, consultez Utilitaire dtexec.

Validation des paramètres

Si les valeurs de paramètre ne peuvent pas être résolues, l'exécution du package correspondante échoue. Pour éviter les échecs, vous pouvez valider les projets et les packages à l'aide de la boîte de dialogue Valider dans Outils de données SQL Server (SSDT). La validation vous permet de vérifier que tous les paramètres disposent des valeurs nécessaires ou qu'ils peuvent résoudre les valeurs requises avec des références environnementales spécifiques. La validation vérifie également d'autres problèmes courants liés aux packages.

Pour plus d'informations, consultez Boîte de dialogue Valider.

Exemples de paramètre

Cet exemple illustre un paramètre nommé pkgOptions utilisé pour spécifier les options du package dans lequel il réside.

Au moment de la conception, lorsque le paramètre a été créé dans Outils de données SQL Server, la valeur par défaut 1 a été affectée au paramètre. Cette valeur par défaut est appelée « valeur de conception par défaut ». Si le projet a été déployé dans le catalogue SSISDB et qu'aucune autre valeur n'a été affectée à ce paramètre, la propriété de package correspondant au paramètre pkgOptions se verrait affecter la valeur 1 pendant l'exécution du package. La valeur de conception par défaut est conservée avec le projet pendant tout son cycle de vie.

Lors de la préparation une instance spécifique de l'exécution du package, la valeur 5 est affectée au paramètre pkgOptions. Cette valeur est appelée « valeur d'exécution » car elle s'applique au paramètre uniquement pour cette instance d'exécution particulière. Lorsque l'exécution démarre, la propriété de package correspondant au paramètre pkgOptions se voit affecter la valeur 5.

Tâches associées

Créer des paramètres

Définir des valeurs de paramètres après le déploiement du projet

Contenu connexe

Entrée de blog, Astuce rapide SSIS : Paramètres requis, sur le site mattmasson.com.