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

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 비트 운영 체제에서 실행 될 때 32 비트 런타임 사용 하 여 패키지를 실행할 1의 값을 사용 합니다.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. Use32bitruntime비트합니다.The Use32bitruntime is bit.

[ @runinscaleout =] runinscaleout[ @runinscaleout = ] runinscaleout
범위 확장의 실행 여부를 나타냅니다.Indicate whether the execution is in Scale Out. 스케일 아웃에 패키지를 실행 하려면 1의 값을 사용 합니다.Use the value of 1 to execute the package in Scale Out. 스케일 아웃 하지 않고 패키지를 실행 하려면 0의 값을 사용 합니다.Use the value of 0 to execute the package without Scale Out. 이 매개 변수는 선택 사항입니다.This parameter is optional. [SSISDB]에서 DEFAULT_EXECUTION_MODE에 설정 됩니다. [catalog]입니다. [catalog_properties]를 지정 하지 않은 경우입니다.It is set to DEFAULT_EXECUTION_MODE in [SSISDB].[catalog].[catalog_properties], if not specified. runinscaleout비트합니다.The runinscaleout is bit.

[ @useanyworker =] useanyworker[ @useanyworker = ] useanyworker
실행 작업을 수행 하는 스케일 아웃 작업자 허용 되는지 여부를 나타냅니다.Indicate whether any Scale Out Worker is allowed to do the execution. 값 1 사용 하 여 스케일 아웃 작업자를 사용 하 여 패키지를 실행 합니다.Use the value of 1 to execute the package with any Scale Out Worker. 일부 스케일 아웃 작업자 패키지를 실행할 수 있는지를 나타내는 0의 값을 사용 합니다.Use the value of 0 to indicate that not all Scale Out Workers are allowed to execute the package. 이 매개 변수는 선택 사항입니다.This parameter is optional. 그는 1로 설정 되지 않은 경우 지정 합니다.It is set to 1, if not specified. useanyworker비트합니다.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.

주의Remarks

실행은 단일 인스턴스의 패키지 실행 중에 패키지에서 사용할 매개 변수 값을 지정하는 데 사용됩니다.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을 호출 스케일 아웃에 없는 여 Child1.dtsx 패키지에 대 한 실행 인스턴스를 만듭니다.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에 패키지가 포함되어 있습니다.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)