Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Crea y gestiona una base de datos local sin escribir comandos contenedor utilizando la extensión MSSQL para Visual Studio Code. Elige un contenedor Azure SQL Database (Preview) para desarrollar para el motor de Azure SQL Database en tu propio ordenador, o un contenedor SQL Server para el desarrollo de SQL Server. Inicia, detén, vuelve a conectarte a tu contenedor y elimina tu contenedor desde la extensión.
Para una nueva aplicación dirigida a Azure SQL Database, comienza con el contenedor Azure SQL Database. Es gratuito para desarrollo y pruebas locales, no requiere suscripción a Azure ni tarjeta de crédito, y funciona con los controladores y los mapeadores objeto-relacionales (ORMs) que usas para Azure SQL Database.
Nota:
El contenedor de Azure SQL Database está en versión preliminar pública. Es compatible tanto con dispositivos x64 como ARM.
¿Qué es un contenedor de Azure SQL Database?
Un contenedor empaqueta el motor de base de datos para que un entorno de ejecución de contenedor pueda ejecutarlo en tu ordenador. La extensión MSSQL te guía durante la configuración, descarga la imagen, inicia el motor y guarda una conexión. La aplicación se conecta a una dirección local, como localhost,1433, en lugar de a un servidor lógico de Azure SQL.
El contenedor Azure SQL Database ejecuta el motor Azure SQL Database, no la imagen del contenedor SQL Server. Admite Azure SQL Database T-SQL y el protocolo de flujo de datos tabular (TDS) usado por los controladores SQL. Por ejemplo, SERVERPROPERTY('EngineEdition') devuelve 5, identificando el motor de Azure SQL Database. Los vectores nativos, la búsqueda de vectores y JSON le ayudan a explorar los escenarios de datos listos para la inteligencia artificial localmente.
El contenedor no proporciona el servicio en la nube administrado. Las copias de seguridad administradas por Azure, alta disponibilidad, grupos elásticos y pausa automática sin servidor son funcionalidades de nube, no características de contenedor locales. Antes del despliegue, prueba contra Azure SQL Database en Azure: las restricciones de vista previa, los valores predeterminados y el soporte de funciones pueden variar. Vea las limitaciones conocidas.
Elija la base de datos de desarrollo
Utiliza la opción que coincida con el destino de tu aplicación, en lugar de tratar las dos imágenes contenedor como intercambiables.
| Option | Elíjalo cuando | Requisitos de costo y cuenta |
|---|---|---|
| Contenedor Azure SQL Database (Vista previa) | Quieres aprender SQL o construir y probar una aplicación dirigida a Azure SQL Database localmente. Soporta X64 y ARM. Recomendado para este flujo de trabajo de desarrollo local. | Gratis para desarrollo y pruebas locales. No se requiere ninguna suscripción Azure ni tarjeta de crédito. |
| Contenedor de SQL Server | Tu aplicación está dirigida a SQL Server o necesita un comportamiento específico de SQL Server. Solo soporta X64. | Utiliza una edición con licencia para tu situación. No se requiere suscripción a Azure para el desarrollo local. |
| Azure SQL Database nivel gratuito | Quieres una base de datos gestionada en Azure, integración en la nube o un entorno de validación en la nube. | Requiere una suscripción Azure. Se aplican las asignaciones mensuales, los requisitos de elegibilidad y el comportamiento de pausa o de pago por exceso. |
Importante
Los contenedores de Azure SQL Database son para desarrollo, pruebas, CI y demostraciones, no para producción. Para producción, implemente la aplicación y la base de datos en Azure SQL Database en Azure. El contenedor local gratuito y el nivel gratuito de Azure SQL Database son opciones separadas.
Requisitos previos
Para el contenedor Azure SQL Database, necesitas:
- Código de Visual Studio.
- Una versión actual de la extensión MSSQL que incluye el contenedor de Azure SQL Database (Versión preliminar).
- Un entorno de ejecución de contenedor compatible instalado y ejecutando contenedores de Linux. El asistente Azure SQL Database detecta motores disponibles y comprueba sus requisitos previos. Las opciones incluyen Docker, Podman, containerd con
nerdctl, y contenedores WSL en Windows. - Recursos suficientes para el motor de base de datos. Asigne al menos 4 GB de memoria y dos núcleos de CPU al entorno de ejecución del contenedor, y conserve al menos 10 GB de espacio libre en disco para la imagen y una pequeña base de datos. Los conjuntos de datos más grandes requieren más espacio en disco.
- Acceso a Internet para la descarga inicial de la imagen. Después de almacenar la imagen en caché, las consultas locales no requieren una base de datos en la nube. Los endpoints de IA externos y otros servicios en línea siguen requiriendo conectividad.
La imagen de Azure SQL Database proporciona variantes nativas linux/amd64 y linux/arm64 para hosts x64 y ARM64. Puedes desarrollar en macOS, Linux o Windows con WSL2. Los contenedores de SQL Server tienen requisitos de imagen y de ejecución separados.
Crear un contenedor de Azure SQL Database
En la vista Conexiones de la extensión MSSQL, selecciona New Deployment y Azure SQL Database container (Preview).
Revisa la visión general del contenedor de desarrolladores y selecciona Siguiente. El asistente revisa el motor que instalaste. Si el asistente no encuentra un motor, utilice los enlaces de instalación proporcionados para instalar un motor y, a continuación, intente de nuevo las comprobaciones. Cuando pasen las comprobaciones de requisitos previos, selecciona Siguiente.
Configura tu conexión con una contraseña fuerte de al menos ocho caracteres (letras mayúsculas, minúsculas, números y símbolos). Revise y acepte los Términos y Condiciones, y seleccione Siguiente para provisionar el contenedor.
Espere a que se complete la descarga de la imagen, la creación del contenedor, la preparación del motor y la conexión.
Encuentra la conexión guardada en Explorador de objetos en la vista Connections.
La extensión crea un perfil de conexión guardado. Un contenedor, un perfil de conexión y una base de datos de aplicaciones son recursos diferentes: iniciar el motor no significa que la base de datos de tu aplicación ya exista. Continúa con los pasos siguientes para crear una explícitamente.
El asistente también ofrece autenticación Microsoft Entra para escenarios más avanzados. Requiere una configuración adicional de identidad y certificado.
Crea una base de datos y ejecuta tu primera consulta
Usa appdb como nombre de la base de datos de ejemplo. Sustituye el nombre de la base de datos de tu proyecto de forma consistente si eliges otro nombre.
En Explorador de objetos, haz clic derecho en tu conexión de contenedor y selecciona Crear base de datos.
En el cuadro de diálogo Crear base de datos, introduzca
appdben Nombre de la base de datos.Utilice Add Connection para conectarse al mismo servidor local y puerto con la base de datos configurada en
appdb. Abre un nuevo editor de consultas con esta conexión y ejecuta:SELECT DB_NAME() AS current_database, SERVERPROPERTY('EngineEdition') AS engine_edition, SERVERPROPERTY('Edition') AS edition;Se espera que
current_databaseseaappdb, queengine_editionsea5y queeditionseaSQL Azure. Si la edición es diferente, compruebe que haya seleccionado el contenedor Azure SQL Database, no SQL Server. Selecciona la base de datos en la configuración de conexión, no conUSE appdb. Las sesiones de base de datos de usuario de Azure SQL Database no admiten cambiar de base de datos conUSE.Ejecute cada una de estas sentencias por separado en
appdb. Detente si una instrucción falla. Sidbo.Tasksya existe, elige un nombre de tabla diferente de forma consistente o una base de datos de desarrollo distinta; no la sobrescribas.CREATE TABLE dbo.Tasks ( TaskId INT IDENTITY (1, 1) NOT NULL PRIMARY KEY, Title NVARCHAR (200) NOT NULL, IsComplete BIT NOT NULL DEFAULT (0) );INSERT INTO dbo.Tasks (Title) VALUES (N'Create a local Azure SQL Database'), (N'Connect an application');SELECT TaskId, Title, IsComplete FROM dbo.Tasks ORDER BY TaskId;Tras una inserción exitosa, espera dos filas con
TaskIdvalores1y2, yIsCompletefije en0.
Si prefiere SQL para la creación de bases de datos, conecte un editor de consultas a master y ejecute CREATE DATABASE appdb; en lugar de usar el cuadro de diálogo Crear base de datos .
Use master para el aprovisionamiento de bases de datos y la base de datos de usuario para consultas de aplicaciones. Conectarse a una base de datos que no existe no la crea, y el contenedor no ejecuta automáticamente scripts de inicialización desde /docker-entrypoint-initdb.d.
Importar el esquema y los datos
Si ya tienes un paquete de base de datos, utiliza las operaciones DACPAC y BACPAC de la extensión en lugar de reconstruir manualmente el esquema.
| Package | Qué contiene | Operation |
|---|---|---|
.dacpac |
Esquema de base de datos. No incluye los datos de tu tabla. | Publish DACPAC para desplegar el esquema en una base de datos de desarrollo nueva o existente. |
.bacpac |
Datos del esquema y tabla de la base de datos. | Importa BACPAC a una base de datos de desarrollo nueva o vacía. |
Haz clic derecho en tu conexión de contenedor en Explorador de objetos y selecciona DACPAC/BACPAC Operations....
Elige la operación que coincida con tu paquete, selecciona el archivo del paquete y confirma la conexión del contenedor y la base de datos de destino.
Revise el destino y los cambios propuestos antes de continuar. Espere a que la operación finalice, luego actualice Bases de datos y conéctese directamente a la base de datos de usuario objetivo para inspeccionar su esquema y datos.
No importe un BACPAC en appdb después de crear la tabla de ejemplo dbo.Tasks: esa base de datos no está vacía. Elige en su lugar una base de datos de desarrollo nueva o vacía. Publique solo esquemas compatibles con Azure SQL Database y revise los cambios antes de aplicarlos a una base de datos con los datos que necesite.
Nota:
Los archivos de SQL Server .bak no son archivos BACPAC; BACKUP DATABASE y RESTORE DATABASE no son compatibles con Azure SQL Database.
Conecte su aplicación
Utilice la dirección del servidor local, el puerto host seleccionado por el asistente, el nombre de su base de datos y sus credenciales con un controlador compatible con Azure SQL. Por ejemplo, este cadena de conexión de estilo ADO.NET tiene como destino appdb:
Server=localhost,<host-port>;Database=appdb;User ID=sa;Password=<your-password>;Encrypt=True;TrustServerCertificate=True;
Reemplace ambos marcadores de posición antes de conectar.
TrustServerCertificate=True es solo para el certificado autofirmado del contenedor local. Utilice la validación de certificados y un método de autenticación adecuado, como la autenticación Microsoft Entra, para Azure SQL Database en Azure.
Almacene cadenas de conexión en variables de entorno o en el almacén de secretos de desarrollo, no en el control de código fuente ni en las solicitudes de IA. Otros controladores utilizan una sintaxis de cadena de conexión diferente; consulta los inicios rápidos para Python y .NET.
Desarrollo con IA
Puedes usar GitHub Copilot en la extensión MSSQL para explicar SQL, consultas en borrador y planificar cambios en el esquema de tu base de datos local. Revise el SQL generado y la base de datos seleccionada antes de ejecutarlo. El uso de contenedores es gratuito; GitHub Copilot y los servicios de modelos externos tienen sus propios requisitos de acceso y de precios.
Por ejemplo, después de crear dbo.Tasks, dale a Copilot este prompt:
I'm developing against an Azure SQL Database container, not SQL Server.
Use my existing appdb connection. First confirm the active database and
EngineEdition = 5. Explain the dbo.Tasks schema, then draft a parameterized
query to insert a task and a query to list incomplete tasks.
Don't execute changes, delete data, or create cloud resources.
Don't request or display passwords. Don't use USE to switch databases.
En el caso de los flujos de trabajo de código primero, las funcionalidades del agente de contenedor de Azure SQL Database proporcionan instrucciones de configuración, conexión, migración y guía de local a la nube para los agentes de codificación de IA compatibles.
Prueba la similitud vectorial sin un servicio de embeddings
Ejecuta este ejemplo en tu appdb conexión para explorar vectores nativos y búsqueda por similitud exacta. Utiliza vectores ilustrativos tridimensionales, no crea una tabla y no llama a un endpoint de modelo de pago.
DECLARE @query VECTOR(3) = '[1.0, 0.0, 0.0]';
SELECT TOP (2)
v.Label,
VECTOR_DISTANCE('cosine', CAST(v.Embedding AS VECTOR(3)), @query) AS distance
FROM (VALUES
(N'Closest', '[1.0, 0.0, 0.0]'),
(N'Perpendicular', '[0.0, 1.0, 0.0]')
) AS v(Label, Embedding)
ORDER BY distance;
Espera Closest primero con distancia 0, seguido de Perpendicular con distancia 1. En una aplicación real, genera incrustaciones con el mismo modelo para datos almacenados y consultas, y utiliza las dimensiones de incrustación del modelo.
VECTOR_DISTANCE realiza una búsqueda exacta; no utiliza un índice vectorial. Revisa las limitaciones de la vista previa antes de elegir una estrategia de indexación o incrustación.
Características
Las experiencias locales de contenedores proporcionan las siguientes capacidades:
- Crea un contenedor Azure SQL Database o SQL Server mediante un asistente guiado.
- Personalice el nombre del contenedor, el nombre de host y el puerto.
- Compruebe los requisitos previos del entorno de ejecución de contenedores antes del despliegue.
- Asigne automáticamente un puerto disponible si 1433 ya está en uso.
- Guarda la configuración de conexión para la reconexión.
- Gestiona el ciclo de vida del contenedor desde la vista Conexiones .
Crear un contenedor de SQL Server
Las siguientes capturas de pantalla ilustran el asistente de SQL Server, no el asistente de Azure SQL Database.
Abra el asistente de despliegue y elija contenedor SQL Server en Ejecutar localmente. También puede utilizar Crear contenedor SQL local desde el menú Conexiones .
Revisa la pantalla de resumen y selecciona Get Started.
La extensión MSSQL comprueba automáticamente Docker antes de la implementación:
- Si Docker no está instalado, aparece un mensaje con un vínculo de instalación. Debe instalarlo antes de continuar.
- Si Docker está instalado pero no en ejecución, se le pedirá que lo inicie. Si se produce un error al iniciar Docker, vuelva a intentarlo o cancelarlo.
Cuando se cumplan todos los requisitos previos, seleccione Siguiente.
En el panel Configuración de implementación :
- Seleccione la versión de SQL Server (SQL Server 2025 (17.x) seleccionada de forma predeterminada).
- Escriba una contraseña para la
sacuenta. - Escriba un nombre para el perfil de conexión (opcional).
- Opcionalmente, configura el nombre del contenedor, el puerto y el nombre del host en las opciones avanzadas.
- Acepte los términos de licencia.
- Seleccione Crear contenedor.
Funcionamiento de la implementación de contenedores de SQL
Para SQL Server, después de seleccionar Crear contenedor, la extensión:
- Extrae la imagen de SQL Server seleccionada (si aún no está almacenada en caché).
- Crea un contenedor de SQL Server con la configuración elegida.
- Supervisa los registros para comprobar que todas las bases de datos están totalmente recuperadas y listas.
- Crea un perfil de conexión y se conecta al contenedor.
Cuando finaliza el despliegue, la extensión MSSQL se conecta al contenedor. Crea o selecciona una base de datos de usuario antes de ejecutar consultas de aplicación.
Administración del contenedor
Para cualquiera de los dos tipos de contenedor, haga clic derecho en su perfil de conexión guardado en la vista Conexiones para gestionar su ciclo de vida.
La siguiente captura de pantalla muestra un contenedor de Azure SQL Database detenido. Su menú ofrece Iniciar contenedor SQL y Eliminar contenedor SQL. Cuando el contenedor está en ejecución, el menú ofrece en su lugar Detener contenedor SQL .
Inicie el contenedor detenido
Selecciona Iniciar contenedor SQL. La extensión comprueba el runtime asociado y inicia el contenedor antes de conectarse. Si el runtime no se está ejecutando, siga la indicación para iniciarlo.
Detener un contenedor que está ejecutándose
Seleccione Detener contenedor SQL para liberar los recursos del contenedor en ejecución sin eliminarlo. Los archivos de base de datos permanecen disponibles cuando reinicias el mismo contenedor. Esta acción detiene el contenedor, no la pausa automática del modo sin servidor de Azure SQL Database.
Eliminación del contenedor
Seleccione Eliminar contenedor SQL y revise la confirmación antes de continuar. La eliminación elimina el contenedor y el perfil de conexión seleccionado. Los datos almacenados únicamente dentro del contenedor se pierden; los volúmenes gestionados por separado tienen su propio ciclo de vida. Conserva cualquier dato que necesites antes de eliminarlo.
Importante
No elimines un contenedor ni su almacenamiento para solucionar problemas de una conexión a menos que puedas descartar sus datos. Si solo quieres pausar el desarrollo, deténlo en su lugar.
Escenarios admitidos
Utilice el contenedor Azure SQL Database para prototipar aplicaciones, probar migraciones, aprender T-SQL y explorar vectores y JSON antes del despliegue en la nube. También puede utilizar la imagen del contenedor en CI, sidecars de aplicación o laboratorios offline; esos flujos de trabajo específicos de tiempo de ejecución no se configuran mediante el asistente de VS Code.
Utilice el contenedor de SQL Server para probar esquemas y características de SQL Server. No des por hecho que una función específica de SQL Server funciona en Azure SQL Database solo porque funciona en un contenedor de SQL Server.
Solución de problemas de desarrollo local
| Síntoma | Elementos que se deben comprobar |
|---|---|
| La opción de contenedor Azure SQL Database no aparece. | Actualice la extensión de MSSQL a una versión que incluya el asistente de vista previa pública y seleccione de nuevo Nueva implementación . |
| Las comprobaciones de prerrequisitos en tiempo de ejecución fallan. | Confirme que el entorno de ejecución seleccionado está instalado, en ejecución y configurado para contenedores Linux. Corrija el problema reportado y vuelva a intentarlo. |
| Error al descargar la imagen. | Revise el error del registro y compruebe la conectividad y la configuración en tiempo de ejecución. No sustituyas la imagen de SQL Server por Azure SQL Database. |
| El contenedor arranca pero las conexiones fallan. | Espere a que el motor esté listo y luego inspeccione los detalles de errores y los registros del contenedor. Compruebe la complejidad de la contraseña y la asignación de memoria. Un proceso en contenedor en ejecución no demuestra que la base de datos esté lista. |
| Una aplicación no puede acceder a la base de datos. | Utilice el puerto host real seleccionado por el asistente, no un supuesto 1433.
localhost se refiere al propio host de la aplicación; una aplicación en otro contenedor necesita una dirección de contenedor-red adecuada. |
| La base de datos no existe. | Conéctate a master, crea la base de datos y vuelve a conectarte directamente a ella. |
USE appdb falla. |
Selecciona appdb en la configuración de conexión. No cambie de bases de datos en una sesión de base de datos de usuario de Azure SQL Database con USE. |
| Una operación de gestión de SQL Server falla. | Compruebe si la operación está soportada por Azure SQL Database. Por ejemplo, BACKUP DATABASE y RESTORE DATABASE no están soportados. |
Consulta las limitaciones conocidas para conocer las carencias actuales de la versión preliminar y las soluciones alternativas.
Limpiar datos de muestra
En tu conexión appdb, confirma que SELECT DB_NAME() devuelve appdb. Si lo creaste dbo.Tasks en esta guía y ya no lo necesitas, elimina solo esa tabla de ejemplo:
DROP TABLE dbo.Tasks;
No ejecutes esta instrucción contra una tabla de otro proyecto. Detenga el contenedor para seguir trabajando más tarde, o elimínalo solo cuando ya no necesite sus datos.
Pasar de local a nube
- Utilizando la extensión MSSQL, puedes migrar tu base de datos local a la nube. Aprende más en Local to Cloud.