catalog.validate_project (base de données SSISDB)

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

Syntaxe

validate_project [ @folder_name = ] folder_name
    , [ @project_name = ] project_name
    , [ @validate_type = ] validate_type
    , [ @validation_id = ] validation_id OUTPUT
 [  , [ @use32bitruntime = ] use32bitruntime ]
 [  , [ @target_environment = ] target_environment ]
 [  , [ @reference_id = ] reference_id ]

Arguments

  • [ @folder\_name = ] folder_name
    Nom d'un dossier qui contient le projet. Le folder_name est nvarchar(128).

  • [ @project\_name = ] project_name
    Nom du projet. Le project_name est nvarchar(128).

  • [@ validate_type =] validate_type
    Indique le type de validation à réaliser. Utilisez le caractère F pour effectuer une validation complète. Le validate_type est char(1).

  • [@ 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. Le reference_id est bigint.

Valeurs de code de retour

0 (succès)

Jeux de résultats

La sortie des étapes de validation est retournée sous la forme de sections différentes du jeu de résultats.

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 fournit quelques conditions qui peuvent générer une erreur ou un avertissement :

  • La validation échoue pour un ou plusieurs packages dans le projet

  • La validation échoue si un ou plusieurs des environnements référencés inclus dans la validation ne contiennent pas de variables référencées

  • Le type validé spécifié n'est pas valide.

  • Le nom du projet ou l'ID de référence d'environnement n'est pas valide

  • L'utilisateur n'a pas les autorisations appropriées

Notes

La validation aide à identifier les problèmes qui empêchent les packages dans le projet de s'exécuter avec succès. Utilisez les vues catalog.validations ou catalog.operations pour surveiller l'état de validation.

Seuls les environnements qui sont accessibles par l'utilisateur peuvent être utilisés dans la validation. La sortie de validation est envoyée au client sous forme d'un jeu de résultats.

Dans cette version, la validation de projet ne prend pas en charge la validation de dépendance.

La validation complète confirme que toutes les variables d'environnement référencées sont recherchées dans les environnements référencés inclus dans la validation. Les résultats de la validation complète répertorient des références environnementales qui ne sont pas des variables d'environnement valides et référencées et qui sont introuvables dans les environnements référencés inclus dans la validation.