catalog.create_execution(SSISDB 데이터베이스)catalog.create_execution (SSISDB Database)

이 항목은 다음에 적용됩니다.예SQL Server(2012부터)아니요Azure SQL Database아니요Azure SQL Data Warehouse 아니요병렬 데이터 웨어하우스 THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Integration ServicesIntegration Services 카탈로그에 실행 인스턴스를 만듭니다.Creates an instance of execution in the Integration ServicesIntegration Services catalog.

이 저장 프로시저는 기본 서버 로깅 수준을 사용합니다.This stored procedure uses the default server logging level.

구문Syntax

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  

인수Arguments

[@folder_name =] folder_name[@folder_name =] folder_name
실행할 패키지가 있는 폴더의 이름입니다.The name of the folder that contains the package that is to be executed. folder_namenvarchar(128)입니다.The folder_name is nvarchar(128).

[@project_name =] project_name[@project_name =] project_name
실행할 패키지가 포함된 프로젝트의 이름입니다.The name of the project that contains the package that is to be executed. project_namenvarchar(128)입니다.The project_name is nvarchar(128).

[@package_name =] package_name[@package_name =] package_name
실행할 패키지의 이름입니다.The name of the package that is to be executed. package_namenvarchar(260)입니다.The package_name is nvarchar(260).

[@reference_id =] reference_id[@reference_id =] reference_id
환경 참조의 고유 식별자입니다.A unique identifier for an environment reference. 이 매개 변수는 선택 사항입니다.This parameter is optional. reference_idbigint입니다.The reference_id is bigint.

[@use32bitruntime =] use32bitruntime[@use32bitruntime =] use32bitruntime
64비트 운영 체제에서 32비트 런타임을 사용하여 패키지를 실행해야 하는지 여부를 나타냅니다.Indicates if the 32-bit runtime should be used to run the package on a 64-bit operating system. 64비트 운영 체제에서 실행할 때 1 값을 사용하여 32비트 런타임으로 패키지를 실행합니다.Use the value of 1 to execute the package with the 32-bit runtime when running on a 64-bit operating system. 64비트 운영 체제에서 실행할 때 64비트 런타임으로 패키지를 실행하려면 값 0을 사용합니다.Use the value of 0 to execute the package with the 64-bit runtime when running on a 64-bit operating system. 이 매개 변수는 선택 사항입니다.This parameter is optional. Use32bitruntimebit입니다.The Use32bitruntime is bit.

[@runinscaleout =] runinscaleout[@runinscaleout =] runinscaleout
실행이 Scale Out에 있는지 여부를 나타냅니다. Scale Out에서 패키지를 실행하려면 1 값을 사용합니다. Scale Out을 사용하지 않고 패키지를 실행하려면 0 값을 사용합니다. 이 매개 변수는 선택 사항입니다.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. 지정하지 않으면 해당 값이 [SSISDB].[catalog].[catalog_properties]에서 DEFAULT_EXECUTION_MODE로 설정됩니다.If not specified, its value is set to DEFAULT_EXECUTION_MODE in [SSISDB].[catalog].[catalog_properties]. runinscaleoutbit입니다.The runinscaleout is bit.

[@useanyworker =] useanyworker[@useanyworker =] useanyworker
Scale Out 작업자에서 실행을 수행할 수 있는지 여부를 나타냅니다.Indicate whether any Scale Out Worker is allowed to do the execution.

  • Scale Out 작업자를 사용하여 패키지를 실행하려면 1 값을 사용합니다.Use the value of 1 to execute the package with any Scale Out Worker. @useanyworker를 true로 설정하면 최대 작업 수 (작업자 구성 파일에 지정된 대로)에 아직 도달하지 않은 작업자가 패키지를 실행할 수 있습니다.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.

  • 일부 Scale Out 작업자에서 패키지를 실행할 수 있음을 나타내려면 0 값을 사용합니다.Use the value of 0 to indicate that not all Scale Out Workers are allowed to execute the package. @useanyworker를 false로 설정하면 Scale Out 관리자를 사용하거나 저장 프로시저 [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].

이 매개 변수는 선택 사항입니다.This parameter is optional. 지정하지 않으면 해당 값이 1로 설정됩니다.If not specified, its value is set to 1. useanyworkerbit입니다.The useanyworker is bit.

[@execution_id =] execution_id[@execution_id =] execution_id
실행 인스턴스의 고유 식별자를 반환합니다.Returns the unique identifier for an instance of execution. execution_idbigint입니다.The execution_id is bigint.

