Procedimientos: Uso de Cambiar nombre y Refactorizar para realizar cambios en los objetos de base de datos

Artículo
07/12/2023

El menú contextual Refactorizar del Editor de Transact-SQL le permite cambiar el nombre de un objeto o moverlo a un esquema diferente y obtener una vista previa de todas las áreas afectadas antes de confirmar el cambio. También puede usar el menú Refactorizar para calificar todas las referencias a objetos de base de datos o para expandir todos los caracteres comodín de las instrucciones SELECT en el proyecto de base de datos.

Advertencia

El procedimiento siguiente usa entidades creadas en procedimientos anteriores de las secciones Desarrollo de bases de datos sin conexión orientado a proyectos.

Para cambiar el nombre de un tipo

Haga clic con el botón derecho en la tabla Products (Products.sql) en el Explorador de soluciones y seleccione Ver código para abrir el script en el Editor de Transact-SQL.
Haga clic con el botón derecho en [Products] en el script, seleccione Refactorizar y, posteriormente, haga clic en Cambiar nombre.
En el campo Nuevo nombre, cámbielo a Product. Deje activada la opción Vista previa de los cambios y haga clic en Aceptar.
En la próxima pantalla podrá ver una lista de los scripts que se verán afectados por esta operación de cambio de nombre. En concreto, aparecerán resaltados todos los lugares donde se hace referencia a Products. Esto es muy similar a la tarea Buscar todas las referencias del procedimiento anterior. Haga clic en algún sitio en el panel superior y vea el cambio real en los scripts (resaltados en verde) en el panel inferior.
Haga clic en Aplicar.
En el caso de los archivos de script que ya están abiertos en el Diseñador de tablas o en el Editor de Transact-SQL, observe que el Editor de Transact-SQL ha resaltado las ubicaciones donde se han realizado cambios con una barra verde a la izquierda.
Observe que se ha agregado TradeDev.refactorlog en el Explorador de soluciones. Haga doble clic para abrirlo. Contiene una representación XML de todos los cambios de esta sesión.
Presione F5 para compilar e implementar el proyecto en la base de datos local.
Haga clic con el botón derecho en la base de datos TradeDev en Local en el Explorador de objetos de SQL Server y seleccione Actualizar.
Expanda Tablas y observe que se ha cambiado el nombre de la tabla Products.
Haga clic con el botón derecho en Product y seleccione Ver datos. Observe que los datos existentes están intactos independientemente de la operación de cambio de nombre.

Advertencia

Si se elimina un registro de refactorización, se eliminará el historial completo de la refactorización. Cuando el proyecto se publica en una base de datos en la que no se han aplicado operaciones de refactorización anteriores, las operaciones de refactorización completadas antes de eliminar el archivo de refactorización se publicarán como operaciones de eliminación y creación. Como resultado, puede producirse una pérdida de datos.

Para expandir caracteres comodín

Expanda el nodo Funciones en el Explorador de soluciones y haga doble clic en GetProductsBySupplier.sql.
Sitúe el cursor sobre el asterisco de esta línea y haga clic con el botón secundario. Seleccione Refactorizar y haga clic en Expandir caracteres comodín.
```
SELECT * from Product p  
```
En el cuadro de diálogo Vista previa de los cambios, haga clic en SELECT * from Product p en el panel superior para resaltarlo.
En el panel Vista previa de los cambios, observe que * se ha expandido a lo siguiente en el script.
```
[Id], [Name], [ShelfLife], [SupplierId], [CustomerId]  
```
Haga clic en el botón Aplicar. Observe que la línea que contiene cambios realizados por la operación de expansión está resaltada de nuevo con una barra verde a la izquierda.

Para completar nombres de objetos de base de datos

Asegúrese de que GetProductsBySupplier.sql sigue abierto en el Editor de Transact-SQL.
Sitúe el cursor sobre Product en esta línea y haga clic con el botón secundario. Seleccione Refactorizar y Nombres completos.
```
SELECT [Id], [Name], [ShelfLife], [SupplierId], [CustomerId] from Product p  
```
Haga clic en el botón Aplicar del cuadro de diálogo Vista previa de los cambios. Observe que todas las referencias de objetos se han actualizado para incluir el nombre del esquema del objeto y, si el objeto tiene un objeto primario, el nombre del objeto primario.
```
SELECT [p].[Id], [p].[Name], [p].[ShelfLife], [p].[SupplierId], [p].[CustomerId] from [dbo].[Product] p  
```

Para mover el esquema

Haga clic con el botón secundario en el objeto que desea mover. Seleccione Refactorizar y Mover esquema.
En la lista Nuevo esquema, haga clic en el nombre del esquema al que desea mover el objeto. Haga clic en Aceptar.

Si activó la casilla de verificación Vista previa de los cambios aparece el cuadro de diálogo Vista previa de los cambios. De lo contrario, el nombre de objeto se actualiza y el objeto se mueve el nuevo esquema.

Compartir a través de