catalog.set_environment_reference_type (base de datos SSISDB)

Establece el tipo de referencia y el nombre del entorno asociados con una referencia de entorno existente para un proyecto en el catálogo de Integration Services.

Sintaxis

set_environment_reference_location [ @reference_id = reference_id
    , [ @reference_type = ] reference_type
 [  , [ @environment_folder_name = ] environment_folder_name ]

Argumentos

• [ @reference\_id = ] reference_id
  Identificador único de la referencia de entorno que se va a actualizar. El parámetro reference_id es de tipo bigint.

• [ @reference\_type = ] reference_type
  Indica si el entorno se puede encontrar en la misma carpeta que el proyecto (referencia relativa) o en una carpeta diferente (referencia absoluta). Utilice el valor R para indicar una referencia relativa. Utilice el valor A para indicar una referencia absoluta. El parámetro reference_type es de tipo char(1).

• [ @environment\_folder\_name = ] environment_folder_name
  La carpeta en que se encuentra el entorno. Este valor se requiere para las referencias absolutas. El parámetro environment_folder_name es de tipo nvarchar(128).

Valor del código de retorno

0 (correcto)

Conjuntos de resultados

Ninguno

Permisos

Este procedimiento almacenado requiere uno de los siguientes permisos:

• Los permisos de lectura y modificación en el proyecto, y el permiso de lectura en el entorno

• 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 producir un error o una advertencia:

• El nombre de la carpeta, el nombre del entorno o el identificador de referencia no es válido

• El usuario no tiene los permisos apropiados

• Una referencia absoluta se especifica utilizando el carácter A en el parámetro reference_location, pero el nombre de la carpeta no se especificó con el parámetro environment_folder_name.

Comentarios

Un proyecto puede referencias de entorno absolutas o relativas. Las referencias relativas se refieren al entorno por nombre y requieren que resida en la misma carpeta que el proyecto. Las referencias absolutas hacen referencia al entorno por nombre y carpeta, y pueden hacer referencia a los entornos que residen en una carpeta diferente que el proyecto. Un proyecto puede hacer referencia a varios entornos.

Importante
Si se especifica una referencia relativa, el valor del parámetro environment_folder_name no se utiliza, y el nombre de la carpeta de entorno se establece automáticamente en NULL. Si se especifica una referencia absoluta, el nombre de la carpeta de entorno se debe proporcionar en el parámetro de environment_folder_name.