catalog.set_environment_reference_type (base de datos SSISDB)

  • Artículo

Se aplica a:SQL Server SSIS Integration Runtime en Azure Data Factory

Se aplica a:SQL Server

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

catalog.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. reference_id es 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 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 nvarchar(128) .

Valor de código de retorno

0 (correcto)

Conjuntos de resultados

None

Permisos

Este procedimiento almacenado necesita uno de los permisos siguientes:

  • 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 de ssis_admin

  • Pertenencia al rol de servidor de sysadmin

Errores y advertencias

En la siguiente lista 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 mediante 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.

Observaciones

Un proyecto puede tener 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 del 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 environment_folder_name.