다음을 통해 공유

catalog.create_environment_variable (SSISDB Database)

  • 아티클

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

적용 대상: SQL Server

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

구문

catalog.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
변수의 데이터 형식입니다. 지원되는 환경 변수 데이터 형식에는 부울, 바이트, DateTime, Double, Int16, Int32, Int64, Single, String, UInt32 및 UInt64가 포함됩니다. 지원되지 않는 환경 변수 데이터 형식에는 Char, DBNull, Object 및 Sbyte가 포함됩니다. data_type 매개 변수의 데이터 형식은 nvarchar(128)입니다.

[@sensitive =] sensitive
변수에 중요한 값이 포함되었는지 여부를 나타냅니다. 값을 1 사용하여 환경 변수의 값이 중요한지 또는 값이 아니라는 것을 나타내는 값을 0 사용합니다. 중요한 값은 저장될 때 암호화됩니다. 민감하지 않은 값은 일반 텍스트로 저장됩니다.민감도는 비트입니다.

[@value =] value
환경 변수의 값. 값이 sql_variant.

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

반환 코드 값

0(성공)

결과 집합

None

사용 권한

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

  • 환경에 대한 READ 및 MODIFY 권한

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

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

오류 및 경고

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

  • 폴더 이름, 환경 이름 또는 환경 변수 이름이 잘못되었습니다.

  • 변수 이름이 환경에 이미 있습니다.

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

설명

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

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

팁

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

값 매개 변수를 사용하여 이 저장 프로시저에 전달된 값 은 다음 표에 따라 Integration Services 데이터 형식에서 SQL Server 데이터 형식으로 변환됩니다.

Integration Services 데이터 형식 SQL Server 데이터 형식
부울 bit
Byte binary, varbinary
DateTime datetime, datetime2, datetimeoffset, smalldatetime
이중 정확한 숫자: 10진수, 숫자; 근사 숫자: float, real
Int16 smallint
Int32 int
Int64 bigint
Single 정확한 숫자: 10진수, 숫자; 근사 숫자: float, real
String varchar, nvarchar, char
UInt32 int(int는 Uint32에 가장 가까운 사용 가능한 매핑입니다.)
UInt64 bigint(int는 Uint64에 가장 가까운 사용 가능한 매핑입니다.)