Desarrolla en local con el contenedor Azure SQL Database y el contenedor SQL Server

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

  1. En la vista Conexiones de la extensión MSSQL, selecciona New Deployment y Azure SQL Database container (Preview).

    Captura de pantalla de la vista Conexiones con la acción de la barra de herramientas Nueva implementación resaltada.

    Captura de pantalla de la página Nueva base de datos SQL con la opción de vista previa del contenedor Azure SQL Database local resaltada.

  2. 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.

    Captura de pantalla de la visión general del contenedor de Azure SQL Database que describe el desarrollo local, imágenes nativas ARM y x64, y opciones del motor de contenedores.

    Captura de pantalla de la página de requisitos previos del motor de contenedor mostrando la detección de Docker y las comprobaciones de instalación, inicio y configuración completadas.

  3. 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.

    Captura de pantalla de la configuración del contenedor con inicio de sesión SQL, contraseña oculta, nombre de perfil, opciones avanzadas, puerto 1436 y la casilla de verificación de términos de licencia.

  4. Espere a que se complete la descarga de la imagen, la creación del contenedor, la preparación del motor y la conexión.

    Captura de pantalla de la provisión con descarga de imágenes, creación de contenedores, preparación y pasos de conexión completados.

  5. Encuentra la conexión guardada en Explorador de objetos en la vista Connections.

    Captura de pantalla de la conexión del contenedor Azure SQL DB en ejecución en Explorador de objetos con nodos de bases de datos y seguridad.

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.

  1. En Explorador de objetos, haz clic derecho en tu conexión de contenedor y selecciona Crear base de datos.

  2. En el cuadro de diálogo Crear base de datos, introduzca appdb en Nombre de la base de datos.

    Captura de pantalla del cuadro de diálogo Crear base de datos para el contenedor local de Azure SQL Database, con Nombre de la base de datos y configuraciones avanzadas.

  3. 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_database sea appdb, que engine_edition sea 5 y que edition sea SQL 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 con USE appdb. Las sesiones de base de datos de usuario de Azure SQL Database no admiten cambiar de base de datos con USE.

  4. Ejecute cada una de estas sentencias por separado en appdb. Detente si una instrucción falla. Si dbo.Tasks ya 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 TaskId valores 1 y 2, y IsComplete fije en 0.

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.
  1. Haz clic derecho en tu conexión de contenedor en Explorador de objetos y selecciona DACPAC/BACPAC Operations....

    Captura de pantalla del menú de conexión del contenedor con las operaciones DACPAC/BACPAC resaltadas y las acciones Detener contenedor SQL y Eliminar contenedor SQL visibles.

  2. 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.

  3. 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.

  1. 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 .

    Captura de pantalla que muestra la opción de creación de contenedor de SQL Server en la extensión MSSQL.

  2. Revisa la pantalla de resumen y selecciona Get Started.

    Captura de pantalla de la pantalla de resumen para el despliegue local de contenedores de SQL Server con enlaces útiles y botón Empezar.

  3. 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.

    Captura de pantalla de la verificación de prerequisitos Docker del asistente de SQL Server en la extensión MSSQL.

  4. En el panel Configuración de implementación :

    1. Seleccione la versión de SQL Server (SQL Server 2025 (17.x) seleccionada de forma predeterminada).
    2. Escriba una contraseña para la sa cuenta.
    3. Escriba un nombre para el perfil de conexión (opcional).
    4. Opcionalmente, configura el nombre del contenedor, el puerto y el nombre del host en las opciones avanzadas.
    5. Acepte los términos de licencia.
    6. Seleccione Crear contenedor.

    Captura de pantalla del formulario de configuración de configuración del 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 .

Captura de pantalla de un contenedor de Azure SQL Database detenido con Start SQL Container y Delete SQL Container en su menú de conexión.

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.