Uso de proyectos de SQL Database

Completado

La extensión Proyectos de SQL Database es una herramienta para desarrolladores que se puede instalar en Visual Studio Code. Esta extensión está diseñada para facilitar el desarrollo y la administración de bases de datos SQL en un entorno basado en proyectos. Es compatible con varias plataformas SQL, como SQL Server, Azure SQL Database, Azure SQL Managed Instance y Azure Synapse SQL.

Los esquemas de base de datos se pueden crear o cambiar y los cambios se guardan en un formato de archivo .dacpac. Puede publicar el proyecto de SQL Database mediante la extensión Proyectos de SQL Database o publicando el .dacpac con la interfaz de la línea de comandos SqlPackage.

Con la extensión Proyectos de SQL Database, puede crear un nuevo proyecto vacío o crear un nuevo proyecto a partir de una base de datos conectada. Después, puede agregar, modificar o quitar objetos como tablas, vistas, procedimientos almacenados, funciones y scripts personalizados.

Instalación de la extensión de proyectos de base de datos

La extensión Proyectos de SQL Database se instala como parte de la extensión mssql. La extensión mssql de Visual Studio Code permite conectarse a SQL Server, consultar bases de datos con T-SQL y ver los resultados.

Es un requisito previo que tenga instalado el SDK de .NET más reciente. Si no es así, se le pedirá que lo instale.

Importación y modificación de un esquema

Ahora que ha instalado la extensión Proyectos de SQL Database, puede crear un proyecto de base de datos. En este ejemplo, nos conectamos a una instancia de Azure SQL Database existente.

Creación de un proyecto de base de datos

El proyecto de base de datos es el punto de partida para diseñar, desarrollar y administrar el esquema de la base de datos. Proporciona un entorno estructurado donde puede definir tablas, vistas, procedimientos almacenados y otros objetos de base de datos.

1. En el menú de la izquierda de Visual Studio Code, seleccione Proyectos de base de datos y, a continuación Crear nuevo.
2. Seleccione Azure SQL Database a partir de un proyecto vacío en Seleccionar tipo de proyecto de base de datos.
3. Seleccione o escriba un nombre para el proyecto en Nombre del proyecto.
4. Seleccione o busque una carpeta en la máquina local donde se guardará el proyecto en Ubicación.
5. Cuando se le solicite, seleccione Sí para el proyecto de estilo SDK. Se crea el proyecto de datos.

Agregar una conexión

Antes de empezar a trabajar con la base de datos en Visual Studio Code, debe establecer una conexión con la instancia de Azure SQL Database. Esta conexión le permite interactuar con la base de datos directamente desde el IDE, lo que le permite ejecutar consultas, administrar objetos de base de datos y realizar otras tareas relacionadas con la base de datos. Siga los pasos para agregar una conexión a la instancia de Azure SQL Database.

1. En el menú de la izquierda, seleccione SQL Server.
2. Seleccione Agregar conexión.
3. Escriba el nombre de la instancia de SQL Server en Nombre del servidor. Puede copiar y pegar el nombre del servidor desde Azure Portal.
4. Escriba el nombre de la base de datos.
5. Seleccione el tipo de autenticación, el nombre de usuario y la contraseña.
6. Escriba un nombre para el perfil de conexión en Nombre del perfil. Este paso es opcional.
7. La conexión de base de datos aparece en el nodo Conexiones.

Creación de un nuevo proyecto de SQL Database a partir de una base de datos existente

La creación de un nuevo proyecto de SQL Database a partir de una base de datos existente le permite importar el esquema de la base de datos actual en un formato de proyecto estructurado. Siga estos pasos para crear un nuevo proyecto de SQL Database a partir de una base de datos existente.

1. Haga clic con el botón derecho en la base de datos y seleccione Crear proyecto desde la base de datos.
2. En Seleccionar base de datos, seleccione la base de datos.
3. Seleccione el proyecto en Escriba el nombre del proyecto.
4. Vaya a la carpeta en Seleccionar ubicación o crear proyecto.
5. Seleccione Esquema/Tipo de objeto en Seleccionar estructura de carpetas.
6. Seleccione No (valor predeterminado) en Incluir permisos en el proyecto.
7. Seleccione Sí (recomendado) en Proyecto de estilo SDK (versión preliminar).
8. Cuando se le solicite, seleccione Sí para confiar en los autores de los archivos.
9. Expanda el árbol de objetos de base de datos para ver las tablas y otros objetos.
10. Para modificar el esquema, seleccione un objeto.
11. Seleccione Archivo > Guardar y cierre la pestaña.

Implementación de cambios de esquema

Para implementar los cambios en la instancia de Azure SQL Database después de modificar el esquema de la base de datos (por ejemplo, agregar nuevas tablas, actualizar columnas existentes o crear nuevos procedimientos almacenados), siga estos pasos.

1. En la barra de actividades, seleccione Proyectos de base de datos.
2. Seleccione Compilar haciendo clic con el botón derecho en el proyecto.
3. A continuación, seleccione Publicar haciendo clic con el botón derecho en el proyecto.
4. Seleccione Publicar en un servidor lógico de Azure SQL existente en Seleccionar dónde publicar el proyecto.
5. Seleccione No usar perfil en Seleccionar perfil de publicación para cargar.
6. Seleccione la base de datos en Elegir un perfil de conexión en la lista siguiente.
7. Seleccione Publicar en Elegir acción.
8. Actualice la vista de base de datos para comprobar que se han realizado modificaciones del esquema.