catalog.set_execution_parameter_value (SSISDB-Datenbank)
Legt den Wert eines Parameters für eine Instanz der Ausführung im Integration Services-Katalog fest.
Ein Parameterwert kann nicht geändert werden, nachdem eine Instanz der Ausführung gestartet wurde.
Syntax
set_execution_parameter_value [ @execution_id = execution_id
, [ @object_type = ] object_type
, [ @parameter_name = ] parameter_name
, [ @parameter_value = ] parameter_value
Argumente
[ @execution\_id = ] execution_id
Der eindeutige Bezeichner für die Instanz der Ausführung. execution_id ist bigint.[ @object\_type = ] object_type
Der Typ des Parameters.Für die folgenden Parameter object_type auf 50 festlegen.
LOGGING_LEVEL
DUMP_ON_ERROR
DUMP_ON_EVENT
DUMP_EVENT_CODE
CALLER_INFO
SYNCHRONIZED
Verwenden Sie den Wert 20, um einen Projektparameter anzugeben, oder den Wert 30, um einen Paketparameter anzugeben.
Der object_type ist smallint.
[ @parameter\_name = ] parameter_name
Der Name des Parameters. Der parameter_name ist nvarchar(128).[ @parameter\_value = ] parameter_value
Der Wert des Parameters. Der parameter_value ist sql_variant.
Hinweise
Um die Parameterwerte zu ermitteln, die für eine bestimmte Ausführung verwendet wurden, fragen Sie die catalog.execution_parameter_values-Sicht ab.
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.
Den object_type-Parameter auf 50 festlegen.
Wert |
Beschreibung |
|---|---|
0 |
Keine Die Protokollierung ist deaktiviert. Nur der Status der Ausführung von Paketen wird protokolliert. |
1 |
Grundlegend Alle Ereignisse werden protokolliert, außer benutzerdefinierten und Diagnose-Ereignissen. Dies ist der Standardwert. |
2 |
Leistung Nur Leistungsstatistiken sowie OnError- und OnWarning-Ereignisse werden protokolliert. |
3 |
Ausführlich Alle Ereignisse werden protokolliert, einschließlich benutzerdefinierter Ereignisse und Diagnose-Ereignissen. |
Um festzulegen, 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.
Parameter |
Wert |
|---|---|
execution_id |
Der eindeutige Bezeichner für die Instanz der Ausführung |
object_type |
50 |
parameter_name |
‘DUMP_ON_ERROR |
parameter_value |
1 |
Um festzulegen, 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.
Parameter |
Wert |
|---|---|
execution_id |
Der eindeutige Bezeichner für die Instanz der Ausführung |
object_type |
50 |
parameter_name |
‘DUMP_ON_EVENT |
parameter_value |
1 |
Um die während einer Paketausführung auftretenden Ereignisse festzulegen, 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. Trennen Sie mehrere Ereigniscodes mithilfe eines Semikolons.
Parameter |
Wert |
|---|---|
execution_id |
Der eindeutige Bezeichner für die Instanz der Ausführung |
object_type |
50 |
parameter_name |
DUMP_EVENT_CODE |
parameter_value |
Ein oder mehrere Ereigniscodes |
Beispiel
Im folgenden Beispiel wird angegeben, dass der Integration Services-Server Dumpdateien generiert, wenn während einer Paketausführung ein Fehler auftritt.
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
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.
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ückgabecodewert
0 (Erfolg)
Resultsets
Keine
Berechtigungen
Diese gespeicherte Prozedur erfordert eine der folgenden Berechtigungen:
READ- und MODIFY-Berechtigungen für die Instanz der Ausführung
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:
Der Benutzer verfügt nicht über die entsprechenden Berechtigungen.
Der Ausführungsbezeichner ist ungültig.
Der Parametername ist ungültig.
Der Datentyp des Parameterwerts stimmt nicht mit dem Datentyp des Parameters überein.
Siehe auch
Verweis
catalog.execution_parameter_values (SSISDB-Datenbank)