catalog.validate_package (base de données SSISDB)

Article
05/23/2023

S’applique à :SQL Server SSIS Integration Runtime dans Azure Data Factory

S’applique à :SQL Server

Valide de façon asynchrone un package dans le catalogue Integration Services.

Syntaxe

catalog.validate_package [ @folder_name = ] folder_name  
    , [ @project_name = ] project_name  
    , [ @package_name = ] package_name  
    , [ @validation_id = ] validation_id OUTPUT  
 [  , [ @use32bitruntime = ] use32bitruntime ]  
 [  , [ @environment_scope = ] environment_scope ]  
 [  , [ @reference_id = ] reference_id ]

Arguments

[ @folder_name = ] folder_name
Nom du dossier qui contient le package. folder_name est de type nvarchar(128) .

[ @project_name = ] project_name
Nom du projet qui contient le package. project_name est de type nvarchar(128) .

[ @package_name = ] package_name
Nom du package. package_name est de type nvarchar(260).

[ @validation_id = ] validation_id
Retourne l'identificateur unique (ID) de la validation. validation_id est de type bigint.

[ @use32bitruntime = ] use32bitruntime
Indique si l'exécution 32 bits doit être utilisée pour exécuter le package sur un système d'exploitation 64 bits. Utilisez la valeur 1 pour exécuter le package avec l’exécution 32 bits quand un système d’exploitation 64 bits est exécuté. Utilisez la valeur 0 pour exécuter le package avec l'exécution 64 bits lorsqu'un système d'exploitation 64 bits est exécuté. Ce paramètre est facultatif. use32bitruntime est de type bit.

[ @environment_scope = ] environment_scope
Indique les références environnementales considérées par la validation. Lorsque la valeur est A, toutes les références environnementales associées au projet sont incluses dans la validation. Lorsque la valeur est S, seule une référence environnementale unique est incluse. Lorsque la valeur est D, aucune référence environnementale n'est incluse et chaque paramètre doit avoir une valeur par défaut littérale pour passer la validation. Ce paramètre est facultatif. Le caractère D est utilisé par défaut. environment_scope est de type char(1).

[ @reference_id = ] reference_id
ID unique de la référence environnementale. Ce paramètre est obligatoire uniquement quand une référence environnementale unique est incluse dans la validation, quand environment_scope est S. reference_id est de type bigint.

Codet de retour

0 (succès)

Jeux de résultats

None

Autorisations

Cette procédure stockée requiert l'une des autorisations suivantes :

Autorisations READ sur le projet et, si applicable, autorisations READ sur les environnements référencés
Appartenance au rôle de base de données ssis_admin
Appartenance au rôle serveur sysadmin

Erreurs et avertissements

La liste suivante décrit quelques conditions qui peuvent générer une erreur ou un avertissement :

Le nom du projet ou le nom de package n'est pas valide
L’utilisateur n’a pas les autorisations appropriées
Un ou plusieurs environnements référencés inclus dans la validation ne contiennent pas de variables référencées
La validation du package échoue
L'environnement référencé n'existe pas
Les variables référencées ne peuvent pas être trouvées dans les environnements référencés inclus dans la validation
Les variables sont référencées dans les paramètres du package, mais aucun environnement référencé n'a été inclus dans la validation

Notes

La validation aide à identifier les problèmes qui peuvent empêcher le package de s’exécuter avec succès. Utilisez les vues catalog.validations ou catalog.operations pour surveiller l’état de validation.

Partage via