catalog.validate_project (base de datos de SSISDB)
Valida de forma asincrónica un proyecto del catálogo de Integration Services.
Sintaxis
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 ]
Argumentos
[ @folder\_name = ] folder_name
Nombre de una carpeta que contiene el proyecto. El parámetro folder_name es de tipo nvarchar(128).[ @project\_name = ] project_name
Nombre del proyecto. El parámetro project_name es de tipo nvarchar(128).[ @validate\_type = ] validate_type
Indica el tipo de validación que se llevará a cabo. Utilice el carácter F para realizar una validación completa. El parámetro validate_type es de tipo char(1).[ @validation\_id = ] validation_id
Devuelve el identificador único (ID) de la validación. El parámetro validation_id es de tipo bigint.[ @use32bitruntime = ] use32bitruntime
Indica si el motor en tiempo de ejecución de 32 bits se debe usar para ejecutar el paquete en un sistema operativo de 64 bits. Use el valor de 1 para ejecutar el paquete con el motor en tiempo de ejecución de 32 bits cuando se ejecute en un sistema operativo de 64 bits. Use el valor 0 para ejecutar el paquete con el motor en tiempo de ejecución de 64 bits cuando se ejecute en un sistema operativo de 64 bits. Este parámetro es opcional. El parámetro use32bitruntime es de tipo bit.[ @environment\_scope = ] environment_scope
Indica las referencias de entorno que la validación tiene en cuenta. Cuando el valor es A, todas las referencias de entorno asociadas con el proyecto se incluyen en la validación. Cuando el valor es S, solo se incluye una sola referencia de entorno. Cuando el valor es D, no se incluyen referencias de entorno y todos los parámetros deben tener un valor literal predeterminado para pasar la validación. Este parámetro es opcional, el carácter D se usará de forma predeterminada. El parámetro environment_scope es de tipo Char(1).[ @reference\_id = ] reference_id
El identificador único de la referencia de entorno. Este parámetro es obligatorio solo cuando se incluye una sola referencia de entorno en la validación, cuando el parámetro environment_scope es de tipo S. El parámetro reference_id es de tipo bigint.
Valores del código de retorno
0 (correcto)
Conjuntos de resultados
La salida de los pasos de la validación se devuelve como secciones diferentes del conjunto de resultados.
Permisos
Este procedimiento almacenado requiere uno de los siguientes permisos:
Permisos de lectura en el objeto y, si es aplicable, permisos de lectura en los entornos a los que se hace referencia
Pertenencia al rol de base de datos ssis_admin
Pertenencia al rol de servidor sysadmin
Errores y advertencias
En la siguiente lista se proporcionan algunas condiciones que pueden producir un error o una advertencia:
La validación no puede realizarse para uno o más paquetes del proyecto
La validación no puede realizarse si uno o varios de los entornos a los que se hace referencia y que están incluidos en la validación no contienen variables a las que se haga referencia
El tipo de validación especificado no es válido
El nombre del proyecto o el identificador de la referencia del entorno es no válido
El usuario no tiene los permisos apropiados
Comentarios
La validación ayuda a identificar problemas que impedirán que los paquetes del proyecto se ejecuten correctamente. Use las vistas catalog.validations o catalog.operations para supervisar el estado de validación.
Solo los entornos que son accesibles por el usuario se pueden utilizar en la validación. El resultado de la validación se envía al cliente como un conjunto de resultados.
En esta versión, la validación del proyecto no admite la validación de dependencias.
La validación completa confirma que todas las variables de entorno a las que se hace referencia se encuentran dentro de los entornos a los que se hace referencia y que se incluyeron en la validación. Los resultados de la validación completa enumeran las referencias de entorno que no son válidas y las variables de entorno a las que se hace referencia que podrían no encontrarse en ninguno de los entornos a los que se hace referencia y que se incluyeron en la validación.