catalog.create_environment_variable(SSISDB 데이터베이스)
적용 대상: Azure Data Factory SSIS Integration Runtime SQL Server
적용 대상: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
변수의 데이터 형식입니다. 지원되는 환경 변수 데이터 형식은 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(성공)
결과 집합
None
사용 권한
이 저장 프로시저를 실행하려면 다음 권한 중 하나가 필요합니다.
환경에 대한 READ 및 MODIFY 권한
ssis_admin 데이터베이스 역할에 대한 멤버 자격
sysadmin 서버 역할에 대한 멤버 자격
오류 및 경고
다음 목록에서는 오류나 경고가 발생하는 몇 가지 조건을 설명합니다.
폴더 이름, 환경 이름 또는 환경 변수 이름이 잘못된 경우
변수 이름이 환경에 이미 있는 경우
사용자에게 적절한 권한이 없는 경우
설명
환경 변수를 사용하면 패키지 실행 시 사용할 프로젝트 매개 변수나 패키지 매개 변수에 효율적으로 값을 할당할 수 있습니다. 환경 변수는 매개 변수 값이 구성을 활성화합니다. 변수 이름은 환경 내에서 고유해야 합니다.
이 저장 프로시저는 변수의 데이터 형식에 대한 유효성을 검사하여 해당 변수가 Integration Services 카탈로그에서 지원되는지 확인합니다.
팁
Integration Services에서는 지원되지 않는 Sbyte 데이터 형식 대신 Int16 데이터 형식을 사용하는 것이 좋습니다.
value 매개 변수를 사용하여 이 저장 프로시저에 전달된 값은 다음 표에 따라 Integration Services 데이터 형식에서 SQL Server 데이터 형식으로 변환됩니다.
Integration Services 데이터 형식 | SQL Server 데이터 형식 |
---|---|
Boolean | bit |
Byte | binary, varbinary |
DateTime | datetime, datetime2, datetimeoffset, smalldatetime |
double | 정밀 숫자: decimal, numeric, 근사 숫자: float, real |
Int16 | smallint |
Int32 | int |
Int64 | bigint |
Single | 정밀 숫자: decimal, numeric, 근사 숫자: float, real |
String | varchar, nvarchar, char |
UInt32 | int(int는 Uint32에 사용할 수 있는 가장 가까운 매핑입니다.) |
UInt64 | bigint(int는 Uint64에 사용할 수 있는 가장 가까운 매핑입니다.) |