catalog.validate_project (base de données SSISDB)catalog.validate_project (SSISDB Database)

CETTE RUBRIQUE S’APPLIQUE À : ouiSQL Server (à partir de la version 2012)nonAzure SQL DatabasenonAzure SQL Data WarehousenonParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Valide de façon asynchrone un projet dans le catalogue Integration ServicesIntegration Services.Asynchronously validates a project in the Integration ServicesIntegration Services catalog.

SyntaxeSyntax

catalog.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 ]  

ArgumentsArguments

[ @folder_name =] nom_dossier[ @folder_name = ] folder_name
Nom d'un dossier qui contient le projet.The name of a folder that contains the project. Le nom_dossier est nvarchar (128).The folder_name is nvarchar(128).

[ @project_name =] project_name[ @project_name = ] project_name
Nom du projet.The name of the project. Le project_name est nvarchar (128).The project_name is nvarchar(128).

[ @validate_type =] validate_type[ @validate_type = ] validate_type
Indique le type de validation à réaliser.Indicates the type of validation to perform. Utilisez le caractère F pour effectuer une validation complète.Use the character F to perform a full validation. Le validate_type est char (1).The validate_type is char(1).

[ @validation_id =] validation_id[ @validation_id = ] validation_id
Retourne l'identificateur unique (ID) de la validation.Returns the unique identifier (ID) of the validation. Le validation_id est bigint.The validation_id is bigint.

[ @use32bitruntime =] use32bitruntime[ @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.Indicates if the 32-bit runtime should be used to run the package on a 64-bit operating system. Utilisez la valeur de 1 pour exécuter le package avec le runtime 32 bits lors de l’exécution sur un système d’exploitation de 64 bits.Use the value of 1 to execute the package with the 32-bit runtime when running on a 64-bit operating system. 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é.Use the value of 0 to execute the package with the 64-bit runtime when running on a 64-bit operating system. Ce paramètre est facultatif.This parameter is optional. Le use32bitruntime est bits.The use32bitruntime is bit.

[ @environment_scope =] environment_scope[ @environment_scope = ] environment_scope
Indique les références environnementales considérées par la validation.Indicates the environment references that are considered by the validation. Lorsque la valeur est A, toutes les références environnementales associées au projet sont incluses dans la validation.When the value is A, all environment references associated with the project are included in the validation. Lorsque la valeur est S, seule une référence environnementale unique est incluse.When the value is S, only a single environment reference is included. 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.When the value is D, no environment references are included and each parameter must have a literal default value in order to pass validation. Ce paramètre est facultatif, le caractère D sera utilisé par défaut.This parameter is optional, the character D will be used by default. Le environment_scope est char (1).The environment_scope is Char(1).

[ @reference_id =] reference_id[ @reference_id = ] reference_id
ID unique de la référence environnementale.The unique ID of the environment reference. Ce paramètre est obligatoire uniquement quand une référence environnementale unique est incluse dans la validation, lors de la environment_scope est S.This parameter is required only when a single environment reference is included in the validation, when environment_scope is S. Le reference_id est bigint.The reference_id is bigint.

Valeurs des codes de retourReturn Code Values

0 (succès)0 (success)

Jeux de résultatsResult Sets

La sortie des étapes de validation est retournée sous la forme de sections différentes du jeu de résultats.Output from the validation steps is returned as different sections of the result set.

PermissionsPermissions

Cette procédure stockée requiert l'une des autorisations suivantes :This stored procedure requires one of the following permissions:

  • Autorisations de lecture sur le projet et, le cas échéant, les autorisations de lecture sur les environnements référencésREAD permissions on the project and, if applicable, READ permissions on the referenced environments

  • L’appartenance à la ssis_admin rôle de base de donnéesMembership to the ssis_admin database role

  • L’appartenance à la sysadmin rôle de serveurMembership to the sysadmin server role

Erreurs et avertissementsErrors and Warnings

La liste suivante fournit quelques conditions qui peuvent générer une erreur ou un avertissement :The following list provides some conditions that may raise an error or warning:

  • La validation échoue pour un ou plusieurs packages dans le projetValidation fails for one or more packages in the project

  • 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éesValidation fails if one or more of the referenced environments included in the validation do not contain referenced variables

  • Le type validé spécifié n'est pas valide.The specified validate type is not valid

  • Le nom du projet ou l'ID de référence d'environnement n'est pas valideThe project name or environment reference ID is not valid

  • L’utilisateur ne dispose pas des autorisations appropriéesThe user does not have the appropriate permissions

NotesRemarks

La validation aide à identifier les problèmes qui empêchent les packages dans le projet de s'exécuter avec succès.Validation helps identify issues that will prevent the packages in the project from running successfully. Utilisez le catalog.validations ou catalog.operations vues pour surveiller l’état de validation.Use the catalog.validations or catalog.operations views to monitor for validation status.

Seuls les environnements qui sont accessibles par l'utilisateur peuvent être utilisés dans la validation.Only environments that are accessible by the user can be used in the validation. La sortie de validation est envoyée au client sous forme d'un jeu de résultats.Validation output is sent to the client as a result set.

Dans cette version, la validation de projet ne prend pas en charge la validation de dépendance.In this release, project validation does not support dependency validation.

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.Full validation confirms that all referenced environment variables are found within the referenced environments that were included in the 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.Full validation results list environment references that are not valid and referenced environment variables that could not be found in any of the referenced environments that were included in the validation.