catalog.set_object_parameter_value (SSISDB-Datenbank)

Artikel
05/07/2013

Legt den Wert eines Parameters im Integration Services-Katalog fest. Ordnet einer Umgebungsvariablen den Wert zu oder weist einen Literalwert zu, der standardmäßig verwendet wird, wenn keine anderen Werte zugewiesen werden.

Syntax

set_object_parameter_value [ @object_type = ] object_type 
    , [ @folder_name = ] folder_name 
    , [ @project_name = ] project_name 
    , [ @parameter_name = ] parameter _name 
    , [ @parameter_value = ] parameter_value 
 [  , [ @object_name = ] object_name ]
 [  , [ @value_type = ] value_type ]

Argumente

[ @object\_type = ] object_type
Der Typ des Parameters. Verwenden Sie den Wert 20, um einen Projektparameter anzugeben, oder den Wert 30, um einen Paketparameter anzugeben. Der object_type ist smallInt.
[ @folder\_name = ] folder_name
Der Name des Ordners, der den Parameter enthält. Der folder_name ist nvarchar(128).
[ @project\_name = ] project_name
Der Name des Projekts, das den Parameter enthält. Der project_name ist nvarchar(128).
[ @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.
[ @object\_name = ] object_name
Der Name des Pakets. Dieses Argument ist erforderlich, wenn der Parameter ein Paketparameter ist. Der object_name ist nvarchar(260).
[ @value\_type = ] value_type
Der Typ des Parameterwerts. Verwenden Sie das Zeichen V, um anzugeben, dass parameter_value ein Literalwert ist, der standardmäßig verwendet wird, wenn vor der Ausführung keine anderen Werte zugewiesen werden. Verwenden Sie das Zeichen R, um anzugeben, dass parameter_value ein Wert ist, auf den verwiesen wird und der auf den Namen einer Umgebungsvariablen festgelegt wurde. Dieses Argument ist optional. Das Zeichen V wird standardmäßig verwendet. Der value_type ist char(1).

Rückgabecodewert

0 (Erfolg)

Resultsets

Keine

Berechtigungen

Diese gespeicherte Prozedur erfordert eine der folgenden Berechtigungen:

READ-Berechtigung und MODIFY-Berechtigung für das Projekt
Mitgliedschaft in der Datenbankrolle ssis_admin
Mitgliedschaft in der Serverrolle sysadmin

Fehler und Warnungen

In der folgenden Liste werden Bedingungen beschrieben, die möglicherweise bewirken, dass die gespeicherte Prozedur einen Fehler auslöst:

Der Parametertyp ist ungültig.
Der Projektname ist ungültig.
Für Paketparameter ist der Paketname ungültig.
Der Werttyp ist ungültig.
Der Benutzer verfügt nicht über die entsprechenden Berechtigungen.

Hinweise

Wenn kein value_type angegeben ist, wird standardmäßig ein Literalwert für parameter_value verwendet. Wenn ein Literalwert verwendet wird, wird value_set in der object_parameters-Sicht auf 1 festgelegt. Ein NULL-Parameterwert ist nicht zulässig.
Wenn value_type das Zeichen R enthält, das einen Wert bezeichnet, auf den verwiesen wird, verweist parameter_value auf den Namen einer Umgebungsvariablen.
Für object_type kann der Wert 20 verwendet werden, um einen Projektparameter anzugeben. In diesem Fall ist für object_name kein Wert erforderlich, und jeder für object_name angegebene Wert wird ignoriert. Dieser Wert wird verwendet, wenn der Benutzer einen Projektparameter festlegen möchte.
Für object_type kann der Wert 30 verwendet werden, um einen Paketparameter anzugeben. In diesem Fall wird ein Wert für object_name verwendet, um das entsprechende Paket anzugeben. Wenn object_name nicht angegeben wird, gibt die gespeicherte Prozedur einen Fehler zurück und wird beendet.

Freigeben über