catalog.rename_environment (base de datos de SSISDB)

  • Artículo

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.