catalog.create_execution (baza danych SSISDB)

Artykuł
2025-03-05

Dotyczy:sql Server SSIS Integration Runtime w usłudze Azure Data Factory

Tworzy wystąpienie wykonywania w katalogu usług Integration Services.

Ta procedura składowana używa domyślnego poziomu rejestrowania serwera.

Składnia

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
Nazwa folderu zawierającego pakiet, który ma zostać wykonany. folder_name to nvarchar(128).

[@project_name =] project_name
Nazwa projektu, który zawiera pakiet, który ma zostać wykonany. project_name jest nvarchar(128).

[@package_name =] package_name
Nazwa pakietu, który ma zostać wykonany. package_name jest nvarchar(260).

[@reference_id =] reference_id
Unikatowy identyfikator odwołania do środowiska. Ten parametr jest opcjonalny. reference_id jest bigint.

[@use32bitruntime =] use32bitruntime
Wskazuje, czy 32-bitowe środowisko uruchomieniowe powinno być używane do uruchamiania pakietu w 64-bitowym systemie operacyjnym. Użyj wartości 1, aby wykonać pakiet ze środowiskiem uruchomieniowym 32-bitowym podczas uruchamiania w 64-bitowym systemie operacyjnym. Użyj wartości 0, aby wykonać pakiet ze środowiskiem uruchomieniowym 64-bitowym podczas uruchamiania w 64-bitowym systemie operacyjnym. Ten parametr jest opcjonalny. Use32bitruntime jest bit.

[@runinscaleout =] runinscaleout
Wskazuje, czy wykonywanie jest skalowane w poziomie. Użyj wartości 1, aby wykonać pakiet w obszarze Skalowanie w poziomie. Użyj wartości 0, aby wykonać pakiet bez skalowania w poziomie. Ten parametr jest opcjonalny. Jeśli nie zostanie określony, jego wartość jest ustawiona na DEFAULT_EXECUTION_MODE w [SSISDB]. [wykaz]. [catalog_properties]. runinscaleout jest bit.

[@useanyworker =] useanyworker
Określ, czy dowolny proces roboczy skalowania w poziomie może wykonać wykonanie.

Użyj wartości 1, aby wykonać pakiet przy użyciu dowolnego procesu roboczego skalowania w poziomie. Po ustawieniu @useanyworker wartości true każdy proces roboczy, którego maksymalna liczba zadań (określona w pliku konfiguracji procesu roboczego) nie zostanie jeszcze osiągnięta, będzie dostępna do uruchomienia pakietu. Aby uzyskać informacje o pliku konfiguracji procesu roboczego, zobacz Integration Services (SSIS) Scale Out Worker.
Użyj wartości 0, aby wskazać, że nie wszystkie procesy robocze skalowania w poziomie mogą wykonywać pakiet. Po ustawieniu @useanyworker na wartość false należy określić procesy robocze, które mogą uruchamiać pakiet przy użyciu menedżera skalowania w poziomie lub wywołując procedurę składowaną [catalog].[add_execution_worker]. Jeśli określisz proces roboczy, który jest już uruchomiony inny pakiet, proces roboczy zakończy uruchamianie bieżącego pakietu, zanim zażąda wykonania innego.

Ten parametr jest opcjonalny. Jeśli nie zostanie określony, jego wartość jest ustawiona na 1. useanyworker jest bit.

[@execution_id =] execution_id
Zwraca unikatowy identyfikator wystąpienia wykonania. execution_id jest bigint.

Uwagi

Wykonanie służy do określania wartości parametrów używanych przez pakiet podczas pojedynczego wystąpienia wykonywania pakietu.

Jeśli odwołanie do środowiska zostanie określone przy użyciu parametru reference_id, procedura składowana wypełnia parametry projektu i pakietu wartościami literału lub przywołynymi wartościami z odpowiednich zmiennych środowiskowych. Jeśli określono odwołanie do środowiska, domyślne wartości parametrów są używane podczas wykonywania pakietu. Aby określić dokładnie, które wartości są używane dla określonego wystąpienia wykonywania, użyj wartości parametru wyjściowego execution_id z tej procedury składowanej i wykonaj zapytanie w widoku execution_parameter_values.

W wykonaniu można określić tylko pakiety punktów wejścia, które są oznaczone jako pakiety punktu wejścia. Jeśli określono pakiet, który nie jest punktem wejścia, wykonanie zakończy się niepowodzeniem.

Przykład

Poniższy przykład wywołuje catalog.create_execution, aby utworzyć wystąpienie wykonania dla pakietu Child1.dtsx, który nie znajduje się w obszarze Skalowanie w poziomie. Usługa Integration Services Project1 zawiera pakiet. Przykład wywołuje catalog.set_execution_parameter_value, aby ustawić wartości parametrów Parameter1, Parameter2 i LOGGING_LEVEL. Przykład wywołuje catalog.start_execution, aby uruchomić wystąpienie wykonywania.

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

Zwracana wartość kodu

0 (powodzenie)

Zestawy wyników

Żaden

Uprawnienia

Ta procedura składowana wymaga jednego z następujących uprawnień:

Uprawnienia DO ODCZYTU i WYKONYWANIA w projekcie oraz, jeśli ma to zastosowanie, uprawnienia DO ODCZYTU w środowisku, do których się odwołujesz
Członkostwo w roli bazy danych ssis_admin
Członkostwo w roli serwera sysadmin

Jeśli @runinscaleout ma wartość 1, procedura składowana wymaga jednego z następujących uprawnień:

Członkostwo w roli bazy danych ssis_admin
Członkostwo w roli bazy danych ssis_cluster_executor
Członkostwo w roli serwera sysadmin

Błędy i ostrzeżenia

Poniższa lista zawiera opis niektórych warunków, które mogą zgłaszać błąd lub ostrzeżenie:

Pakiet nie istnieje.
Użytkownik nie ma odpowiednich uprawnień.
Odwołanie do środowiska, reference_id, jest nieprawidłowe.
Określony pakiet nie jest pakietem punktu wejścia.
Typ danych zmiennej środowiskowej, do których odwołuje się odwołanie, różni się od typu danych projektu lub parametru pakietu.
Projekt lub pakiet zawiera parametry wymagające wartości, ale nie przypisano żadnych wartości.
Nie można odnaleźć odwołanych zmiennych środowiskowych w środowisku, do którego odwołuje się środowisko, reference_id, określa.

Zobacz też

catalog.start_execution (baza danych SSISDB)
catalog.set_execution_parameter_value (baza danych SSISDB)
catalog.add_execution_worker (baza danych SSISDB)

Udostępnij za pośrednictwem