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

아티클
11/19/2024

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

적용 대상: 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 대단합니다.

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

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

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

1 값을 사용하여 Scale Out 작업자로 패키지를 실행합니다. @useanyworker를 true로 설정하면 최대 작업 수 (작업자 구성 파일에 지정된 대로)에 아직 도달하지 않은 작업자가 패키지를 실행할 수 있습니다. 작업자 구성 파일에 대한 자세한 내용은 Integration Services(SSIS) Scale Out 작업자를 참조 하세요.
0 값을 사용하여 모든 Scale Out 작업자가 패키지를 실행할 수 없음을 나타냅니다. false로 설정 @useanyworker 하면 Scale Out 관리자를 사용하거나 저장 프로시저 [catalog].[add_execution_worker]를 호출하여 패키지를 실행할 수 있는 작업자를 지정해야 합니다. 이미 다른 패키지를 실행 중인 작업자를 지정하면 작업자는 다른 실행을 요청하기 전에 현재 패키지 실행을 완료합니다.

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

[@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 서버 역할에 대한 멤버 자격

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

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 데이터베이스)

다음을 통해 공유