catalog.validate_package (base de données SSISDB)catalog.validate_package (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 package dans le catalogue Integration ServicesIntegration Services.Asynchronously validates a package in the Integration ServicesIntegration Services catalog.

SyntaxeSyntax

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

ArgumentsArguments

[ @folder_name = ] folder_name[ @folder_name = ] folder_name
Nom du dossier qui contient le package.The name of the folder that contains the package. folder_name est de type nvarchar(128).The folder_name is nvarchar(128).

[ @project_name = ] project_name[ @project_name = ] project_name
Nom du projet qui contient le package.The name of the project that contains the package. project_name est de type nvarchar(128).The project_name is nvarchar(128).

[ @package_name = ] package_name[ @package_name = ] package_name
Nom du package.The name of the package. package_name est de type nvarchar(260).The package_name is nvarchar(260).

[ @validation_id = ] validation_id[ @validation_id = ] validation_id
Retourne l'identificateur unique (ID) de la validation.Returns the unique identifier (ID) of the validation. validation_id est de type 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 1 pour exécuter le package avec l’exécution 32 bits quand un système d’exploitation 64 bits est exécuté.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. use32bitruntime est de type bit.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.This parameter is optional. Le caractère D est utilisé par défaut.The character D is used by default. environment_scope est de type 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, quand environment_scope est S.This parameter is required only when a single environment reference is included in the validation, when environment_scope is S. reference_id est de type bigint.The reference_id is bigint.

Valeurs des codes de retourReturn Code Values

0 (succès)0 (success)

Jeux de résultatsResult Sets

AucuneNone

PermissionsPermissions

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

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

  • Appartenance au rôle de base de données ssis_adminMembership to the ssis_admin database role

  • Appartenance au rôle serveur sysadminMembership to the sysadmin server role

Erreurs et avertissementsErrors and Warnings

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

  • Le nom du projet ou le nom de package n'est pas valideThe project name or package name is not valid

  • L’utilisateur n’a pas les autorisations appropriéesThe user does not have the appropriate permissions

  • Un ou plusieurs environnements référencés inclus dans la validation ne contiennent pas de variables référencéesOne or more of the referenced environments included in the validation do not contain referenced variables

  • La validation du package échoueThe validation of the package fails

  • L'environnement référencé n'existe pasThe environment that is referenced does not exist

  • Les variables référencées ne peuvent pas être trouvées dans les environnements référencés inclus dans la validationReferenced variables cannot be found in the referenced environments included in the 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 validationVariables are referenced in the package parameters, but no referenced environments have been included in the validation

NotesRemarks

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