catalog.create_execution (база данных SSISDB)
Создает экземпляр выполнения в каталоге служб Службы Integration Services.
Эта хранимая процедура использует уровень ведения журнала по умолчанию на сервере.
Синтаксис
create_execution [ @folder_name = folder_name
, [ @project_name = ] project_name
, [ @package_name = ] package_name
[ , [ @reference_id = ] reference_id ]
[ , [ @use32bitruntime = ] use32bitruntime ]
, [ @execution_id = ] execution_id OUTPUT
Аргументы
[ @folder\_name = ] folder_name
Имя папки, содержащей пакет, который необходимо выполнить. Параметр folder_name имеет значение nvarchar(128).[ @project\_name = ] project_name
Имя проекта, содержащего пакет, который необходимо выполнить. Параметр project_name имеет значение nvarchar(128).[ @package\_name = ] package_name
Имя пакета, который необходимо выполнить. Параметр package_name имеет тип nvarchar(260).[ @reference\_id = ] reference_id
Уникальный идентификатор ссылки на среду. Этот параметр является необязательным. reference_id имеет значение bigint.[ @use32bitruntime = ] use32bitruntime
Указывает, должна ли использоваться 32-разрядная среда выполнения для запуска этого пакета в 64-разрядной операционной системе. Используйте значение 1, чтобы выполнить пакет в 32-разрядной среде выполнения при прогоне в 64-разрядной операционной системе. Используйте значение 0, чтобы выполнить пакет в 64-разрядной среде выполнения при прогоне в 64-разрядной операционной системе. Этот параметр является необязательным. Use32bitruntime имеет значение bit.[ @execution\_id = ] execution_id
Возвращает уникальный идентификатор для экземпляра выполнения. Параметр execution_id имеет значение bigint.
Замечания
Выполнение применяется для задания значений параметров, которые будут использоваться пакетом во время выполнения одного экземпляра пакета.
Если ссылка на среду задается параметром reference_id, хранимая процедура заполняет параметры проекта и пакета литеральными значениями или ссылочными значениями из соответствующих переменных среды. Если указана ссылка на среду, при выполнении пакета используются значения параметров по умолчанию. Чтобы определить, какие именно значения используются в конкретном экземпляре выполнения, воспользуйтесь значением выходного параметра execution_id из этой хранимой процедуры и выполните запрос к представлению execution_parameter_values.
В выполнении могут указываться только пакеты, отмеченные как пакеты точек входа. В случае указания пакета, который не является пакетом точки входа, происходит сбой выполнения.
Пример
В следующем примере выполняется вызов 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 и EXECUTE на проект, а также, если применимо, разрешение READ на среду, указанную в ссылке
Членство в роли базы данных ssis_admin
Членство в роли сервера sysadmin
Ошибки и предупреждения
Следующий список содержит описания некоторых условий, которые могут вызвать ошибку или предупреждение.
Пакет не существует.
Пользователь не имеет соответствующих разрешений.
Ссылка на среду reference_id недопустима.
Указанный пакет не является пакетом точки входа.
Тип данных в переменной среды, на которую указывает ссылка, отличается от типа данных параметра проекта или пакета.
Проект или пакет содержит параметры, которым требуются значения, но значения не назначены.
Переменные среды, на которые имеется ссылка, не найдены в среде, указанной ссылкой reference_id.