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

이 항목은 다음에 적용됩니다.예SQL Server(2012부터)아니요Azure SQL Database아니요Azure SQL Data Warehouse 아니요병렬 데이터 웨어하우스 THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Integration ServicesIntegration Services 카탈로그의 실행 인스턴스에 대한 매개 변수 값을 설정합니다.Sets the value of a parameter for an instance of execution in the Integration ServicesIntegration Services catalog.

실행 인스턴스가 시작된 후에는 매개 변수 값을 변경할 수 없습니다.A parameter value cannot be changed after an instance of execution has started.

구문Syntax

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

인수Arguments

[ @execution_id =] execution_id[ @execution_id = ] execution_id
실행 인스턴스의 고유 식별자입니다.The unique identifier for the instance of execution. execution_idbigint합니다.The execution_id is bigint.

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

다음 매개 변수 설정 object_type 50For the following parameters, set object_type to 50

  • LOGGING_LEVELLOGGING_LEVEL

  • CUSTOMIZED_LOGGING_LEVELCUSTOMIZED_LOGGING_LEVEL

  • DUMP_ON_ERRORDUMP_ON_ERROR

  • DUMP_ON_EVENTDUMP_ON_EVENT

  • DUMP_EVENT_CODEDUMP_EVENT_CODE

  • CALLER_INFOCALLER_INFO

  • SYNCHRONIZEDSYNCHRONIZED

    프로젝트 매개 변수를 나타내려면 값 20을 사용하고, 패키지 매개 변수를 나타내려면 값 30을 사용합니다.Use the value 20 to indicate a project parameter or the value 30 to indicate a package parameter.

    object_typesmallint합니다.The object_type is smallint.

    [ @parameter_name =] p a r a[ @parameter_name = ] parameter_name
    매개 변수의 이름입니다.The name of the parameter. p a r anvarchar (128)합니다.The parameter_name is nvarchar(128).

    [ @parameter_value =] parameter_value[ @parameter_value = ] parameter_value
    매개 변수의 값입니다.The value of the parameter. parameter_valuesql_variant합니다.The parameter_value is sql_variant.

주의Remarks

주어진 실행에 사용된 매개 변수 값을 확인하려면 catalog.execution_parameter_values 뷰를 쿼리하십시오.To find out the parameter values that were used for a given execution, query the catalog.execution_parameter_values view.

패키지 실행 도중 기록 될 정보의 범위를 지정 하려면 설정 p a r a 을 설정 하 고 LOGGING_LEVEL parameter_value 를 다음 값 중 하나입니다.To specify the scope of information that is logged during a package execution, set parameter_name to LOGGING_LEVEL and set parameter_value to one of the following values.

설정의 object_type 매개 변수를 50입니다.Set the object_type parameter to 50.

ValueValue 설명Description
00 InclusionThresholdSettingNone

로깅이 해제됩니다.Logging is turned off. 패키지 실행 상태에만 기록됩니다.Only the package execution status is logged.
11 BasicBasic

사용자 지정 이벤트 및 진단 이벤트 외의 모든 이벤트가 기록됩니다.All events are logged, except custom and diagnostic events. 이 값은 기본값입니다.This is the default value.
22 성능Performance

성능 통계와 OnError 및 OnWarning 이벤트만 기록됩니다.Only performance statistics, and OnError and OnWarning events, are logged.
33 VerboseVerbose

사용자 지정 이벤트 및 진단 이벤트를 포함한 모든 이벤트가 기록됩니다.All events are logged, including custom and diagnostic events.
사용자 지정 이벤트는 Integration Services 태스크에 의해 기록되는 이벤트를 포함합니다.Custom events include those events that are logged by Integration Services tasks. 자세한 내용은 참조 Custom Messages for LoggingFor more information, see Custom Messages for Logging
44 런타임 계보Runtime lineage

데이터 흐름에서 계보를 추적 하는 데 필요한 데이터를 수집 합니다.Collects the data required to track lineage in the data flow.
100100 사용자 지정 로깅 수준Custom logging level

CUSTOMIZED_LOGGING_LEVEL 매개 변수에서 설정을 지정 합니다.Specify the settings in the CUSTOMIZED_LOGGING_LEVEL parameter. 지정할 수 있는 값에 대 한 자세한 내용은 참조 하십시오. catalog.create_customized_logging_level합니다.For more info about the values that you can specify, see catalog.create_customized_logging_level.

