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

GILT FÜR: jaSQL Server, einschließlich unter Linux jaAzure SQL-DatenbankjaAzure SQL Data Warehouse neinParallel Data WarehouseAPPLIES TO: yesSQL Server, including on Linux yesAzure SQL Database yesAzure SQL Data Warehouse noParallel Data Warehouse

GILT FÜR: jaSQL Server neinAzure SQL-DatenbankneinAzure SQL Data Warehouse neinParallel Data WarehouseAPPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Legt den Wert eines Parameters für eine Instanz der Ausführung im Integration ServicesIntegration Services -Katalog fest.Sets the value of a parameter for an instance of execution in the Integration ServicesIntegration Services catalog.

Ein Parameterwert kann nicht geändert werden, nachdem eine Instanz der Ausführung gestartet wurde.A parameter value cannot be changed after an instance of execution has started.

SyntaxSyntax

catalog.set_execution_parameter_value [ @execution_id = execution_id  
    , [ @object_type = ] object_type  
    , [ @parameter_name = ] parameter_name  
    , [ @parameter_value = ] parameter_value  

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.

[ @object_type = ] object_type[ @object_type = ] object_type
Der Typ des Parameters.The type of parameter.

Legen Sie für die folgenden Parameter object_type auf „50“ fest.For the following parameters, set object_type to 50

  • LOGGING_LEVELLOGGING_LEVEL

  • CUSTOMIZED_LOGGING_LEVELCUSTOMIZED_LOGGING_LEVEL

  • DUMP_ON_ERRORDUMP_ON_ERROR

  • DUMP_ON_EVENTDUMP_ON_EVENT

  • DUMP_EVENT_CODEDUMP_EVENT_CODE

  • CALLER_INFOCALLER_INFO

  • SYNCHRONIZEDSYNCHRONIZED

Verwenden Sie den Wert 20 , um einen Projektparameter anzugeben, oder den Wert 30 , um einen Paketparameter anzugeben.Use the value 20 to indicate a project parameter or the value 30 to indicate a package parameter.

object_type ist vom Typ smallInt.The object_type is smallint.

[ @parameter_name = ] parameter_name[ @parameter_name = ] parameter_name
Der Name des Parameters.The name of the parameter. Der parameter_name ist nvarchar(128) .The parameter_name is nvarchar(128).

[ @parameter_value = ] parameter_value[ @parameter_value = ] parameter_value
Der Wert des Parameters.The value of the parameter. Der parameter_value ist sql_variant.The parameter_value is sql_variant.

RemarksRemarks

Um die Parameterwerte zu ermitteln, die für eine bestimmte Ausführung verwendet wurden, fragen Sie die catalog.execution_parameter_values-Sicht ab.To find out the parameter values that were used for a given execution, query the catalog.execution_parameter_values view.

Um den Umfang der Informationen anzugeben, die während einer Paketausführung protokolliert werden, legen Sie parameter_name auf LOGGING_LEVEL und parameter_value auf einen der folgenden Werte fest.To specify the scope of information that is logged during a package execution, set parameter_name to LOGGING_LEVEL and set parameter_value to one of the following values.

Legen Sie den object_type-Parameter auf „50“ fest.Set the object_type parameter to 50.

valueValue und BeschreibungDescription
00 NoneNone

Die Protokollierung ist deaktiviert.Logging is turned off. Nur der Status der Ausführung von Paketen wird protokolliert.Only the package execution status is logged.
11 StandardBasic

Alle Ereignisse werden protokolliert, außer benutzerdefinierten und Diagnose-Ereignissen.All events are logged, except custom and diagnostic events. Dies ist der Standardwert.This is the default value.
22 LeistungPerformance

Nur Leistungsstatistiken sowie OnError- und OnWarning-Ereignisse werden protokolliert.Only performance statistics, and OnError and OnWarning events, are logged.
33 AusführlichVerbose

Alle Ereignisse werden protokolliert, einschließlich benutzerdefinierter Ereignisse und Diagnose-Ereignissen.All events are logged, including custom and diagnostic events.
Zu den benutzerdefinierten Ereignissen zählen auch von Integration Services-Tasks protokollierte Ereignisse.Custom events include those events that are logged by Integration Services tasks. Weitere Informationen finden Sie unter Benutzerdefinierte Meldungen für die Protokollierung.For more information, see Custom Messages for Logging
44 RuntimeherkunftRuntime lineage

Sammelt die Daten, die zum Nachverfolgen der Datenherkunft im Datenfluss benötigt werden.Collects the data required to track lineage in the data flow.
100100 Benutzerdefinierter ProtokolliergradCustom logging level

Legen Sie die Einstellungen im CUSTOMIZED_LOGGING_LEVEL-Parameter fest.Specify the settings in the CUSTOMIZED_LOGGING_LEVEL parameter. Weitere Informationen zu den Werten, die Sie angeben können, finden Sie unter catalog.create_customized_logging_level.For more info about the values that you can specify, see catalog.create_customized_logging_level.

Weitere Informationen zu benutzerdefinierten Protokolliergraden finden Sie unter Aktivieren der Protokollierung für die Paketausführung auf dem SSIS-Server.For more info about customized logging levels, see Enable Logging for Package Execution on the SSIS Server.

Wenn Sie festlegen möchten, dass der Integration Services-Server Dumpdateien generiert, wenn während einer Paketausführung ein Fehler auftritt, legen Sie die folgenden Parameterwerte für eine Ausführungsinstanz fest, die nicht ausgeführt wurde.To specify that the Integration Services server generates dump files when any error occurs during a package execution, set the following parameter values for an execution instance that hasn't run.

ParameterParameter valueValue
execution_idexecution_id Der eindeutige Bezeichner für die Instanz der AusführungThe unique identifier for the instance of execution
object_typeobject_type 5050
parameter_nameparameter_name 'DUMP_ON_ERROR'DUMP_ON_ERROR
parameter_valueparameter_value 11

Wenn Sie festlegen möchten, dass der Integration Services-Server Dumpdateien generiert, wenn während einer Paketausführung Ereignisse auftreten, legen Sie die folgenden Parameterwerte für eine Ausführungsinstanz fest, die nicht ausgeführt wurde.To specify that the Integration Services server generates dump files when events occur during a package execution, set the following parameter values for an execution instance that hasn't run.

ParameterParameter valueValue
execution_idexecution_id Der eindeutige Bezeichner für die Instanz der AusführungThe unique identifier for the instance of execution
object_typeobject_type 5050
parameter_nameparameter_name 'DUMP_ON_EVENT'DUMP_ON_EVENT
parameter_valueparameter_value 11

Wenn Sie die während einer Paketausführung auftretenden Ereignisse festlegen möchten, die Integration Services-Server zum Generieren von Dumpdateien veranlassen, legen Sie die folgenden Parameterwerte für eine Ausführungsinstanz fest, die nicht ausgeführt wurde.To specify the events during package execution that cause the Integration Services server to generate dump files, set the following parameter values for an execution instance that hasn't run. Trennen Sie mehrere Ereigniscodes mithilfe eines Semikolons.Separate multiple event codes using a semi-colon.

ParameterParameter valueValue
execution_idexecution_id Der eindeutige Bezeichner für die Instanz der AusführungThe unique identifier for the instance of execution
object_typeobject_type 5050
parameter_nameparameter_name DUMP_EVENT_CODEDUMP_EVENT_CODE
parameter_valueparameter_value Ein oder mehrere EreigniscodesOne or more event codes

BeispielExample

Im folgenden Beispiel wird angegeben, dass der Integration Services-Server Dumpdateien generiert, wenn während einer Paketausführung ein Fehler auftritt.The following example specifies that the Integration Services server generates dump files when any error occurs during a package execution.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_ERROR',1  

BeispielExample

Im folgenden Beispiel wird angegeben, dass der Integration Services-Server Dumpdateien generiert, wenn während einer Paketausführung Ereignisse auftreten. Zudem wird das Ereignis angegeben, das den Server zum Generieren der Dateien veranlasst.The following example specifies that the Integration Services server generates dump files when events occur during a package execution, and specifies the event that causes the server to generate the files.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_EVENT',1  
  
declare @event_code nvarchar(50)  
set @event_code = '0xC020801C'  
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_EVENT_CODE', @event_code  

RückgabecodewertReturn Code Value

0 (Erfolg)0 (success)

ResultsetsResult Sets

NoneNone

BerechtigungenPermissions

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

  • READ- und MODIFY-Berechtigungen für die Instanz der AusführungREAD and MODIFY permissions on the instance of execution

  • 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

  • Der Parametername ist ungültig.The parameter name is not valid

  • Der Datentyp des Parameterwerts stimmt nicht mit dem Datentyp des Parameters überein.The data type of the parameter value does not match the data type of the parameter

Weitere InformationenSee Also

catalog.execution_parameter_values (SSISDB-Datenbank) catalog.execution_parameter_values (SSISDB Database)
Generieren von Dumpdateien für die PaketausführungGenerating Dump Files for Package Execution