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

  • Статья

Задает значение параметра для экземпляра выполнения в каталоге служб Службы 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)

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

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