catalog.start_execution (SSISDB Database)

Artikel
2025-03-05

gäller för:SQL Server SSIS Integration Runtime i Azure Data Factory

gäller för:SQL Server

Startar en instans av körningen i Integration Services-katalogen.

Syntax

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

Argument

[@execution_id =] execution_id
Den unika identifieraren för körningsinstansen. execution_id är bigint.

[@retry_count =] retry_count
Antalet återförsök om körningen misslyckas. Den börjar gälla endast om körningen är i Skala ut. Den här parametern är valfri. Om det inte anges anges dess värde till 0. retry_count är int.

Anmärkningar

En körning används för att ange de parametervärden som används av ett paket under en enda instans av paketkörningen. När en instans av körningen har skapats kan motsvarande projekt distribueras om innan det har startats. I det här fallet refererar körningsinstansen till ett projekt som är inaktuellt. Den här ogiltiga referensen gör att den lagrade proceduren misslyckas.

Not

Körningar kan bara startas en gång. Om du vill starta en körningsinstans måste den vara i det skapade tillståndet (värdet 1 i kolumnen status i kolumnen catalog.operations).

Exempel

I följande exempel anropas catalog.create_execution för att skapa en körningsinstans för Child1.dtsx-paketet. Integration Services Project1 innehåller paketet. Exemplet anropar catalog.set_execution_parameter_value för att ange värden för parametrarna Parameter1, Parameter2 och LOGGING_LEVEL. Exemplet anropar catalog.start_execution för att starta en instans av körningen.

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

Returnera kodvärde

0 (lyckades)

Resultatuppsättningar

Ingen

Behörigheter

Den här lagrade proceduren kräver någon av följande behörigheter:

LÄS- och ÄNDRA-behörigheter för körningsinstansen, LÄS- och EXECUTE-behörigheter för projektet och i förekommande fall LÄS-behörigheter för den refererade miljön
Medlemskap i ssis_admin databasrollen
Medlemskap i serverrollen sysadmin

Fel och varningar

I följande lista beskrivs vissa villkor som kan orsaka ett fel eller en varning:

Användaren har inte rätt behörigheter
Körningsidentifieraren är ogiltig
Körningen har redan startats, eller så har den redan slutförts. körningar kan bara startas en gång
Miljöreferensen som är associerad med projektet är ogiltig
Obligatoriska parametervärden har inte angetts
Projektversionen som är associerad med körningsinstansen är inaktuell. endast den senaste versionen av ett projekt kan köras

Dela via