다음을 통해 공유

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

  • 아티클

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

적용 대상: SQL Server

Integration Services 카탈로그에서 실행 인스턴스를 시작합니다.

구문

catalog.start_execution [ @execution_id = ] execution_id [, [ @retry_count = ] retry_count]

인수

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

[@retry_count =] retry_count
실행이 실패할 경우의 재시도 횟수입니다. 실행이 Scale Out에 있는 경우에만 적용됩니다. 이 매개 변수는 선택 사항입니다. 지정하지 않으면 해당 값이 0으로 설정됩니다. retry_count는 int입니다.

설명

실행은 패키지 실행의 단일 인스턴스 동안 패키지에서 사용되는 매개 변수 값을 지정하는 데 사용됩니다. 실행 인스턴스가 만들어지면 실행이 시작되기 전에 해당 프로젝트가 다시 배포될 수 있습니다. 이 경우 실행 인스턴스는 오래된 프로젝트를 참조합니다. 이 잘못된 참조로 인해 저장 프로시저가 실패합니다.

참고 항목

실행은 한 번만 시작할 수 있습니다. 실행 인스턴스를 시작하려면 생성된 상태(catalog.operations 뷰의 1 상태 열에 있는 값)에 있어야 합니다.

예시

다음 예에서는 catalog.create_execution을 호출하여 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 및 MODIFY 권한, 프로젝트에 대한 READ 및 EXECUTE 권한, 해당되는 경우 참조된 환경에 대한 READ 권한

  • ssis_admin 데이터베이스 역할의 멤버 자격

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

오류 및 경고

다음 목록에서는 오류나 경고가 발생하는 몇 가지 조건을 제공합니다.

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

  • 실행 식별자가 잘못되었습니다.

  • 실행이 이미 시작되었거나 이미 완료되었습니다. 실행은 한 번만 시작할 수 있습니다.

  • 프로젝트와 연결된 환경 참조가 잘못되었습니다.

  • 필수 매개 변수 값이 설정되지 않았습니다.

  • 실행 인스턴스와 연결된 프로젝트 버전이 오래되었습니다. 프로젝트의 최신 버전만 실행할 수 있습니다.