catalog.create_execution (databáze SSISDB)

Článek
2025-03-05

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

platí pro:SQL Server

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

Tato uložená procedura používá výchozí úroveň protokolování serveru.

Syntax

catalog.create_execution [ @folder_name = ] folder_name  
     , [ @project_name = ] project_name  
     , [ @package_name = ] package_name  
  [  , [ @reference_id = ] reference_id ]  
  [  , [ @use32bitruntime = ] use32bitruntime ] 
  [  , [ @runinscaleout = ] runinscaleout ]
  [  , [ @useanyworker = ] useanyworker ] 
     , [ @execution_id = ] execution_id OUTPUT

Argumenty

[@folder_name =] folder_name
Název složky, která obsahuje balíček, který se má spustit. folder_name je nvarchar(128).

[@project_name =] project_name
Název projektu, který obsahuje balíček, který se má spustit. project_name je nvarchar(128).

[@package_name =] package_name
Název balíčku, který se má spustit. package_name je nvarchar(260).

[@reference_id =] reference_id
Jedinečný identifikátor odkazu na prostředí. Tento parametr je volitelný. reference_id je bigint.

[@use32bitruntime =] použít 32bitruntime
Označuje, jestli má být 32bitový modul runtime použit ke spuštění balíčku v 64bitovém operačním systému. Pomocí hodnoty 1 spusťte balíček s 32bitovým modulem runtime při spuštění v 64bitovém operačním systému. Pomocí hodnoty 0 spusťte balíček s 64bitovým modulem runtime při spuštění v 64bitovém operačním systému. Tento parametr je volitelný. Use32bitruntime je bit.

[@runinscaleout =] runinscaleout
Určete, jestli je provádění ve horizontálním navýšení kapacity. Pomocí hodnoty 1 spusťte balíček ve horizontálním navýšení kapacity. Pomocí hodnoty 0 spusťte balíček bez horizontálního navýšení kapacity. Tento parametr je volitelný. Pokud není zadána, jeho hodnota je nastavena na DEFAULT_EXECUTION_MODE v databázi [SSISDB]. [katalog]. [catalog_properties]. runinscaleout je bit.

[@useanyworker =] useanyworker
Určete, jestli má některý pracovní proces horizontálního navýšení kapacity povoleno provádění.

Pomocí hodnoty 1 spusťte balíček s libovolným pracovním procesem horizontálního navýšení kapacity. Když nastavíte @useanyworker na hodnotu true, není k dispozici pro spuštění balíčku jakýkoli pracovní proces, jehož maximální počet úkolů (jak je uvedeno v konfiguračním souboru pracovního procesu). Informace o konfiguračním souboru pracovního procesu najdete v tématu SSIS (Scale Out Worker).
Pomocí hodnoty 0 označte, že ne všechny pracovní procesy se škálováním na více systémů smí balíček spouštět. Když nastavíte @useanyworker na false, musíte určit pracovní procesy, které mají povoleno spouštět balíček pomocí Správce škálování na více systémů nebo voláním uložené procedury [catalog].[add_execution_worker]. Pokud zadáte pracovní proces, který už používá jiný balíček, pracovní proces dokončí spuštění aktuálního balíčku předtím, než požádá o další spuštění.

Tento parametr je volitelný. Pokud není zadáno, jeho hodnota je nastavena na hodnotu 1. useanyworker je bit.

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

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.

Pokud je odkaz na prostředí zadán parametrem reference_id, uložená procedura naplní parametry projektu a balíčku literálními hodnotami nebo odkazovanými hodnotami z odpovídajících proměnných prostředí. Pokud je zadán odkaz na prostředí, výchozí hodnoty parametrů se použijí během provádění balíčku. Pokud chcete přesně určit, které hodnoty se používají pro konkrétní instanci spuštění, použijte hodnotu výstupního parametru execution_id z této uložené procedury a dotazujte execution_parameter_values zobrazení.

Ke spuštění je možné zadat pouze balíčky, které jsou označené jako balíčky vstupního bodu. Pokud je zadaný balíček, který není vstupním bodem, spuštění selže.

Příklad

Následující příklad volá catalog.create_execution vytvořit instanci spuštění pro balíček Child1.dtsx, který není ve horizontálním navýšení kapacity. 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 EXECUTE pro projekt a v případě potřeby oprávnění KE ČTENÍ v odkazovaném prostředí
Členství v roli databáze ssis_admin
Členství v roli serveru správce systému

Pokud je @runinscaleout 1, uložená procedura vyžaduje jedno z následujících oprávnění:

Členství v roli databáze ssis_admin
Členství v roli databáze ssis_cluster_executor
Členství v roli serveru správce systému

Chyby a upozornění

Následující seznam popisuje některé podmínky, které můžou vyvolat chybu nebo upozornění:

Balíček neexistuje.
Uživatel nemá příslušná oprávnění.
Odkaz na prostředí reference_idnení platný.
Zadaný balíček není vstupním bodem.
Datový typ odkazované proměnné prostředí se liší od datového typu projektu nebo parametru balíčku.
Projekt nebo balíček obsahuje parametry, které vyžadují hodnoty, ale nebyly přiřazeny žádné hodnoty.
Odkazované proměnné prostředí nelze najít v prostředí, které odkazuje na prostředí, reference_id, určuje.

Viz také

catalog.start_execution (databáze SSISDB)
catalog.set_execution_parameter_value (databáze SSISDB)
catalog.add_execution_worker (databáze SSISDB)

Sdílet prostřednictvím