catalog.create_environment_variable (база данных SSISDB)

Применимо к: SQL Server Integration Runtime служб SSIS в Фабрика данных Azure

Применимо к: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 его поддерживает.

Значение, передаваемое в хранимую процедуру с параметром value, будет преобразовано из типа данных служб Службы Integration Services в тип данных SQL Server согласно следующей таблице: