catalog.set_execution_parameter_value (SSISDB-Datenbank)

Artikel
05/23/2023

Gilt für:SQL Server SSIS Integration Runtime in Azure Data Factory

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

catalog.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. Der execution_id ist bigint.

[ @object_type = ] object_type
Der Typ des Parameters.

Legen Sie für die folgenden Parameter object_type auf „50“ fest.

LOGGING_LEVEL
CUSTOMIZED_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.

object_type ist vom Typ 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.

Legen Sie den object_type-Parameter auf „50“ fest.

Wert	BESCHREIBUNG
0	Keine Die Protokollierung ist deaktiviert. Nur der Status der Ausführung von Paketen wird protokolliert.
1	Basic 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. Zu den benutzerdefinierten Ereignissen zählen auch von Integration Services-Tasks protokollierte Ereignisse. Weitere Informationen finden Sie unter Benutzerdefinierte Meldungen für die Protokollierung.
4	Runtimeherkunft Sammelt die Daten, die zum Nachverfolgen der Datenherkunft im Datenfluss benötigt werden.
100	Benutzerdefinierter Protokolliergrad Legen Sie die Einstellungen im CUSTOMIZED_LOGGING_LEVEL-Parameter fest. Weitere Informationen zu den Werten, die Sie angeben können, finden Sie unter 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.

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.

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

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.

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

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. 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

Beispiele

A. Generieren von Sicherungsdateien bei Fehlern

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

B. Generieren von Sicherungsdateien bei Ereignissen

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.

Weitere Informationen

catalog.execution_parameter_values (SSISDB-Datenbank)
Generieren von Dumpdateien für die Paketausführung