Compartir a través de

catalog.rename_environment (base de datos de SSISDB)

  • Artículo

Cambia el nombre de un entorno en el catálogo de Integration Services.

Sintaxis

rename_environment [ @folder_name = ] folder_name
    , [ @environment_name = ] environment_name
    , [ @new_environment_name= ] new_environment_name

Argumentos

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

  • [ @environment\_name = ] environment_name
    Nombre original del entorno. El parámetro environment_name es de tipo nvarchar(128).

  • [ @new\_environment\_name = ] new_environment_name
    Nuevo nombre del entorno. El parámetro new_environment_name es de tipo nvarchar(128).

Valor del código de retorno

0 (correcto)

Conjuntos de resultados

Ninguno

Permisos

Este procedimiento almacenado necesita uno de los permisos siguientes:

  • Permisos MODIFY 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 del entorno original no es válido

  • El nuevo nombre ya se ha utilizado en un entorno existente

Comentarios

Las referencias de entorno de los proyectos no se actualizan automáticamente al cambiar el nombre del entorno. Las referencias del entorno deben actualizadas como corresponda. Este procedimiento almacenado tendrá éxito aunque las referencias del entorno se interrumpan cambiando el nombre del entorno. Las referencias del entorno se deben actualizar después de que se completa este procedimiento almacenado.

[!NOTA]

Cuando una referencia de entorno no es válida, la validación y ejecución de los paquetes correspondientes que utilizan esas referencias no se ejecutarán correctamente.