catalog.start_execution (SSISDB-Datenbank)catalog.start_execution (SSISDB Database)

DIESES THEMA GILT FÜR: jaSQL Server (ab 2012)neinAzure SQL-DatenbankneinAzure SQL Data Warehouse neinParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Startet eine Instanz der Ausführung im Integration ServicesIntegration Services-Katalog.Starts an instance of execution in the Integration ServicesIntegration Services catalog.

SyntaxSyntax

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

ArgumenteArguments

[@execution_id =] execution_id[@execution_id =] execution_id
Der eindeutige Bezeichner für die Instanz der Ausführung.The unique identifier for the instance of execution. Der execution_id ist bigint.The execution_id is bigint.

[@retry_count =] retry_count[@retry_count =] retry_count
Die Anzahl von Wiederholungsversuchen, wenn bei der Ausführung ein Fehler auftritt.The retry count if the execution fails. Dieses Argument wird nur wirksam, wenn die Ausführung in Scale Out erfolgt. Dieser Parameter ist optional.It takes effect only if the execution is in Scale Out. This parameter is optional. Wenn es nicht angegeben wird, wird der Wert auf 0 festgelegt.If not specified, its value is set to 0. Das Argument retry_count ist vom Typ Int.The retry_count is int.

RemarksRemarks

Eine Ausführung wird verwendet, um die Parameterwerte anzugeben, die von einem Paket während einer einzelnen Instanz der Paketausführung verwendet werden.An execution is used to specify the parameter values that is used by a package during a single instance of package execution. Nachdem eine Instanz der Ausführung erstellt wurde, wird möglicherweise das entsprechende Projekt erneut bereitgestellt, bevor die Instanz gestartet wurde.After an instance of execution has been created, before it has been started, the corresponding project might be redeployed. In diesem Fall verweist die Instanz der Ausführung auf ein veraltetes Projekt.In this case, the instance of execution references a project that is outdated. Dieser ungültige Verweis führt dazu, dass bei der gespeicherten Prozedur ein Fehler auftritt.This invalid reference causes the stored procedure to fail.

Hinweis

Ausführungen können nur einmal gestartet werden.Executions can only be started once. Um eine Instanz der Ausführung zu starten, muss sie den Zustand „Erstellt“ (ein Wert 1 in der Spalte status der Sicht catalog.operations) aufweisen.To start an instance of execution, it must be in the created state (a value of 1 in the status column of the catalog.operations view).

BeispielExample

Im folgenden Beispiel wird catalog.create_execution aufgerufen, um eine Ausführungsinstanz für das Paket Child1.dtsx zu erstellen.The following example calls catalog.create_execution to create an instance of execution for the Child1.dtsx package. Das Paket ist in Integration Services Projekt1 enthalten.Integration Services Project1 contains the package. Im Beispiel wird catalog.set_execution_parameter_value aufgerufen, um Werte für die Parameter Parameter1, Parameter2 und LOGGING_LEVEL festzulegen.The example calls catalog.set_execution_parameter_value to set values for the Parameter1, Parameter2, and LOGGING_LEVEL parameters. Im Beispiel wird catalog.start_execution aufgerufen, um eine Instanz der Ausführung zu starten.The example calls catalog.start_execution to start an instance of execution.

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  

RückgabecodewertReturn Code Value

0 (Erfolg)0 (success)

ResultsetsResult Sets

InclusionThresholdSettingNone

BerechtigungenPermissions

Diese gespeicherte Prozedur erfordert eine der folgenden Berechtigungen:This stored procedure requires one of the following permissions:

  • READ-Berechtigung und MODIFY-Berechtigung für die Instanz der Ausführung, READ-Berechtigung und EXECUTE-Berechtigung für das Projekt und ggf. READ-Berechtigungen für die Umgebung, auf die verwiesen wirdREAD and MODIFY permissions on the instance of execution, READ and EXECUTE permissions on the project, and if applicable, READ permissions on the referenced environment

  • Mitgliedschaft in der Datenbankrolle ssis_adminMembership to the ssis_admin database role

  • Mitgliedschaft in der Serverrolle sysadminMembership to the sysadmin server role

Fehler und WarnungenErrors and Warnings

In der folgenden Liste werden einige Bedingungen beschrieben, die möglicherweise einen Fehler oder eine Warnung auslösen:The following list describes some conditions that may raise an error or warning:

  • Der Benutzer verfügt nicht über die entsprechenden Berechtigungen.The user does not have the appropriate permissions

  • Der Ausführungsbezeichner ist ungültig.The execution identifier is not valid

  • Die Ausführung wurde bereits gestartet oder bereits abgeschlossen. Ausführungen können nur einmal gestartet werden.The execution has already been started, or it has already been completed; executions can be started only once

  • Der dem Projekt zugeordnete Umgebungsverweis ist ungültig.The environment reference associated with the project is not valid

  • Erforderliche Parameterwerte wurden nicht festgelegt.Required parameter values have not been set

  • Die der Instanz der Ausführung zugeordnete Projektversion ist veraltet. Es kann nur die aktuelle Version eines Projekts ausgeführt werden.The project version associated with the instance of execution is outdated; only the most current version of a project can be executed