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

Статья
05/23/2023

Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure

Область применения: SQL Server

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

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

Синтаксис

catalog.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
CUSTOMIZED_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	None Ведение журнала выключено. Регистрируется только состояние выполнения пакета.
1	Базовая Записываются все события, за исключением пользовательских и диагностических событий. Это значение по умолчанию.
2	Производительность Регистрируются только статистика производительности, а также события OnError и OnWarning.
3	Подробный Регистрируются все события, в том числе пользовательские и диагностические события. К пользовательским относятся события, записываемые задачами служб Integration Services. Дополнительные сведения см. в разделе Пользовательские сообщения для ведения журнала.
4	Журнал преобразований в среде выполнения Собирает данные, необходимые для отслеживания журнала преобразований в потоке данных.
100	Пользовательский уровень ведения журнала Укажите значения в параметре CUSTOMIZED_LOGGING_LEVEL. Дополнительные сведения о возможных значениях см. в разделе catalog.create_customized_logging_level. Дополнительные сведения о настраиваемых уровнях ведения журнала см. в разделе Включение ведения журналов при выполнении пакета на сервере служб SSIS.

Чтобы указать, что сервер служб 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

B. Создание файлов дампа для событий

В следующем примере задано, что сервер служб 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)
Создание файлов дампа для выполнения пакетов

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