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

Статья
05/08/2013

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

Синтаксис

start_execution [ @execution_id = ] execution_id

Аргументы

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

Замечания

Выполнение применяется для задания значений параметров, которые будут использоваться пакетом в течение одного экземпляра выполнения пакета. После создания экземпляра исполнения и до его начала соответствующий проект должен быть повторно развернут. В этом случае экземпляр исполнения будет ссылаться на устаревший проект. Из-за этого хранимая процедура завершится с ошибкой.

Примечание
Исполнения можно начинать только один раз. Чтобы запустить экземпляр выполнения, он должен быть создан (значение 1 в столбце status представления catalog.operations).

Пример

В следующем примере выполняется вызов catalog.create_execution для создания экземпляра выполнения пакета Child1.dtsx. Проект Project1 служб Integration Services содержит пакет. В этом примере выполняется вызов catalog.set_execution_parameter_value для задания значений для параметров Parameter1, Parameter2 и LOGGING_LEVEL. В этом примере выполняется вызов catalog.start_execution для запуска экземпляра выполнения.

Declare @execution_id bigint
EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Child1.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'TestDeply4', @project_name=N'Integration Services Project1', @use32bitruntime=False, @reference_id=Null
Select @execution_id
DECLARE @var0 sql_variant = N'Child1.dtsx'
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=20, @parameter_name=N'Parameter1', @parameter_value=@var0
DECLARE @var1 sql_variant = N'Child2.dtsx'
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=20, @parameter_name=N'Parameter2', @parameter_value=@var1
DECLARE @var2 smallint = 1
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var2
EXEC [SSISDB].[catalog].[start_execution] @execution_id
GO

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

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

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

Нет

Разрешения

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

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

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

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

Пользователь не имеет соответствующих разрешений
Недопустимый идентификатор выполнения
Исполнение уже началось или уже завершилось; исполнения могут начаться только один раз
Связанная с проектом ссылка на среду недействительна
Требуемые значения параметра не заданы
Версия проекта, связанная с экземпляром исполнения, устарела; может быть исполнена только последняя версия проекта

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