Freigeben über

catalog.set_execution_parameter_value (SSISDB-Datenbank)

  • Artikel

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

Gilt für: SQL Server

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