catalog.start_execution (base de datos de SSISDB)

  • Artículo

Inicia una instancia de ejecución en el catálogo de Integration Services.

Sintaxis

start_execution [ @execution_id = ] execution_id

Argumentos

  • [ @execution\_id = ] execution_id
    Identificador único de la instancia de ejecución. El parámetro execution_id es bigint.

Comentarios

Una ejecución se utiliza para especificar los valores de parámetro que va a usar un paquete durante una instancia única de ejecución del paquete. Puede ocurrir que, después de crear una instancia de ejecución y antes de que se inicie, el proyecto correspondiente se implemente de nuevo. En este caso, la instancia de ejecución hará referencia a un proyecto obsoleto. Esto impedirá que el procedimiento almacenado se ejecute correctamente.

[!NOTA]

Las ejecuciones solo pueden iniciarse una vez. Para iniciar una instancia de ejecución, debe tener el estado creado (el valor de 1 en la columna status de la vista catalog.operations).

Ejemplo

En el ejemplo siguiente se llama a catalog.create_execution para crear una instancia de ejecución para el paquete Child1.dtsx. Project1 de Integration Services contiene el paquete. En el ejemplo se llama a catalog.set_execution_parameter_value para establecer valores para los parámetros Parameter1, Parameter2 y LOGGING_LEVEL. En el ejemplo se llama a catalog.start_execution para iniciar una instancia de ejecución.

Declare @execution_id bigint
EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Child1.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'TestDeply4', @project_name=N'Integration Services Project1', @use32bitruntime=False, @reference_id=Null
Select @execution_id
DECLARE @var0 sql_variant = N'Child1.dtsx'
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=20, @parameter_name=N'Parameter1', @parameter_value=@var0
DECLARE @var1 sql_variant = N'Child2.dtsx'
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=20, @parameter_name=N'Parameter2', @parameter_value=@var1
DECLARE @var2 smallint = 1
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var2
EXEC [SSISDB].[catalog].[start_execution] @execution_id
GO

Valor del código de retorno

0 (correcto)

Conjuntos de resultados

None

Permisos

Este procedimiento almacenado necesita uno de los siguientes permisos:

  • Los permisos READ y MODIFY de la instancia de ejecución, los permisos READ y EXECUTE del proyecto y, si procede, los permisos READ del entorno al que se hace referencia

  • 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

  • La ejecución se ha iniciado previamente o se ha completado ya; las ejecuciones pueden iniciarse una sola vez

  • La referencia de entorno asociado al proyecto no es válida

  • No se han establecido los valores de parámetro necesarios

  • La versión del proyecto asociada a la instancia de ejecución está obsoleta; solo se puede ejecutar la versión más actual de un proyecto