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

  • 아티클

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

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

구문

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

    • 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

기본

사용자 지정 이벤트 및 진단 이벤트 외의 모든 이벤트가 기록됩니다. 기본값입니다.

2

성능

성능 통계와 OnError 및 OnWarning 이벤트만 기록됩니다.

3

자세히

사용자 지정 이벤트 및 진단 이벤트를 포함한 모든 이벤트가 기록됩니다.
사용자 지정 이벤트는 Integration Services 태스크에 의해 기록되는 이벤트를 포함합니다. 자세한 내용은 로깅할 메시지 사용자 지정을 참조하십시오.

패키지 실행 도중 오류 발생 시 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

하나 이상의 이벤트 코드

예

다음 예는 패키지 실행 도중 오류 발생 시 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

다음 예는 패키지 실행 도중 이벤트 발생 시 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(성공)

결과 집합

없음

사용 권한

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

  • 실행 인스턴스에 대한 READ 및 MODIFY 권한

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

  • sysadmin 서버 역할의 멤버 자격

오류 및 경고

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

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

  • 실행 식별자가 잘못된 경우

  • 매개 변수 이름이 잘못된 경우

  • 매개 변수 값의 데이터 형식이 매개 변수의 데이터 형식과 일치하지 않는 경우

참고 항목

참조

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

개념

패키지 실행을 위한 덤프 파일 생성