catalog.validate_package (base de datos de SSISDB)

  • Artículo

Se aplica a:SQL Server SSIS Integration Runtime en Azure Data Factory

Se aplica a:SQL Server

Valida de forma asincrónica un paquete del catálogo de Integration Services.

Sintaxis

catalog.validate_package [ @folder_name = ] folder_name  
    , [ @project_name = ] project_name  
    , [ @package_name = ] package_name  
    , [ @validation_id = ] validation_id OUTPUT  
 [  , [ @use32bitruntime = ] use32bitruntime ]  
 [  , [ @environment_scope = ] environment_scope ]  
 [  , [ @reference_id = ] reference_id ]

Argumentos

[ @folder_name = ] folder_name
El nombre de la carpeta que contiene el paquete. folder_name es nvarchar(128) .

[ @project_name = ] project_name
El nombre del proyecto que contiene el paquete. project_name es nvarchar(128) .

[ @package_name = ] package_name
Nombre del paquete. El parámetro package_name es de tipo nvarchar(260).

[ @validation_id = ] validation_id
Devuelve el identificador único (ID) de la validación. El parámetro validation_id es 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 entorno 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 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 usa de forma predeterminada. El parámetro environment_scope es 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 S. reference_id es bigint.

Valores de código de retorno

0 (correcto)

Conjuntos de resultados

None

Permisos

Este procedimiento almacenado necesita uno de los permisos siguientes:

  • 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 de ssis_admin

  • Pertenencia al rol de servidor de sysadmin

Errores y advertencias

En la siguiente lista se describen algunas condiciones que pueden producir un error o una advertencia:

  • El nombre del proyecto o el nombre del paquete no son válidos

  • El usuario no tiene los permisos adecuados.

  • Uno o varios de los entornos a los que se hace referencia incluidos en la validación no contienen variables a las que se haga referencia

  • Se produce un error de validación del paquete

  • El entorno al que se hace referencia no existe

  • Las variables a las que se hace referencia no se pueden encontrar en los entornos a los que se hace referencia incluidos en la validación

  • Se hace referencia a las variables de los parámetros del paquete, pero no se han incluido entornos a los que se haga referencia en la validación

Observaciones

La validación ayuda a identificar problemas que pueden impedir que el paquete se ejecute correctamente. Use las vistas catalog.validations o catalog.operations para supervisar el estado de validación.