RemarksRemarks

실행은 단일 인스턴스의 패키지 실행 중에 패키지에서 사용할 매개 변수 값을 지정하는 데 사용됩니다.An execution is used to specify the parameter values that are a package uses during a single instance of package execution.

환경 참조가 reference_id 매개 변수로 지정되면 저장 프로시저에서 프로젝트 및 패키지 매개 변수를 리터럴 값 또는 해당 환경 변수에서 참조된 값으로 채웁니다.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. 환경 참조가 지정되면 패키지를 실행하는 동안 기본 매개 변수 값이 사용됩니다.If environment reference is specified, default parameter values are used during package execution. 특정 실행 인스턴스에 사용되는 값을 정확하게 확인하려면 이 저장 프로시저의 execution_id 출력 매개 변수 값을 사용하고 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.

진입점 패키지로 표시된 패키지만 실행에 지정할 수 있습니다.Only packages that are marked as entry point packages can be specified in an execution. 진입점이 아닌 패키지를 지정하면 실행에 실패합니다.If a package that is not an entry point is specified, the execution fails.

예제Example

다음 예제에서는 catalog.create_execution을 호출하여 Scale Out에 없는 Child1.dtsx 패키지에 대한 실행 인스턴스를 만듭니다. Integration Services Project1에 패키지가 포함되어 있습니다.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. 이 예에서는 catalog.set_execution_parameter_value를 호출하여 Parameter1, Parameter2 및 LOGGING_LEVEL 매개 변수에 값을 설정합니다.The example calls catalog.set_execution_parameter_value to set values for the Parameter1, Parameter2, and LOGGING_LEVEL parameters. 이 예에서는 catalog.start_execution을 호출하여 실행 인스턴스를 시작합니다.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  

반환 코드 값Return Code Value

0(성공)0 (success)

결과 집합Result Sets

InclusionThresholdSettingNone

사용 권한Permissions

이 저장 프로시저를 실행하려면 다음 권한 중 하나가 필요합니다.This stored procedure requires one of the following permissions:

  • 프로젝트에 대한 READ 및 EXECUTE 권한과 해당되는 경우 참조된 환경에 대한 READ 권한READ and EXECUTE permissions on the project and, if applicable, READ permissions on the referenced environment

  • ssis_admin 데이터베이스 역할에 대한 멤버 자격Membership to the ssis_admin database role

  • sysadmin 서버 역할에 대한 멤버 자격Membership to the sysadmin server role

    @runinscaleout이 1이면 저장 프로시저에 다음 권한 중 하나가 필요합니다.If @runinscaleout is 1, the stored procedure requires one of the following permissions:

  • ssis_admin 데이터베이스 역할에 대한 멤버 자격Membership to the ssis_admin database role

  • ssis_cluster_executor 데이터베이스 역할에 대한 멤버 자격Membership to the ssis_cluster_executor database role

  • sysadmin 서버 역할에 대한 멤버 자격Membership to the sysadmin server role

오류 및 경고Errors and Warnings

다음 목록에서는 오류나 경고가 발생할 수 있는 몇 가지 조건에 대해 설명합니다.The following list describes some conditions that can raise an error or warning:

  • 패키지가 없습니다.The package does not exist.

  • 사용자에게 적절한 권한이 없는 경우The user does not have the appropriate permissions.

  • reference_id 환경 참조가 잘못되었습니다.The environment reference, reference_id, is not valid.

  • 지정된 패키지가 진입점 패키지가 아닌 경우The package that is specified is not an entry point package.

  • 참조된 환경 변수의 데이터 형식이 프로젝트 또는 패키지 매개 변수의 데이터 형식과 다른 경우The data type of the referenced environment variable is different from the data type of the project or package parameter.

  • 프로젝트 또는 패키지에 값이 필요한 매개 변수가 있지만 할당된 값이 없는 경우The project or package contains parameters that require values, but no values have been assigned.

  • reference_id 환경 참조에서 지정하는 환경에서 참조된 환경 변수를 찾을 수 없습니다.The referenced environment variables cannot be found in the environment that the environment reference, reference_id, specifies.

참고 항목See Also

catalog.start_execution(SSISDB 데이터베이스) catalog.start_execution (SSISDB Database)
catalog.set_execution_parameter_value(SSISDB 데이터베이스)catalog.set_execution_parameter_value (SSISDB Database)
catalog.add_execution_worker(SSISDB 데이터베이스)catalog.add_execution_worker (SSISDB Database)