catalog.create_execution(SSISDB 데이터베이스)
Integration Services 카탈로그에 실행 인스턴스를 만듭니다.
이 저장 프로시저는 기본 서버 로깅 수준을 사용합니다.
구문
create_execution [ @folder_name = folder_name
, [ @project_name = ] project_name
, [ @package_name = ] package_name
[ , [ @reference_id = ] reference_id ]
[ , [ @use32bitruntime = ] use32bitruntime ]
, [ @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비트 운영 체제에서 실행할 때 32비트 런타임으로 패키지를 실행하려면 값 1을 사용하고, 64비트 운영 체제에서 실행할 때 64비트 런타임으로 패키지를 실행하려면 값 0을 사용합니다. 이 매개 변수는 선택 사항입니다. Use32bitruntime은 bit입니다.[ @execution\_id = ] execution_id
실행 인스턴스의 고유 식별자를 반환합니다. execution_id는 bigint입니다.
설명
실행은 단일 인스턴스의 패키지 실행 중에 패키지에서 사용할 매개 변수 값을 지정하는 데 사용됩니다.
환경 참조가 reference_id 매개 변수로 지정된 경우 저장 프로시저는 리터럴 값 또는 해당 환경 변수의 참조된 값으로 프로젝트 및 패키지 매개 변수를 채웁니다. 환경 참조가 지정되면 패키지를 실행하는 동안 기본 매개 변수 값이 사용됩니다. 특정 실행 인스턴스에 사용되는 값을 정확하게 확인하려면 이 저장 프로시저의 execution_id 출력 매개 변수 값을 사용하여 execution_parameter_values 뷰를 쿼리하십시오.
진입점 패키지로 표시된 패키지만 실행에 지정할 수 있습니다. 진입점이 아닌 패키지를 지정하면 실행에 실패합니다.
예제
다음 예에서는 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(성공)
결과 집합
없음
사용 권한
이 저장 프로시저를 실행하려면 다음 권한 중 하나가 필요합니다.
프로젝트에 대한 READ 및 EXECUTE 권한과 해당되는 경우 참조된 환경에 대한 READ 권한
ssis_admin 데이터베이스 역할의 멤버 자격
sysadmin 서버 역할의 멤버 자격
오류 및 경고
다음 목록에서는 오류나 경고가 발생할 수 있는 몇 가지 조건에 대해 설명합니다.
패키지가 없습니다.
사용자에게 적절한 권한이 없는 경우
환경 참조 reference_id가 잘못된 경우
지정된 패키지가 진입점 패키지가 아닌 경우
참조된 환경 변수의 데이터 형식이 프로젝트 또는 패키지 매개 변수의 데이터 형식과 다른 경우
프로젝트 또는 패키지에 값이 필요한 매개 변수가 있지만 할당된 값이 없는 경우
환경 참조 reference_id로 지정된 환경에서 참조된 환경 변수를 찾을 수 없는 경우