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

  • Статья

Применимо к: SQL Server Integration Runtime служб SSIS в Фабрика данных 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 Basic

Записываются все события, за исключением пользовательских и диагностических событий. Это значение по умолчанию.
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 Один или несколько кодов событий

Примеры

A. Создание файлов дампа для ошибок

В следующем примере задано, что сервер служб 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 (успешное завершение)

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

None

Разрешения

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

  • разрешения READ и MODIFY на экземпляр выполнения

  • Членство в роли базы данных ssis_admin

  • Членство в роли сервера sysadmin

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

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

  • Пользователь не имеет соответствующих разрешений

  • Недопустимый идентификатор выполнения

  • Имя параметра недопустимо

  • Тип данных значения параметра не соответствует типу данных параметра

См. также

catalog.execution_parameter_values (база данных SSISDB)
Создание файлов дампа для выполнения пакетов