sp_rename (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 sólo 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	Columna cuyo nombre se va a cambiar.
  DATABASE	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)

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 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 el 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

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

B. Cambiar el nombre de una columna

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

C. Cambiar el nombre de un índice

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

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

Vea también

Referencia

Conceptos