catalog.validate_package (base de données SSISDB)

  • Article

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

Syntaxe

validate_package [ @folder_name = ] folder_name
    , [ @project_name = ] project_name
    , [ @package_name = ] package_name
    , [ @validation_id = ] validation_id OUTPUT
 [  , [ @use32bitruntime = ] use32bitruntime ]
 [  , [ @target_environment = ] target_environment ]
 [  , [ @reference_id = ] reference_id ]

Arguments

  • [ @folder\_name = ] folder_name
    Nom du dossier qui contient le package. folder_name est nvarchar(128).

  • [ @project\_name = ] project_name
    Nom du projet qui contient le package. project_name est nvarchar(128).

  • [ @package\_name = ] package_name
    Nom du package. Le paramètre package_name est de type nvarchar(260).

  • [@ validation_id =] validation_id
    Retourne l'identificateur unique (ID) de la validation. Le validation_id est 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 lorsqu'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. Le use32bitruntime est 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 sera utilisé par défaut. Le environment_scope est Char(1).

  • [ @reference\_id = ] reference_id
    ID unique de la référence environnementale. Ce paramètre est obligatoire uniquement lorsqu'une référence environnementale unique est incluse dans la validation, lorsque environment_scope est S. reference_id est bigint.

Valeurs de code de retour

0 (succès)

Jeux de résultats

Aucun

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 de 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 empêchent le package de s'exécuter avec succès. Utilisez les vues catalog.validations ou catalog.operations pour surveiller l'état de validation.