catalog.start_execution (databáze SSISDB)

platí pro:SQL Server SSIS Integration Runtime ve službě Azure Data Factory

platí pro:SQL Server

Spustí instanci spuštění v katalogu integračních služeb.

Syntax

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

Argumenty

[@execution_id =] execution_id
Jedinečný identifikátor instance spuštění. execution_id je bigint.

[@retry_count =] retry_count
Počet opakování, pokud se spuštění nezdaří. Projeví se pouze v případě, že je provádění ve horizontálním navýšení kapacity. Tento parametr je volitelný. Pokud není zadána, jeho hodnota je nastavena na hodnotu 0. retry_count je int.

Poznámky

Provádění se používá k určení hodnot parametrů, které balíček používá během jedné instance spuštění balíčku. Po vytvoření instance spuštění může být odpovídající projekt znovu nasazen. V tomto případě instance provádění odkazuje na projekt, který je zastaralý. Tento neplatný odkaz způsobí selhání uložené procedury.

Poznámka

Spouštění je možné spustit pouze jednou. Pokud chcete spustit instanci spuštění, musí být ve vytvořeném stavu (hodnota 1 ve sloupci stavu zobrazení catalog. operations).

Příklad

Následující příklad volá catalog.create_execution k vytvoření instance spuštění pro balíček Child1.dtsx. Projekt integračních služeb 1 obsahuje balíček. Příklad volá catalog.set_execution_parameter_value nastavit hodnoty parametrů Parameter1, Parameter2 a LOGGING_LEVEL. Příklad volá catalog.start_execution ke spuštění instance.

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  

Návratová hodnota kódu

0 (úspěch)

Sady výsledků

Žádný

Dovolení

Tato uložená procedura vyžaduje jedno z následujících oprávnění:

• Oprávnění READ a MODIFY pro instanci spuštění, oprávnění READ a EXECUTE v projektu a v případě potřeby oprávnění READ pro odkazované prostředí

• Členství v roli databáze ssis_admin

• Členství v roli serveru správce systému

Chyby a upozornění

Následující seznam popisuje některé podmínky, které mohou vyvolat chybu nebo upozornění:

• Uživatel nemá příslušná oprávnění.

• Identifikátor spuštění není platný.

• Spuštění již bylo zahájeno nebo již bylo dokončeno; spouštění je možné spustit pouze jednou.

• Odkaz na prostředí přidružený k projektu není platný.

• Požadované hodnoty parametrů nebyly nastaveny.

• Verze projektu přidružená k instanci spuštění je zastaralá; Lze spustit pouze nejnovější verzi projektu.