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 scripts 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 table.column o schema.table.column. Si el objeto cuyo nombre se va a cambiar es un índice, object_name debe tener el formato table.index o schema.table.index.

  Las comillas solo se necesitan si se especifica un objeto completo. Si se proporciona un nombre completo, incluido 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 ningún 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), su valor predeterminado es NULL y 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	Índice definido por el usuario.
  OBJECT	Elemento de un tipo registrado en sys.objects. Por ejemplo, OBJECT podría utilizarse para cambiar el nombre de objetos como 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.

Valores de código de retorno

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

Comentarios

Solo 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 de definición 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. Utilicesys.sql_expression_dependencies para ver las 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 el 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.

Ejemplos

A. Cambiar el nombre de una tabla

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

USE AdventureWorks2008R2;
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 AdventureWorks2008R2;
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 AdventureWorks2008R2;
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 AdventureWorks2008R2;
GO
EXEC sp_rename N'Phone', N'Telephone', N'USERDATATYPE';
GO

Vea también

Referencia

sys.sql_expression_dependencies (Transact-SQL)

sys.sql_modules (Transact-SQL)

Procedimientos almacenados del sistema (Transact-SQL)

Procedimientos almacenados del motor de base de datos (Transact-SQL)

Conceptos

Descripción de las dependencias SQL