catalog.start_execution (baza danych SSISDB)

Artykuł
2025-03-05

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

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

Składnia

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

Argumenty

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

[@retry_count =] retry_count
Liczba ponownych prób, jeśli wykonanie zakończy się niepowodzeniem. Ma to wpływ tylko wtedy, gdy wykonanie jest skalowane w poziomie. Ten parametr jest opcjonalny. Jeśli nie zostanie określony, jego wartość jest ustawiona na 0. retry_count jest int.

Uwagi

Wykonanie służy do określania wartości parametrów używanych przez pakiet podczas pojedynczego wystąpienia wykonywania pakietu. Po utworzeniu wystąpienia wykonania, zanim zostanie ono uruchomione, odpowiedni projekt może zostać wdrożony ponownie. W takim przypadku wystąpienie wykonywania odwołuje się do projektu, który jest nieaktualny. To nieprawidłowe odwołanie powoduje niepowodzenie procedury składowanej.

Nuta

Wykonywanie można uruchamiać tylko raz. Aby uruchomić wystąpienie wykonywania, musi on znajdować się w stanie utworzenia (wartość 1 w kolumnie stanu widoku catalog. operations).

Przykład

Poniższy przykład wywołuje catalog.create_execution, aby utworzyć wystąpienie wykonania dla pakietu Child1.dtsx. 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 MODYFIKOWANIa dotyczące wystąpienia wykonywania, 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

Błędy i ostrzeżenia

Na poniższej liście opisano niektóre warunki, które mogą zgłaszać błąd lub ostrzeżenie:

Użytkownik nie ma odpowiednich uprawnień
Identyfikator wykonywania jest nieprawidłowy
Wykonanie zostało już uruchomione lub zostało już ukończone; wykonywanie można uruchamiać tylko raz
Odwołanie do środowiska skojarzone z projektem jest nieprawidłowe
Nie ustawiono wymaganych wartości parametrów
Wersja projektu skojarzona z wystąpieniem wykonania jest nieaktualna; można wykonać tylko najnowszą wersję projektu

Udostępnij za pośrednictwem