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

아티클
11/19/2024

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

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

[ @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	None 로깅이 꺼져 있습니다. 패키지 실행 상태만 로그됩니다.
1	기본 사용자 지정 및 진단 이벤트를 제외한 모든 이벤트가 기록됩니다. 기본값입니다.
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

사용 권한

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

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

오류 및 경고

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

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

참고 항목

catalog.execution_parameter_values (SSISDB Database)
패키지 실행을 위한 덤프 파일 생성

다음을 통해 공유