Compartir a través de


catalog.set_execution_parameter_value (base de datos de SSISDB)

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

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 bigint.

  • [ @object\_type = ] object_type
    Tipo de parámetro.

    Para los parámetros siguientes, establezca object_type en 50.

    • 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.

Comentarios

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.

Valor

Descripción

0

None

El registro está desactivado. Solo se registra el estado de ejecución del paquete.

1

Basic

Se registran todos los eventos, excepto los eventos personalizados y de diagnóstico. Es el valor predeterminado.

2

Performance

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 obtener más información, vea Mensajes personalizados para registro.

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 valores de los parámetros siguientes para una instancia de ejecución que no se haya ejecutado.

Parámetro

Valor

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 valores de los parámetros siguientes para una instancia de ejecución que no se haya ejecutado.

Parámetro

Valor

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 hacen que el servidor de Integration Services genere archivos de volcado, establezca los valores de los parámetros siguientes 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

Valor

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.

Ejemplo

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

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 del código de retorno

0 (correcto)

Conjuntos de resultados

None

Permisos

Este procedimiento almacenado requiere uno de los siguientes permisos:

  • Permisos READ y MODIFY en la instancia de ejecución

  • Pertenencia al rol de base de datos ssis_admin

  • Pertenencia al rol de servidor sysadmin

Errores y advertencias

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

  • El usuario no tiene los permisos apropiados

  • 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.

Vea también

Referencia

catalog.execution_parameter_values (base de datos de SSISDB)

Conceptos

Generar archivos de volcado para la ejecución de paquetes