catalog.create_execution (SSISDB-Datenbank)
Erstellt eine Instanz der Ausführung im Integration Services-Katalog.
Diese gespeicherte Prozedur verwendet den Standardserverprotokolliergrad.
Syntax
create_execution [ @folder_name = folder_name
, [ @project_name = ] project_name
, [ @package_name = ] package_name
[ , [ @reference_id = ] reference_id ]
[ , [ @use32bitruntime = ] use32bitruntime ]
, [ @execution_id = ] execution_id OUTPUT
Argumente
[ @folder\_name = ] folder_name
Der Name des Ordners mit dem Paket, das ausgeführt werden soll. Der folder_name ist nvarchar(128).[ @project\_name = ] project_name
Der Name des Projekts mit dem Paket, das ausgeführt werden soll. Der project_name ist nvarchar(128).[ @package\_name = ] package_name
Der Name des Pakets, das ausgeführt werden soll. Der package_name ist nvarchar(260).[ @reference\_id = ] reference_id
Ein eindeutiger Bezeichner für einen Umgebungsverweis. Dieser Parameter ist optional. Die reference_id ist bigint.[ @use32bitruntime = ] use32bitruntime
Gibt an, ob die 32-Bit-Laufzeit verwendet werden soll, um das Paket unter einem 64-Bit-Betriebssystem auszuführen. Verwenden Sie den Wert 1, um das Paket mit der 32-Bit-Laufzeit auszuführen, wenn die Ausführung unter einem 64-Bit-Betriebssystem erfolgt. Verwenden Sie den Wert 0, um das Paket mit der 64-Bit-Laufzeit auszuführen, wenn die Ausführung unter einem 64-Bit-Betriebssystem erfolgt. Dieser Parameter ist optional. Use32bitruntime ist bit.[ @execution\_id = ] execution_id
Gibt den eindeutigen Bezeichner für eine Ausführungsinstanz zurück. execution_id ist bigint.
Hinweise
Eine Ausführung wird verwendet, um die Parameterwerte anzugeben, die von einem Paket während einer einzelnen Instanz der Paketausführung verwendet werden.
Wenn ein Umgebungsverweis mit dem reference_id-Parameter angegeben wird, füllt die gespeicherte Prozedur den Projekt- und Paketparameter mit Literalwerten oder Werten, auf die verwiesen wird, der entsprechenden Umgebungsvariablen auf. Wird ein Umgebungsverweis angegeben, werden bei der Paketausführung Standardparameterwerte verwendet. Um genau zu bestimmen, welche Werte für eine bestimmte Ausführungsinstanz verwendet werden, verwenden Sie den execution_id-Ausgabeparameterwert dieser gespeicherten Prozedur, und fragen Sie die Sicht execution_parameter_values ab.
In einer Ausführung können nur Pakete angegeben werden, die als Einstiegspunktpakete gekennzeichnet sind. Wenn ein Paket angegeben wird, das kein Einstiegspunkt ist, schlägt die Ausführung fehl.
Beispiel
Im folgenden Beispiel wird catalog.create_execution aufgerufen, um eine Ausführungsinstanz für das Paket Child1.dtsx zu erstellen. Das Paket ist in Integration Services Projekt1 enthalten. Im Beispiel wird catalog.set_execution_parameter_value aufgerufen, um Werte für die Parameter Parameter1, Parameter2 und LOGGING_LEVEL festzulegen. Im Beispiel wird catalog.start_execution aufgerufen, um eine Instanz der Ausführung zu starten.
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ückgabecodewert
0 (Erfolg)
Resultsets
Keine
Berechtigungen
Diese gespeicherte Prozedur erfordert eine der folgenden Berechtigungen:
READ- und EXECUTE-Berechtigungen für das Projekt und ggf. READ-Berechtigungen für die Umgebung, auf die verwiesen wird
Mitgliedschaft in der Datenbankrolle ssis_admin
Mitgliedschaft in der Serverrolle sysadmin
Fehler und Warnungen
In der folgenden Liste werden einige Bedingungen beschrieben, die möglicherweise einen Fehler oder eine Warnung auslösen:
Das Paket ist nicht vorhanden.
Der Benutzer verfügt nicht über die entsprechenden Berechtigungen.
Der Umgebungsverweis reference_id ist nicht gültig.
Das angegebene Paket ist kein Einstiegspunktpaket.
Der Datentyp der Umgebungsvariablen, auf die verwiesen wird, unterscheidet sich vom Datentyp des Projekt- oder Paketparameters.
Das Projekt oder Paket enthält Parameter, die Werte erfordern, es wurden aber keine Werte zugewiesen.
Die Umgebungsvariablen, auf die verwiesen wird, werden in der Umgebung, die vom Umgebungsverweis reference_id angegeben wird, nicht gefunden.