catalog.create_execution (base de datos de SSISDB)catalog.create_execution (SSISDB Database)

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) sí SSIS Integration Runtime en Azure Data FactorySSIS Integration Runtime in Azure Data Factoryyes SSIS Integration Runtime en Azure Data FactorySSIS Integration Runtime in Azure Data FactorySe aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) sí SSIS Integration Runtime en Azure Data FactorySSIS Integration Runtime in Azure Data Factoryyes SSIS Integration Runtime en Azure Data FactorySSIS Integration Runtime in Azure Data Factory

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions)

Crea una instancia de ejecución en el catálogo de Integration ServicesIntegration Services.Creates an instance of execution in the Integration ServicesIntegration Services catalog.

Este procedimiento almacenado usa el nivel de registro de servidor predeterminado.This stored procedure uses the default server logging level.

SintaxisSyntax

catalog.create_execution [ @folder_name = ] folder_name  
     , [ @project_name = ] project_name  
     , [ @package_name = ] package_name  
  [  , [ @reference_id = ] reference_id ]  
  [  , [ @use32bitruntime = ] use32bitruntime ] 
  [  , [ @runinscaleout = ] runinscaleout ]
  [  , [ @useanyworker = ] useanyworker ] 
     , [ @execution_id = ] execution_id OUTPUT  

ArgumentosArguments

[@folder_name =] folder_name[@folder_name =] folder_name
El nombre de la carpeta que contiene el paquete que se va a ejecutar.The name of the folder that contains the package that is to be executed. folder_name es nvarchar(128) .The folder_name is nvarchar(128).

[@project_name =] project_name[@project_name =] project_name
Nombre del proyecto que contiene el paquete que se va a ejecutar.The name of the project that contains the package that is to be executed. project_name es nvarchar(128) .The project_name is nvarchar(128).

[@package_name =] package_name[@package_name =] package_name
El nombre del paquete que se va a ejecutar.The name of the package that is to be executed. El parámetro package_name es de tipo nvarchar(260).The package_name is nvarchar(260).

[@reference_id =] reference_id[@reference_id =] reference_id
Un identificador único para una referencia de entorno.A unique identifier for an environment reference. Este parámetro es opcional.This parameter is optional. reference_id es bigint.The reference_id is bigint.