사용자 지정 된 로깅 수준에 대 한 자세한 내용은 참조 하십시오. Enable Logging for Package Execution on the SSIS Server합니다.For more info about customized logging levels, see Enable Logging for Package Execution on the SSIS Server.

패키지 실행 도중 오류 발생 시 Integration Services 서버가 덤프 파일을 생성하도록 지정하려면 실행되지 않은 실행 인스턴스에 대해 다음 매개 변수 값을 설정하십시오.To specify that the Integration Services server generates dump files when any error occurs during a package execution, set the following parameter values for an execution instance that hasn’t run.

매개 변수Parameter ValueValue
execution_idexecution_id 실행 인스턴스의 고유 식별자The unique identifier for the instance of execution
object_typeobject_type 5050
p a r aparameter_name ‘DUMP_ON_ERROR‘DUMP_ON_ERROR
parameter_valueparameter_value 1.1

패키지 실행 도중 이벤트 발생 시 Integration Services 서버가 덤프 파일을 생성하도록 지정하려면 실행되지 않은 실행 인스턴스에 대해 다음 매개 변수 값을 설정하십시오.To specify that the Integration Services server generates dump files when events occur during a package execution, set the following parameter values for an execution instance that hasn’t run.

매개 변수Parameter ValueValue
execution_idexecution_id 실행 인스턴스의 고유 식별자The unique identifier for the instance of execution
object_typeobject_type 5050
p a r aparameter_name ‘DUMP_ON_EVENT‘DUMP_ON_EVENT
parameter_valueparameter_value 11

패키지 실행 도중 Integration Services 서버에서 덤프 파일이 생성되도록 하는 이벤트를 지정하려면 실행되지 않은 실행 인스턴스에 대해 다음 매개 변수 값을 설정하십시오.To specify the events during package execution that cause the Integration Services server to generate dump files, set the following parameter values for an execution instance that hasn’t run. 세미콜론을 사용하여 여러 이벤트 코드를 구분합니다.Separate multiple event codes using a semi-colon.

매개 변수Parameter ValueValue
execution_idexecution_id 실행 인스턴스의 고유 식별자The unique identifier for the instance of execution
object_typeobject_type 5050
p a r aparameter_name DUMP_EVENT_CODEDUMP_EVENT_CODE
parameter_valueparameter_value 하나 이상의 이벤트 코드One or more event codes

예제Example

다음 예는 패키지 실행 도중 오류 발생 시 Integration Services 서버가 덤프 파일을 생성하도록 지정합니다.The following example specifies that the Integration Services server generates dump files when any error occurs during a package execution.

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  

예제Example

다음 예는 패키지 실행 도중 이벤트 발생 시 Integration Services 서버가 덤프 파일을 생성하도록 지정하며 서버에서 파일이 생성되도록 하는 이벤트를 지정합니다.The following example specifies that the Integration Services server generates dump files when events occur during a package execution, and specifies the event that causes the server to generate the files.

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  

반환 코드 값Return Code Value

0(성공)0 (success)

결과 집합Result Sets

InclusionThresholdSettingNone

사용 권한Permissions

이 저장 프로시저를 실행하려면 다음 권한 중 하나가 필요합니다.This stored procedure requires one of the following permissions:

  • 실행 인스턴스에 대한 READ 및 MODIFY 권한READ and MODIFY permissions on the instance of execution

  • 멤버 자격에는 ssis_admin 데이터베이스 역할Membership to the ssis_admin database role

  • 멤버 자격에는 sysadmin 서버 역할Membership to the sysadmin server role

오류 및 경고Errors and Warnings

다음 목록에서는 오류나 경고가 발생하는 몇 가지 조건을 설명합니다.The following list describes some conditions that may raise an error or warning:

  • 사용자에게 적절한 권한이 없는 경우The user does not have the appropriate permissions

  • 실행 식별자가 잘못된 경우The execution identifier is not valid

  • 매개 변수 이름이 잘못된 경우The parameter name is not valid

  • 매개 변수 값의 데이터 형식이 매개 변수의 데이터 형식과 일치하지 않는 경우The data type of the parameter value does not match the data type of the parameter

관련 항목:See Also

catalog.execution_parameter_values ( SSISDB 데이터베이스 ) catalog.execution_parameter_values (SSISDB Database)
패키지 실행을 위한 덤프 파일 생성Generating Dump Files for Package Execution