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

Integration Services 카탈로그에 환경 변수를 만듭니다.

구문

create_environment_variable [ @folder_name = ] folder_name
    , [ @environment_name = ] environment_name
    , [ @variable_name = ] variable_name
    , [ @data_type = ] data_type
    , [ @sensitive = ] sensitive
    , [ @value = ] value
    , [ @description = ] description

인수

• [ @folder\_name = ] folder_name
  환경이 있는 폴더의 이름입니다. folder_name은 nvarchar(128)입니다.

• [ @environment\_name = ] environment_name
  환경의 이름입니다. environment_name은 nvarchar(128)입니다.

• [ @variable\_name = ] variable_name
  환경 변수의 이름입니다. variable_name은 nvarchar(128)입니다.

• [ @data\_type = ] data_type
  변수의 데이터 형식입니다. 지원되는 환경 변수 데이터 형식에는 Boolean, Byte, DateTime, Double, Int16, Int32, Int64, Single, String, UInt32, UInt64 등이 있습니다. 지원되지 않는 환경 변수 데이터 형식에는 Char, DBNull, Object, Sbyte 등이 있습니다. data_type 매개 변수의 데이터 형식은 nvarchar(128)입니다.

• [ @sensitive = ] sensitive
  변수에 중요한 값이 포함되었는지 여부를 나타냅니다. 환경 변수 값이 중요함을 나타내려면 값 1을 사용하고, 그렇지 않음을 나타내려면 값 0을 사용합니다. 중요한 값은 저장될 때 암호화되고, 중요하지 않은 값은 일반 텍스트로 저장됩니다. Sensitive는 bit입니다.

• [ @value = ] value
  환경 변수의 값입니다. value는 sql_variant입니다.

• [ @description = ] description
  환경 변수에 대한 설명입니다. value는 nvarchar(1024)입니다.

반환 코드 값

0(성공)

결과 집합

없음

사용 권한

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

• 환경에 대한 READ 및 MODIFY 권한

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

• sysadmin 서버 역할의 멤버 자격

오류 및 경고

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

• 폴더 이름, 환경 이름 또는 환경 변수 이름이 잘못된 경우

• 변수 이름이 환경에 이미 있는 경우

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

주의

환경 변수를 사용하면 패키지 실행 시 사용할 프로젝트 매개 변수나 패키지 매개 변수에 효율적으로 값을 할당할 수 있습니다. 환경 변수는 매개 변수 값이 구성을 활성화합니다. 변수 이름은 환경 내에서 고유해야 합니다.

이 저장 프로시저는 변수의 데이터 형식에 대한 유효성을 검사하여 해당 변수가 Integration Services 카탈로그에서 지원되는지 확인합니다.

팁
Integration Services에서는 지원되지 않는 Sbyte 데이터 형식 대신 Int16 데이터 형식을 사용하는 것이 좋습니다.

이 저장 프로시저에 value 매개 변수와 함께 전달된 값은 다음 표에 따라 Integration Services 데이터 형식에서 SQL Server 데이터 형식으로 변환됩니다.