Freigeben über

catalog.set_execution_parameter_value (SSISDB-Datenbank)

  • Artikel

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.
Zu den benutzerdefinierten Ereignissen zählen auch von Integration Services-Tasks protokollierte Ereignisse. Weitere Informationen finden Sie unter Benutzerdefinierte Meldungen für die Protokollierung.

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)

Konzepte

Generieren von Dumpdateien für die Paketausführung