Compartir a través de

catalog.create_environment_reference (base de datos de SSISDB)

  • Artículo

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

Se aplica a: SQL Server

Crea una referencia de entorno para un proyecto en el catálogo de Integration Services.

Sintaxis

catalog.create_environment_reference [ @folder_name = ] folder_name  
     , [ @project_name = ] project_name  
     , [ @environment_name = ] environment_name  
     , [ @reference_type = ] reference_type  
  [  , [ @environment_folder_name = ] environment_folder_name ]  
  [  , [ @reference_id = ] reference_id OUTPUT ]

Argumentos

[ @folder_name = ] folder_name
El nombre de la carpeta del proyecto al que se hace referencia en el entorno. folder_name es nvarchar(128) .

[ @project_name = ] project_name
El nombre del proyecto al que se hace referencia en el entorno. project_name es nvarchar(128) .

[ @environment_name = ] environment_name
El nombre del entorno al que se hace referencia. environment_name es nvarchar(128) .

[ @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
El nombre de la carpeta en la que se encuentra el entorno al que se hace referencia. Este valor se requiere para las referencias absolutas. El parámetro environment_folder_name es nvarchar(128) .

[ @reference_id = ] reference_id
Devuelve el identificador único para la nueva referencia. Este parámetro es opcional. reference_id es bigint.

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 no es válido

  • El nombre de proyecto 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.