[@use32bitruntime =] use32bitruntime[@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.Indicates if the 32-bit runtime should be used to run the package on a 64-bit operating system. Use el valor 1 para ejecutar el paquete con el motor de tiempo de ejecución de 32 bits cuando se ejecute en un sistema operativo de 64 bits.Use the value of 1 to execute the package with the 32-bit runtime when running on a 64-bit operating system. Use el valor 0 para ejecutar el paquete con el motor de tiempo de ejecución de 64 bits cuando se ejecute en un sistema operativo de 64 bits.Use the value of 0 to execute the package with the 64-bit runtime when running on a 64-bit operating system. Este parámetro es opcional.This parameter is optional. El parámetro Use32bitruntime es de tipo bit.The Use32bitruntime is bit.

[@runinscaleout =] runinscaleout[@runinscaleout =] runinscaleout
Indique si la ejecución está en Escalabilidad horizontal. Use el valor 1 para ejecutar el paquete en la escalabilidad horizontal. Use el valor 0 para ejecutar el paquete sin escalabilidad horizontal. Este parámetro es opcional.Indicate whether the execution is in Scale Out. Use the value of 1 to execute the package in Scale Out. Use the value of 0 to execute the package without Scale Out. This parameter is optional. Si no se especifica, su valor se establece en DEFAULT_EXECUTION_MODE en [SSISDB].[catalog].[catalog_properties].If not specified, its value is set to DEFAULT_EXECUTION_MODE in [SSISDB].[catalog].[catalog_properties]. El parámetro runinscaleout es de tipo bit.The runinscaleout is bit.

[@useanyworker =] useanyworker[@useanyworker =] useanyworker
Indique si se permite al trabajo de escalabilidad horizontal para realizar la ejecución.Indicate whether any Scale Out Worker is allowed to do the execution.

  • Use el valor 1 para ejecutar el paquete con cualquier trabajo de escalabilidad horizontal.Use the value of 1 to execute the package with any Scale Out Worker. Al establecer @useanyworker en true, cualquier trabajo cuyo número máximo de tareas (tal y como se especifica en el archivo de configuración del trabajo) aún no se haya alcanzado, estará disponible para ejecutar el paquete.When you set @useanyworker to true, any worker whose maximum task count (as specified in the worker configuration file) is not yet reached is available to run the package. Para obtener información sobre el archivo de configuración de trabajo, consulte Trabajador de escalado horizontal de Integration Services (SSIS).For info about the worker configuration file, see Integration Services (SSIS) Scale Out Worker.

  • Use el valor 0 para indicar que no todos los trabajos de escalabilidad horizontal tienen permiso para ejecutar el paquete.Use the value of 0 to indicate that not all Scale Out Workers are allowed to execute the package. Al establecer @useanyworker en false, tendrá que especificar los trabajos que están autorizados a ejecutar el paquete mediante el Administrador de escalabilidad horizontal o mediante una llamada al procedimiento almacenado [catalog].[add_execution_worker].When you set @useanyworker to false, you have to specify the workers that are allowed to run the package by using Scale Out Manager or by calling the stored procedure [catalog].[add_execution_worker]. Si especifica un trabajo que ya está ejecutando otro paquete, el trabajo finaliza la ejecución del paquete actual antes de solicitar otra ejecución.If you specify a worker that's already running another package, the worker finishes running the current package before it requests another execution.

Este parámetro es opcional.This parameter is optional. Si no se especifica, su valor se establece en 1.If not specified, its value is set to 1. El parámetro useanyworker es de tipo bit.The useanyworker is bit.

[@execution_id =] execution_id[@execution_id =] execution_id
Devuelve el identificador único de una instancia de ejecución.Returns the unique identifier for an instance of execution. El parámetro execution_id es de tipo bigint.The execution_id is bigint.

ComentariosRemarks

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.An execution is used to specify the parameter values that are a package uses during a single instance of package execution.

Si una referencia de entorno se especifica con el parámetro reference_id, el procedimiento almacenado rellena los parámetros de paquete y proyecto con los valores literales o los valores a los que se hace referencia de las variables de entorno correspondientes.If an environment reference is specified with the reference_id parameter, the stored procedure populates the project and package parameters with literal values or referenced values from the corresponding environment variables. Si se especifica la referencia de entorno, los valores de parámetro predeterminados se utilizan durante la ejecución del paquete.If environment reference is specified, default parameter values are used during package execution. Para determinar exactamente qué valores se usan para una instancia determinada de ejecución, utilice el valor del parámetro de salida execution_id de este de procedimiento almacenado y consulte la vista execution_parameter_values.To determine exactly which values are used for a particular instance of execution, use the execution_id output parameter value from this stored procedure and query the execution_parameter_values view.

Solo los paquetes que se marcan como paquetes de punto de entrada se pueden especificar en una ejecución.Only packages that are marked as entry point packages can be specified in an execution. Si se especifica un paquete que no es un punto de entrada, la ejecución produce un error.If a package that is not an entry point is specified, the execution fails.

EjemploExample

En el ejemplo siguiente se llama a catalog.create_execution para crear una instancia de ejecución para el paquete Child1.dtsx, que no se encuentra en escalabilidad horizontal. Project1 de Integration Services contiene el paquete.The following example calls catalog.create_execution to create an instance of execution for the Child1.dtsx package, which is not in Scale Out. Integration Services Project1 contains the package. En el ejemplo se llama a catalog.set_execution_parameter_value para establecer valores para los parámetros Parameter1, Parameter2 y LOGGING_LEVEL.The example calls catalog.set_execution_parameter_value to set values for the Parameter1, Parameter2, and LOGGING_LEVEL parameters. En el ejemplo se llama a catalog.start_execution para iniciar una instancia de ejecución.The example calls catalog.start_execution to start an instance of execution.

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 de código de retornoReturn Code Value

0 (correcto)0 (success)

Conjuntos de resultadosResult Sets

NoneNone

PermisosPermissions

Este procedimiento almacenado necesita uno de los permisos siguientes:This stored procedure requires one of the following permissions:

  • Permisos de lectura y ejecución en el proyecto y, si es aplicable, permisos de lectura en el entorno al que se hace referenciaREAD and EXECUTE permissions on the project and, if applicable, READ permissions on the referenced environment

  • Pertenencia al rol de base de datos de ssis_adminMembership to the ssis_admin database role

  • Pertenencia al rol de servidor de sysadminMembership to the sysadmin server role

Si @runinscaleout es 1, el procedimiento almacenado necesita uno de los permisos siguientes:If @runinscaleout is 1, the stored procedure requires one of the following permissions:

  • Pertenencia al rol de base de datos de ssis_adminMembership to the ssis_admin database role

  • Pertenencia al rol de base de datos ssis_cluster_executorMembership to the ssis_cluster_executor database role

  • Pertenencia al rol de servidor de sysadminMembership to the sysadmin server role

Errores y advertenciasErrors and Warnings

La siguiente lista describe algunas condiciones que pueden producir un error o una advertencia:The following list describes some conditions that can raise an error or warning:

  • El paquete no existe.The package does not exist.

  • El usuario no tiene los permisos adecuados.The user does not have the appropriate permissions.

  • La referencia de entorno, reference_id, no es válida.The environment reference, reference_id, is not valid.

  • El paquete que se especifica no es un paquete de punto de entrada.The package that is specified is not an entry point package.

  • El tipo de datos de la variable de entorno a la que se hace referencia es diferente del tipo de datos del parámetro de paquete o proyecto.The data type of the referenced environment variable is different from the data type of the project or package parameter.

  • El proyecto o el paquete contienen parámetros que requieren valores, pero no se ha asignado ningún valor.The project or package contains parameters that require values, but no values have been assigned.

  • Las variables de entorno a las que se hace referencia no se encuentran en el entorno especificado por la referencia de entorno, reference_id.The referenced environment variables cannot be found in the environment that the environment reference, reference_id, specifies.

Consulte tambiénSee Also

catalog.start_execution (base de datos de SSISDB) catalog.start_execution (SSISDB Database)
catalog.set_execution_parameter_value (SSISDB Database) (catalog.set_execution_parameter_value [base de datos de SSISDB];)catalog.set_execution_parameter_value (SSISDB Database)
catalog.add_execution_worker (base de datos de SSISDB)catalog.add_execution_worker (SSISDB Database)