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

아티클
05/23/2023

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

적용 대상:SQL Server

Integration Services 카탈로그의 실행 인스턴스에 대한 매개 변수 값을 설정합니다.

실행 인스턴스가 시작된 후에는 매개 변수 값을 변경할 수 없습니다.

구문

catalog.set_execution_parameter_value [ @execution_id = execution_id  
    , [ @object_type = ] object_type  
    , [ @parameter_name = ] parameter_name  
    , [ @parameter_value = ] parameter_value

인수

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

[ @object_type = ] object_type
매개 변수의 유형입니다.

다음 매개 변수의 경우 object_type을 50으로 설정합니다.

LOGGING_LEVEL
CUSTOMIZED_LOGGING_LEVEL
DUMP_ON_ERROR
DUMP_ON_EVENT
DUMP_EVENT_CODE
CALLER_INFO
SYNCHRONIZED

프로젝트 매개 변수를 나타내려면 값 20을 사용하고, 패키지 매개 변수를 나타내려면 값 30을 사용합니다.

object_type은 smallint입니다.

[ @parameter_name = ] parameter_name
매개 변수의 이름입니다. parameter_name은 nvarchar(128)입니다.

[ @parameter_value = ] parameter_value
매개 변수의 값입니다. parameter_value는 sql_variant입니다.

설명

주어진 실행에 사용된 매개 변수 값을 확인하려면 catalog.execution_parameter_values 뷰를 쿼리하십시오.

패키지 실행 중에 기록되는 정보의 범위를 지정하려면, parameter_name을 LOGGING_LEVEL로 설정하고 parameter_value를 다음 값 중 하나로 설정합니다.

object_type 매개 변수를 50으로 설정합니다.

값	설명
0	없음 로깅이 해제됩니다. 패키지 실행 상태에만 기록됩니다.
1	Basic 사용자 지정 이벤트 및 진단 이벤트 외의 모든 이벤트가 기록됩니다. 이것은 기본값입니다.
2	성능 성능 통계와 OnError 및 OnWarning 이벤트만 기록됩니다.
3	자세히 사용자 지정 이벤트 및 진단 이벤트를 포함한 모든 이벤트가 기록됩니다. 사용자 지정 이벤트는 Integration Services 태스크에 의해 기록되는 이벤트를 포함합니다. 자세한 내용은 사용자 지정된 로깅 메시지를 참조하세요.
4	런타임 계보 데이터 흐름에서 계보를 추적하는 데 필요한 데이터를 수집합니다.
100	사용자 지정된 로깅 수준 CUSTOMIZED_LOGGING_LEVEL 매개 변수에서 설정을 지정합니다. 지정할 수 있는 값에 대한 자세한 내용은 catalog.create_customized_logging_level을 참조하세요. 사용자 지정된 로깅 수준에 대한 자세한 내용은 SSIS 서버에서 패키지 실행에 대한 로깅 사용을 참조하세요.

패키지 실행 도중 오류 발생 시 Integration Services 서버가 덤프 파일을 생성하도록 지정하려면 실행되지 않은 실행 인스턴스에 대해 다음 매개 변수 값을 설정합니다.

매개 변수	값
execution_id	실행 인스턴스의 고유 식별자
object_type	50
parameter_name	'DUMP_ON_ERROR
parameter_value	1

패키지 실행 도중 이벤트 발생 시 Integration Services 서버가 덤프 파일을 생성하도록 지정하려면 실행되지 않은 실행 인스턴스에 대해 다음 매개 변수 값을 설정합니다.

매개 변수	값
execution_id	실행 인스턴스의 고유 식별자
object_type	50
parameter_name	'DUMP_ON_EVENT
parameter_value	1

패키지 실행 도중 Integration Services 서버에서 덤프 파일이 생성되도록 하는 이벤트를 지정하려면 실행되지 않은 실행 인스턴스에 대해 다음 매개 변수 값을 설정합니다. 세미콜론을 사용하여 여러 이벤트 코드를 구분합니다.

매개 변수	값
execution_id	실행 인스턴스의 고유 식별자
object_type	50
parameter_name	DUMP_EVENT_CODE
parameter_value	하나 이상의 이벤트 코드

예제

A. 오류에 대한 덤프 파일 생성

다음 예는 패키지 실행 도중 오류 발생 시 Integration Services 서버가 덤프 파일을 생성하도록 지정합니다.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_ERROR',1

B. 이벤트에 대한 덤프 파일 생성

다음 예는 패키지 실행 도중 이벤트 발생 시 Integration Services 서버가 덤프 파일을 생성하도록 지정하며 서버에서 파일이 생성되도록 하는 이벤트를 지정합니다.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_EVENT',1  
  
declare @event_code nvarchar(50)  
set @event_code = '0xC020801C'  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_EVENT_CODE', @event_code

반환 코드 값

0(성공)

결과 집합

None

사용 권한

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

실행 인스턴스에 대한 READ 및 MODIFY 권한
ssis_admin 데이터베이스 역할에 대한 멤버 자격
sysadmin 서버 역할에 대한 멤버 자격

오류 및 경고

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

사용자에게 적절한 권한이 없는 경우
실행 식별자가 잘못된 경우
매개 변수 이름이 잘못된 경우
매개 변수 값의 데이터 형식이 매개 변수의 데이터 형식과 일치하지 않는 경우

참고 항목

catalog.execution_parameter_values(SSISDB 데이터베이스)
패키지 실행을 위한 덤프 파일 생성