catalog.set_execution_parameter_value (base de datos de SSISDB)
Se aplica a:
SQL Server SSIS Integration Runtime en Azure Data Factory
Se aplica a:SQL Server
Establece el valor de un parámetro para una instancia de ejecución en el catálogo Integration Services .
No se puede cambiar un valor de parámetro después de que se haya iniciado una instancia de ejecución.
Sintaxis
catalog.set_execution_parameter_value [ @execution_id = execution_id
, [ @object_type = ] object_type
, [ @parameter_name = ] parameter_name
, [ @parameter_value = ] parameter_value
Argumentos
[ @execution_id = ] execution_id
Identificador único de la instancia de ejecución. El parámetro execution_id es de tipo bigint.
[ @object_type = ] object_type
Tipo de parámetro.
Para los parámetros siguientes, establezca object_type en 50.
LOGGING_LEVEL
CUSTOMIZED_LOGGING_LEVEL
DUMP_ON_ERROR
DUMP_ON_EVENT
DUMP_EVENT_CODE
CALLER_INFO
SYNCHRONIZED
Use el valor 20 para indicar un parámetro de proyecto o el valor 30 para indicar un parámetro de paquete.
El parámetro object_type es de tipo smallInt.
[ @parameter_name = ] parameter_name
El nombre del parámetro. El parámetro parameter_name es de tipo nvarchar(128).
[ @parameter_value = ] parameter_value
Valor del parámetro. El parámetro parameter_value es de tipo sql_variant.
Observaciones
Para determinar los valores de parámetros usados para una ejecución determinada, consulte la vista catalog.execution_parameter_values.
Para especificar el ámbito de la información que se registra durante una ejecución de paquetes, establezca parameter_name en LOGGING_LEVEL y parameter_value en uno de los valores siguientes.
Establezca el parámetro object_type en 50.
| Value | Descripción |
|---|---|
| 0 | None El registro está desactivado. Solo se registra el estado de ejecución del paquete. |
| 1 | Básico Se registran todos los eventos, excepto los eventos personalizados y de diagnóstico. Este es el valor predeterminado. |
| 2 | Rendimiento Solo se registran las estadísticas de rendimiento, y los eventos OnError y OnWarning. |
| 3 | Verbose Se registran todos los eventos, incluidos los eventos personalizados y de diagnóstico. Los eventos personalizados incluyen los eventos registrados por las tareas de Integration Services. Para más información, vea Mensajes personalizados para registro. |
| 4 | Linaje en tiempo de ejecución Recopila los datos necesarios para realizar un seguimiento del linaje en el flujo de datos. |
| 100 | Nivel de registro personalizado Especifique la configuración en el parámetro CUSTOMIZED_LOGGING_LEVEL. Para obtener más información acerca de los valores que se pueden especificar, vea catalog.create_customized_logging_level. Para obtener más información acerca de los niveles de registro personalizados, vea Habilitar el registro para la ejecución de paquetes en el servidor SSIS. |
Para especificar que el servidor de Integration Services genere archivos de volcado cuando se produzca algún error durante la ejecución del paquete, establezca los siguientes valores de parámetro para una instancia de ejecución que no se haya ejecutado.
| Parámetro | Value |
|---|---|
| execution_id | Identificador único de la instancia de ejecución. |
| object_type | 50 |
| parameter_name | 'DUMP_ON_ERROR |
| parameter_value | 1 |
Para especificar que el servidor de Integration Services genere archivos de volcado cuando se produzcan eventos durante la ejecución del paquete, establezca los siguientes valores de parámetro para una instancia de ejecución que no se haya ejecutado.
| Parámetro | Value |
|---|---|
| execution_id | Identificador único de la instancia de ejecución. |
| object_type | 50 |
| parameter_name | 'DUMP_ON_EVENT |
| parameter_value | 1 |
Para especificar los eventos durante la ejecución del paquete que causan que el servidor de Integration Services genere archivos de volcado, establezca los siguientes valores de parámetro para una instancia de ejecución que no se haya ejecutado. Separe los diversos códigos de evento mediante un punto y coma.
| Parámetro | Value |
|---|---|
| execution_id | Identificador único de la instancia de ejecución. |
| object_type | 50 |
| parameter_name | DUMP_EVENT_CODE |
| parameter_value | Uno o varios códigos de evento. |
Ejemplos
A. Generar archivos de volcado en el caso de errores
En el ejemplo siguiente se especifica que el servidor de Integration Services genera archivos de volcado cuando se produce un error durante la ejecución del paquete.
exec catalog.create_execution 'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out
exec catalog.set_execution_parameter_value @execution_id, 50, 'DUMP_ON_ERROR',1
B. Generar archivos de volcado en el caso de eventos
En el ejemplo siguiente se especifica que el servidor de Integration Services genera archivos de volcado cuando se producen eventos durante la ejecución del paquete, y se especifica el evento que hace que el servidor genere los archivos.
exec catalog.create_execution 'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out
exec catalog.set_execution_parameter_value @execution_id, 50, 'DUMP_ON_EVENT',1
declare @event_code nvarchar(50)
set @event_code = '0xC020801C'
exec catalog.set_execution_parameter_value @execution_id, 50, 'DUMP_EVENT_CODE', @event_code
Valor de código de retorno
0 (correcto)
Conjuntos de resultados
None
Permisos
Este procedimiento almacenado necesita uno de los permisos siguientes:
Permisos READ y MODIFY en la instancia de ejecución
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 usuario no tiene los permisos adecuados.
El identificador de ejecución no es válido
El nombre de parámetro no es válido
El tipo de datos del valor de parámetro no coincide con el tipo de datos del parámetro.
Consulte también
catalog.execution_parameter_values (base de datos de SSISDB)
Generar archivos de volcado para la ejecución de paquetes