catalog.rename_environment (base de datos de SSISDB)
Se aplica a: SQL Server SSIS Integration Runtime en Azure Data Factory
Se aplica a: SQL Server
Cambia el nombre de un entorno en el catálogo de Integration Services.
Sintaxis
catalog.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. folder_name es nvarchar(128) .
[ @environment_name = ] environment_name
Nombre original del entorno. environment_name es nvarchar(128) .
[ @new_environment_name = ] new_environment_name
Nuevo nombre del entorno. new_environment_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:
Permisos MODIFY 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 del entorno original no es válido
El nuevo nombre ya se ha utilizado en un entorno existente
Observaciones
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.