다음을 통해 공유

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

  • 아티클

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

적용 대상: SQL Server

Integration Services 카탈로그에서 매개 변수 값을 설정합니다. 값을 환경 변수에 연결하거나 다른 값이 할당되지 않은 경우 기본적으로 사용되는 리터럴 값을 할당합니다.

구문

catalog.set_object_parameter_value [ @object_type = ] object_type   
    , [ @folder_name = ] folder_name   
    , [ @project_name = ] project_name   
    , [ @parameter_name = ] parameter_name   
    , [ @parameter_value = ] parameter_value   
 [  , [ @object_name = ] object_name ]  
 [  , [ @value_type = ] value_type ]

인수

[@object_type =] object_type
매개 변수의 형식입니다. 프로젝트 매개 변수를 나타내려면 값 20을 사용하고, 패키지 매개 변수를 나타내려면 값 30을 사용합니다. object_type smallInt입니다.

[@folder_name =] folder_name
매개 변수를 포함하는 폴더의 이름입니다. folder_name은 nvarchar(128)입니다.

[@project_name =] project_name
매개 변수가 포함된 프로젝트의 이름입니다. project_name nvarchar(128)입니다.

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

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

[@object_name =] object_name
패키지 이름 매개 변수가 패키지 매개 변수인 경우 이 인수가 필요합니다. object_name은 nvarchar(260)입니다.

[@value_type =] value_type
매개 변수 값의 유형입니다. parameter_value가 실행 전에 할당된 다른 값이 없어 기본적으로 사용되는 리터럴 값임을 나타내려면 V 문자를 사용하고, 문자를 R 사용하여 parameter_value 참조된 값이며 환경 변수의 이름으로 설정되었음을 나타냅니다. 이 인수는 선택 사항이며 문자 V 는 기본적으로 사용됩니다. value_type char(1)입니다.

반환 코드 값

0(성공)

결과 집합

None

사용 권한

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

  • 프로젝트에 대한 READ 및 MODIFY 권한

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

  • sysadmin 서버 역할에 대한 멤버 자격

오류 및 경고

다음 목록에서는 저장 프로시저가 오류를 발생시킬 수 있는 몇 가지 조건을 설명합니다.

  • 매개 변수 형식이 잘못되었습니다.

  • 프로젝트 이름이 잘못되었습니다.

  • 패키지 매개 변수의 경우 패키지 이름이 잘못된 경우

  • 값 형식이 잘못되었습니다.

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

설명

  • value_type이 지정되지 않으면 parameter_value에 대한 리터럴 값이 기본적으로 사용됩니다. 리터럴 값을 사용하면 object_parameters 뷰의 value_set .로 1설정됩니다. NULL 매개 변수 값은 허용되지 않습니다.

  • value_type 참조된 값을 나타내는 문자를 R포함하는 경우 parameter_value 환경 변수의 이름을 참조합니다.

  • 값 20은 object_type이 프로젝트 매개 변수임을 나타내는 데 사용될 수 있습니다. 이 경우 object_name 값이 필요하지 않으며 object_name 지정된 값은 무시됩니다. 이 값은 사용자가 프로젝트 매개 변수를 설정하려는 경우에 사용됩니다.

  • 값 30은 object_type이 패키지 매개 변수임을 나타내는 데 사용될 수 있습니다. 이 경우 object_name 값은 해당 패키지를 나타내는 데 사용됩니다. object_name을 지정하지 않으면 저장 프로시저가 오류를 반환하고 종료됩니다.