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

Статья
05/08/2013

Задает значение параметра для экземпляра выполнения в каталоге служб Службы Integration Services.

Значение параметра нельзя изменить после запуска выполнения экземпляра.

Синтаксис

set_execution_parameter_value [ @execution_id = execution_id
    , [ @object_type = ] object_type
    , [ @parameter_name = ] parameter_name
    , [ @parameter_value = ] parameter_value

Аргументы

[ @execution\_id = ] execution_id
Уникальный идентификатор для экземпляра выполнения. execution_id имеет значение bigint.
[ @object\_type = ] object_type
Тип параметра.

Для следующих параметров установите object_type в значение 50
- LOGGING_LEVEL
- DUMP_ON_ERROR
- DUMP_ON_EVENT
- DUMP_EVENT_CODE
- CALLER_INFO
- SYNCHRONIZED
Значение 20 указывает параметр проекта, значение 30 — параметр пакета.

object_type имеет значение smallint.
[ @parameter\_name = ] parameter_name
Имя параметра. parameter_name имеет значение nvarchar(128).
[ @parameter\_value = ] parameter_value
Значение параметра. Параметр parameter_value имеет тип sql_variant.

Замечания

Чтобы выяснить значения параметров, использованные в ходе данного выполнения, выполните запрос к представлению catalog.execution_parameter_values.

Чтобы задать диапазон информации, регистрируемой в ходе выполнения пакета, назначьте параметру parameter_name значение LOGGING_LEVEL, а параметру parameter_value — одно из следующих значений.

Задайте параметру object_type значение 50.

Значение	Описание
0	Отсутствует Ведение журнала выключено. Регистрируется только состояние выполнения пакета.
1	Базовое Записываются все события, за исключением пользовательских и диагностических событий. Это значение по умолчанию.
2	Производительность Регистрируются только статистика производительности, а также события OnError и OnWarning.
3	Подробно Регистрируются все события, в том числе пользовательские и диагностические события. К пользовательским относятся события, записываемые задачами служб Integration Services. Дополнительные сведения см. в разделе Пользовательские сообщения для ведения журнала

Чтобы указать, что сервер служб Integration Services создает файлы дампа при возникновении любой ошибки в ходе выполнения пакета, установите следующие значения параметров для экземпляра выполнения, который не запускался.

Параметр	Значение
execution_id	Уникальный идентификатор для экземпляра выполнения
object_type	50
parameter_name	‘DUMP_ON_ERROR
parameter_value	1

Чтобы указать, что сервер служб Integration Services создает файлы дампа при возникновении событий в ходе выполнения пакета, установите следующие значения параметров для экземпляра выполнения, который не запускался.

Параметр	Значение
execution_id	Уникальный идентификатор для экземпляра выполнения
object_type	50
parameter_name	‘DUMP_ON_EVENT
parameter_value	1

Чтобы указать события в ходе выполнения пакета, в результате которых сервер служб Integration Services создает файлы дампа, установите следующие значения параметров для экземпляра выполнения, который не запускался. Разделите несколько кодов событий, используя точку с запятой.

Параметр	Значение
execution_id	Уникальный идентификатор для экземпляра выполнения
object_type	50
parameter_name	DUMP_EVENT_CODE
parameter_value	Один или несколько кодов событий

Пример

В следующем примере задано, что сервер служб Integration Services создает файлы дампа при возникновении любой ошибки в ходе выполнения пакета.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_ERROR',1

В следующем примере задано, что сервер служб Integration Services создает файлы дампа при возникновении событий в ходе выполнения пакета, и указано событие, в результате которого сервер создает файлы.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_EVENT',1

declare @event_code nvarchar(50)
set @event_code = '0xC020801C'
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_EVENT_CODE', @event_code

Значения кодов возврата

0 (успешное завершение)

Результирующие наборы

Нет

Разрешения

Эта хранимая процедура требует применения одного из следующих разрешений:

Разрешения READ и MODIFY на экземпляр выполнения
Членство в роли базы данных ssis_admin
Членство в роли сервера sysadmin

Ошибки и предупреждения

Следующий список содержит описания некоторых условий, которые могут вызвать ошибку или предупреждение.

Пользователь не имеет соответствующих разрешений
Недопустимый идентификатор выполнения
Имя параметра недопустимо
Тип данных значения параметра не соответствует типу данных параметра

См. также

Справочник

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

Основные понятия

Создание файлов дампа для выполнения пакетов

Поделиться через