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

Статья
05/23/2023

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

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

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

Синтаксис

catalog.start_execution [ @execution_id = ] execution_id [, [ @retry_count = ] retry_count]

Аргументы

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

[@retry_count =] retry_count
Число повторных попыток при сбое выполнения. Оно действует только в том случае, если выполнение находится в scale Out. Этот параметр является необязательным. Если параметр не задан, используется значение 0. Параметр retry_count имеет тип int.

Замечания

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

Примечание.

Исполнения можно начинать только один раз. Чтобы запустить экземпляр выполнения, он должен быть создан (значение 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

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

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

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

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