catalog.create_environment_reference (base de datos de SSISDB)

Artículo
05/08/2013

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

Sintaxis

create_environment_reference [ @folder_name = ] folder_name
     , [ @project_name = ] project_name
     , [ @environment_name = ] environment_name
     , [ @reference_location = ] reference_location
  [  , [ @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. El parámetro folder_name es de tipo nvarchar(128).
[ @project\_name = ] project_name
El nombre del proyecto al que se hace referencia en el entorno. El parámetro project_name es de tipo nvarchar(128).
[ @environment\_name = ] environment_name
El nombre del entorno al que se hace referencia. El parámetro environment_name es de tipo nvarchar(128).
[ @reference\_location = ] reference_location
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_location es de tipo 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 de tipo nvarchar(128).
[ @reference\_id = ] reference_id
Devuelve el identificador único para la nueva referencia. Este parámetro es opcional. El parámetro reference_id es de tipo bigint.

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 no es válido
El nombre de proyecto 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.

Compartir a través de