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

  • 아티클

적용 대상: Azure Data Factory SSIS Integration Runtime SQL Server

적용 대상:SQL Server

Integration Services 카탈로그에 실행 인스턴스를 만듭니다.

이 저장 프로시저는 기본 서버 로깅 수준을 사용합니다.

구문

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

인수

[@folder_name =] folder_name
실행할 패키지가 있는 폴더의 이름입니다. folder_name은 nvarchar(128) 입니다.

[@project_name =] project_name
실행할 패키지가 포함된 프로젝트의 이름입니다. project_name은 nvarchar(128) 입니다.

[@package_name =] package_name
실행할 패키지의 이름입니다. package_name은 nvarchar(260)입니다.

[@reference_id =] reference_id
환경 참조의 고유 식별자입니다. 이 매개 변수는 선택 사항입니다. reference_id는 bigint입니다.

[@use32bitruntime =] use32bitruntime
64비트 운영 체제에서 32비트 런타임을 사용하여 패키지를 실행해야 하는지 여부를 나타냅니다. 64비트 운영 체제에서 실행할 때 1 값을 사용하여 32비트 런타임으로 패키지를 실행합니다. 64비트 운영 체제에서 실행할 때 64비트 런타임으로 패키지를 실행하려면 값 0을 사용합니다. 이 매개 변수는 선택 사항입니다. Use32bitruntime은 bit입니다.

[@runinscaleout =] runinscaleout
실행이 Scale Out에 있는지 여부를 나타냅니다. Scale Out에서 패키지를 실행하려면 1 값을 사용합니다. Scale Out을 사용하지 않고 패키지를 실행하려면 0 값을 사용합니다. 이 매개 변수는 선택 사항입니다. 지정하지 않으면 해당 값이 [SSISDB].[catalog].[catalog_properties]에서 DEFAULT_EXECUTION_MODE로 설정됩니다. runinscaleout은 bit입니다.

[@useanyworker =] useanyworker
Scale Out 작업자에서 실행을 수행할 수 있는지 여부를 나타냅니다.

  • Scale Out 작업자를 사용하여 패키지를 실행하려면 1 값을 사용합니다. @useanyworker를 true로 설정하면 최대 작업 수 (작업자 구성 파일에 지정된 대로)에 아직 도달하지 않은 작업자가 패키지를 실행할 수 있습니다. 작업자 구성 파일에 대한 정보는 Integration Services(SSIS) Scale Out 작업자를 참조합니다.

  • 일부 Scale Out 작업자에서 패키지를 실행할 수 있음을 나타내려면 0 값을 사용합니다. @useanyworker를 false로 설정하면 Scale Out 관리자를 사용하거나 저장 프로시저 [catalog].[add_execution_worker]를 호출하여 패키지를 실행할 수 있는 작업자를 지정해야 합니다. 이미 다른 패키지를 실행 중인 작업자를 지정하면, 작업자가 다른 패키지 실행을 요청하기 전에 현재 패키지 실행을 완료합니다.

이 매개 변수는 선택 사항입니다. 지정하지 않으면 해당 값이 1로 설정됩니다. useanyworker는 bit입니다.

[@execution_id =] execution_id
실행 인스턴스의 고유 식별자를 반환합니다. execution_id는 bigint입니다.

설명

실행은 단일 인스턴스의 패키지 실행 중에 패키지에서 사용할 매개 변수 값을 지정하는 데 사용됩니다.

환경 참조가 reference_id 매개 변수로 지정되면 저장 프로시저에서 프로젝트 및 패키지 매개 변수를 리터럴 값 또는 해당 환경 변수에서 참조된 값으로 채웁니다. 환경 참조가 지정되면 패키지를 실행하는 동안 기본 매개 변수 값이 사용됩니다. 특정 실행 인스턴스에 사용되는 값을 정확하게 확인하려면 이 저장 프로시저의 execution_id 출력 매개 변수 값을 사용하고 execution_parameter_values 뷰를 쿼리합니다.

진입점 패키지로 표시된 패키지만 실행에 지정할 수 있습니다. 진입점이 아닌 패키지를 지정하면 실행에 실패합니다.

예제

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

반환 코드 값

0(성공)

결과 집합

None

사용 권한

이 저장 프로시저를 실행하려면 다음 권한 중 하나가 필요합니다.

  • 프로젝트에 대한 READ 및 EXECUTE 권한과 해당되는 경우 참조된 환경에 대한 READ 권한

  • ssis_admin 데이터베이스 역할에 대한 멤버 자격

  • sysadmin 서버 역할에 대한 멤버 자격

@runinscaleout이 1이면 저장 프로시저에 다음 권한 중 하나가 필요합니다.

  • ssis_admin 데이터베이스 역할에 대한 멤버 자격

  • ssis_cluster_executor 데이터베이스 역할에 대한 멤버 자격

  • sysadmin 서버 역할에 대한 멤버 자격

오류 및 경고

다음 목록에서는 오류나 경고가 발생할 수 있는 몇 가지 조건에 대해 설명합니다.

  • 패키지가 없습니다.

  • 사용자에게 적절한 권한이 없는 경우

  • reference_id 환경 참조가 잘못되었습니다.

  • 지정된 패키지가 진입점 패키지가 아닌 경우

  • 참조된 환경 변수의 데이터 형식이 프로젝트 또는 패키지 매개 변수의 데이터 형식과 다른 경우

  • 프로젝트 또는 패키지에 값이 필요한 매개 변수가 있지만 할당된 값이 없는 경우

  • reference_id 환경 참조에서 지정하는 환경에서 참조된 환경 변수를 찾을 수 없습니다.

참고 항목

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