sp_rename (Transact-SQL)

Cambia el nombre de un objeto creado por el usuario en la base de datos actual. Este objeto puede ser una tabla, un índice, una columna, un tipo de datos de alias o un tipo definido por el usuario CLR (Common Language Runtime) de Microsoft .NET Framework.

Advertencia:
Al cambiar cualquier parte del nombre de un objeto se pueden interrumpir secuencias de comandos y procedimientos almacenados. Se recomienda no utilizar esta instrucción para cambiar el nombre a procedimientos almacenados, desencadenadores, funciones definidas por el usuario o vistas; en su lugar, quite el objeto y vuelva a crearlo con el nuevo nombre.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_rename [ @objname = ] 'object_name' , [ @newname = ] 'new_name' 
    [ , [ @objtype = ] 'object_type' ] 

Argumentos

[ @objname = ] 'object_name'

Es el nombre actual completo o incompleto del objeto de usuario o tipo de datos. Si el objeto cuyo nombre se va a cambiar es una columna de una tabla, object_name debe tener el formato tabla.columna. Si el objeto cuyo nombre se va a cambiar es un índice, object_namedebe tener el formato tabla.índice.

Las comillas sólo se necesitan si se especifica un objeto completo. Si se proporciona un nombre completo que incluye un nombre de base de datos, este último debe ser el nombre de la base de datos actual. object_name es de tipo nvarchar(776) y no tiene valor predeterminado.

[ @newname = ] 'new_name'

Es el nuevo nombre del objeto especificado. new_name debe ser un nombre de una parte y debe cumplir las reglas de los identificadores. newname es de tipo sysname y no tiene valor predeterminado.

[!NOTA] Los nombres de los desencadenadores no pueden comenzar por # o ##.

[ @objtype = ] 'object_type'

Es el tipo de objeto cuyo nombre se va a cambiar. object_type es de tipo varchar(13) y su valor predeterminado es NULL. Puede ser uno de estos valores.

Valor	Descripción
COLUMN	Una columna cuyo nombre se va a cambiar.
DATABASE	Una base de datos definida por el usuario. Este tipo de objeto es necesario cuando se cambia el nombre de una base de datos
INDEX	Un índice definido por el usuario.
OBJECT	Un elemento de un tipo registrado en sys.objects. Por ejemplo, OBJECT podría utilizarse para cambiar el nombre de objetos que incluyen restricciones (CHECK, FOREIGN KEY, PRIMARY o UNIQUE KEY), tablas de usuario y reglas.
USERDATATYPE	Un tipo de datos de alias o los tipos definidos por el usuario para CLR agregados mediante la ejecución de CREATE TYPE o sp_addtype.

Notas

Sólo se puede cambiar el nombre de un objeto o tipo de datos de la base de datos actual. No se pueden cambiar los nombres de la mayoría de los tipos de datos y objetos del sistema.

sp_rename cambia automáticamente el nombre del índice asociado cuando se cambia el nombre de una restricción PRIMARY KEY o UNIQUE. Si un índice cuyo nombre se ha cambiado está enlazado a una restricción PRIMARY KEY, sp_rename también cambia automáticamente el nombre de esta restricción.

sp_rename se puede utilizar para cambiar el nombre de los índices XML principales y secundarios.

Al cambiar el nombre de un procedimiento almacenado, una función, una vista o un desencadenador, no se cambiará el nombre del objeto correspondiente de la columna definition de la vista de catálogo sys.sql_modules. Por lo tanto, se recomienda no utilizar sp_rename para cambiar el nombre a estos tipos de objetos. En su lugar, quite el objeto y vuelva a crearlo con su nuevo nombre.

Al cambiar el nombre de un objeto como una tabla o columna, no se cambia automáticamente el nombre de las referencias a ese objeto. Es necesario modificar de forma manual los objetos que hacen referencia al objeto cuyo nombre se ha cambiado. Por ejemplo, si se cambia el nombre de una columna de una tabla y en un desencadenador existe una referencia a esa columna, es necesario modificar el desencadenador para reflejar el nuevo nombre de la columna. Utilice sys.sql_dependencies para ver la dependencias del objeto antes de cambiarle el nombre.

Permisos

Para cambiar el nombre de objetos, columnas e índices, se necesita permiso ALTER en el objeto. Para cambiar el nombre de tipos de usuario, se necesita permiso CONTROL en el tipo. Para cambiar el nombre de una base de datos, debe pertenecer a las funciones fijas de servidor sysadmin o dbcreator.

Valores de código de retorno

0 (correcto) o un número distinto de cero (error)

Ejemplos

A. Cambiar el nombre de una tabla

En el siguiente ejemplo se cambia el nombre de la tabla SalesTerritory por SalesTerr.

USE AdventureWorks;
GO
EXEC sp_rename 'Sales.SalesTerritory', 'SalesTerr';
GO

B. Cambiar el nombre de una columna

En el siguiente ejemplo se cambia el nombre de la columna TerritoryID de la tabla SalesTerritory por TerrID.

USE AdventureWorks;
GO
EXEC sp_rename 'Sales.SalesTerritory.TerritoryID', 'TerrID', 'COLUMN';
GO

C. Cambiar el nombre de un índice

En el siguiente ejemplo se cambia el nombre del índice IX_ProductVendor_VendorID por IX_VendorID.

USE AdventureWorks;
GO
EXEC sp_rename N'Purchasing.ProductVendor.IX_ProductVendor_VendorID', N'IX_VendorID', N'INDEX';
GO

D. Cambiar el nombre de un tipo de datos de alias

En el siguiente ejemplo se cambia el nombre del tipo de datos de alias Phone por Telephone.

USE AdventureWorks;
GO
EXEC sp_rename N'Phone', N'Telephone', N'USERDATATYPE';
GO

Vea también

Referencia

sys.sql_dependencies (Transact-SQL)
sys.sql_modules (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)
Procedimientos almacenados del motor de base de datos (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005