catalog.set_object_parameter_value (base de datos de SSISDB)

Establece el valor de un parámetro del catálogo de Integration Services. Asocia el valor a una variable de entorno o asigna un valor literal que se va a usar como valor predeterminado si no se asignan otros valores.

Sintaxis

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 ]

Argumentos

• [ @object\_type = ] object_type
  Tipo de parámetro. Use el valor 20 para indicar un parámetro de proyecto o el valor 30 para indicar un parámetro de paquete. El parámetro object_type es de tipo smallInt.

• [ @folder\_name = ] folder_name
  Nombre de la carpeta que contiene el parámetro. El parámetro folder_name es de tipo nvarchar(128).

• [ @project\_name = ] project_name
  Nombre del proyecto que contiene el parámetro. El parámetro project_name es de tipo nvarchar(128).

• [ @parameter\_name = ] parameter_name
  Nombre del parámetro. El parámetro parameter_name es de tipo nvarchar(128).

• [ @parameter\_value = ] parameter_value
  Valor del parámetro. El parámetro parameter_value es de tipo sql_variant.

• [ @object\_name = ] object_name
  Nombre del paquete. Este argumento es necesario cuando el parámetro es un parámetro de paquete. El parámetro object_name es de tipo nvarchar(260).

• [ @value\_type = ] value_type
  Tipo de valor del parámetro. Use el carácter V para indicar que parameter_value es un valor literal que se usa de forma predeterminada cuando no hay otros valores asignados antes de la ejecución. Use el carácter R para indicar que parameter_value es un valor al que se hace referencia y que se ha establecido en el nombre de una variable de entorno. Este argumento es opcional; de forma predeterminada, se usa el carácter V. El parámetro value_type es de tipo char(1).

Valor del código de retorno

0 (correcto)

Conjuntos de resultados

Ninguno

Permisos

Este procedimiento almacenado necesita uno de los siguientes permisos:

• Permisos READ y MODIFY en el proyecto

• Pertenencia al rol de base de datos ssis_admin

• Pertenencia al rol de servidor sysadmin

Errores y advertencias

En la lista siguiente se describen algunas condiciones que pueden hacer que el procedimiento almacenado produzca un error:

• El tipo de parámetro no es válido

• El nombre de proyecto no es válido

• En los parámetros de paquete, el nombre del paquete no es válido

• El tipo de valor no es válido.

• El usuario no tiene los permisos apropiados

Comentarios

• Si no se especifica value_type, se usa un valor literal parameter_value de forma predeterminada. Cuando se usa un valor literal, el objeto value_set de la vista object_parameters se establece en 1. No se permiten valores de parámetro NULL.

• Si value_type contiene el carácter R, que denota un valor de referencia, parameter_value hace referencia al nombre de una variable de entorno.

• El valor 20 se puede usar para que object_type denote un parámetro de proyecto. En este caso, un valor de object_name no es necesario, y cualquier valor especificado para object_name se omite. Este valor se usa cuando el usuario desea establecer un parámetro de proyecto.

• El valor 30 se puede usar para que object_type denote un parámetro de paquete. En este caso, se usa un valor de object_name para denotar el paquete correspondiente. Si no se especifica object_name, el procedimiento almacenado devuelve un error y finaliza.