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.
Se aplica a:Azure SQL Database
En este inicio rápido, puedes empezar con el contenedor Azure SQL Database, crear una base de datos local y ejecutar tu primera consulta. Luego, utiliza Azure SQL Dev Hub para crear una aplicación con ejemplos, indicaciones y habilidades de agente de programación con IA.
Note
El contenedor de Azure SQL Database está en versión preliminar pública.
¿Qué es el contenedor Azure SQL Database?
Un contenedor empaqueta el motor de base de datos para que puedas ejecutarlo en tu ordenador con un entorno de ejecución contenedor. El contenedor Azure SQL Database ejecuta el motor Azure SQL Database, no la imagen del contenedor SQL Server. Tu aplicación se conecta a una dirección local, como localhost,1433, en lugar de a una base de datos en Azure.
Utilice el contenedor para aprender T-SQL, desarrollar aplicaciones, probar cambios en el esquema o ejecutar pruebas de integración continua (CI). También puedes explorar vectores nativos, búsqueda vectorial y JSON para aplicaciones de IA. Funciona con los controladores y los mapadores objeto-relacionales (ORMs) que utilizas para Azure SQL Database.
El contenedor es gratuito para desarrollo y pruebas locales. No necesitas una suscripción a Azure ni una tarjeta de crédito para ejecutarlo localmente.
Importante
El contenedor es para desarrollo, pruebas, CI y demostraciones, no para producción. No ofrece servicios gestionados por Azure como copias de seguridad automatizadas, alta disponibilidad o pools elásticos. Para producción, implemente su base de datos y aplicación en los servicios de Azure, no en el contenedor local.
Para más información, consulte ¿Qué es el contenedor de Azure SQL Database?.
Prerequisites
- Un entorno de ejecución de contenedores instalado y que ejecuta contenedores Linux. Elige Docker, Podman, contenedores WSL o la herramienta
containerde Apple como se describe en la sección siguiente. - Un ordenador compatible con x64 o ARM64 que ejecute macOS, Linux o Windows con Subsistema de Windows para Linux 2 (WSL2). La imagen proporciona variantes nativas
linux/amd64ylinux/arm64. - Al menos dos núcleos de CPU, 4 GB de memoria disponibles para el entorno de ejecución del contenedor y 10 GB de espacio libre en disco para la imagen y una pequeña base de datos.
- Acceso a Internet para la descarga inicial de la imagen. Las consultas locales pueden ejecutarse sin conexión después; los servicios externos siguen requiriendo conectividad.
- Un puerto host disponible, como
1433, y un nombre de contenedor único. En los ejemplos se usasqldb. Elija un nombre o puerto host diferente si alguno ya está en uso.
Revise los requisitos previos para contenedores para los requisitos actuales de plataforma y de ejecución.
Elija un runtime de contenedor
Utilice el entorno de ejecución que se adapte a su sistema operativo. Estos ejemplos utilizan imágenes nativas para tu arquitectura de host; no configuran la emulación.
| Runtime | Configuración |
|---|---|
| Docker | Instala Docker Desktop o Docker Engine y asegúrate de que funcione con soporte para contenedores Linux. |
| Podman | Instala Podman. En macOS y Windows, inicialice una máquina Podman si es necesario y luego arránquela con podman machine start. |
| Contenedores de WSL | Instala o actualiza WSL para que esté wslc.exe disponible. Ejecutar wslc desde PowerShell en el host de Windows. Desde Bash dentro de una distribución WSL, use wslc.exe; La interoperabilidad WSL debe estar habilitada y wslc.exe debe estar en su PATH. El puerto publicado está en el host de Windows. |
| contenedor de Apple | Instala la herramienta de contenedor de Apple en un Mac Apple silicon que ejecute macOS 26. Inicie su servicio con container system start. |
Otros entornos de ejecución compatibles con OCI, como containerd con nerdctl o Rancher Desktop, también pueden ejecutar la imagen. Utilice la documentación de su runtime para sus comandos y configuración.
Obtén la imagen pública de vista previa
La referencia pública de la imagen de vista previa es mcr.microsoft.com/mssql/azure-sql-db-server:latest. Obtenga información de imagen del listado del Registro de Artefactos de Microsoft. Las imágenes públicas no requieren una cuenta de registro de vista previa privada ni inicio de sesión en el registro.
Los siguientes comandos descargan la imagen automáticamente si no está almacenada en caché localmente. Para descargarlo por separado con Docker, ejecute:
docker pull mcr.microsoft.com/mssql/azure-sql-db-server:latest
Para contenedores Podman, WSL o Apple container, use podman pull, wslc pull, o container image pull, respectivamente, con la misma referencia de imagen.
Iniciar el contenedor
Sustituye <your-strong-password> por una contraseña única y segura para la autenticación sa. Utilice al menos ocho caracteres con caracteres de al menos tres de estos grupos: letras mayúsculas, letras minúsculas, dígitos y símbolos. Mantén las contraseñas fuera del control de versiones y de la salida compartida del terminal. La contraseña también es visible en la configuración del contenedor.
Elige tu runtime y luego ejecuta su comando. La configuración ACCEPT_EULA=Y acepta los términos de licencia de la imagen. Cada ejemplo asigna 2 GiB de memoria y dos CPUs al contenedor y publica el puerto 1433 de base de datos en la dirección de loopback del host.
docker run --name sqldb --memory 2g --cpus 2 -e ACCEPT_EULA=Y -e "MSSQL_SA_PASSWORD=<your-strong-password>" -p 127.0.0.1:1433:1433 -d mcr.microsoft.com/mssql/azure-sql-db-server:latest
Que un contenedor esté en ejecución no significa necesariamente que el motor de base de datos esté listo. Utilice la sqlcmd utilidad incluida con el contenedor para comprobar si una conexión SQL ha sido exitosa:
docker exec sqldb /opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P "<your-strong-password>" -C -b -l 5 -t 5 -Q "SELECT @@VERSION;"
Sustituye wslc.exe por container, wslc (o podman dentro de WSL), o docker para tu runtime. Intenta de nuevo mientras el motor arranca. La salida exitosa incluye Microsoft SQL Azure. La -b opción devuelve un código de salida de error para errores SQL; -l 5 y -t 5 limita las esperas de inicio de sesión y consulta a cinco segundos cada una.
-C confía en el certificado autofirmado del contenedor para esta conexión local; utilice la validación adecuada del certificado fuera del desarrollo local.
Esta comprobación se conecta dentro del contenedor, no a través del puerto host publicado. Para conectarte desde tu editor o aplicación, utiliza el servidor 127.0.0.1,1433, autenticación SQL, usuario sa y la contraseña que configuraste. Ajusta el puerto si has cambiado el mapeo del host.
Si SQL no acepta conexiones, inspeccione los registros con docker logs --tail 80 sqldb, podman logs --tail 80 sqldb, wslc logs --tail 80 sqldb, o container logs -n 80 sqldb. Compruebe la política de contraseñas y los recursos disponibles antes de intentarlo de nuevo.
Si prefieres una experiencia de instalación gráfica, sigue Configurar localmente con contenedor de Azure SQL Database y contenedor de SQL Server en la extensión MSSQL para Visual Studio Code, o Conectarse y consultar un contenedor de Azure SQL Database | Microsoft Learn para SSMS.
Crear una base de datos y ejecutar una consulta
Utiliza un cliente SQL, como la sqlcmd utilidad incluida con el contenedor, o la ventana de consulta de tu editor. Por ejemplo, abra una conexión interactiva master con el siguiente comando, sustituyendo la CLI de su entorno de ejecución por docker y utilizando su contraseña configurada:
docker exec -it sqldb /opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P "<your-strong-password>" -C -b -d master
En una sesión interactiva sqlcmd, introduce GO en una línea nueva después de cada sentencia o consulta SQL para ejecutarla. Introduzca EXIT para cerrar la sesión.
Conéctate a la base de datos
masterdel contenedor local con las credenciales que configuraste y ejecuta:CREATE DATABASE appdb;El nombre
appdbes un ejemplo; puedes elegir un nombre de base de datos diferente. Si tu herramienta de configuración ya creó una base de datos de usuarios, utiliza esa base de datos y omite este paso.Abra una nueva conexión directamente a
appdb. Especifique la base de datos en la configuración de conexión de su cliente o con-d appdbensqlcmd. No utiliceUSEpara cambiar de base de datos en una sesión de base de datos de usuario de Azure SQL Database.Para el comando interactivo anterior a este paso, salga de la
mastersesión y luego ejecute el comando de nuevo con-d appdben lugar de-d master.Ejecute esta consulta en la
appdbconexión:SELECT DB_NAME() AS current_database, SERVERPROPERTY('EngineEdition') AS engine_edition, SERVERPROPERTY('Edition') AS edition, 1 AS connected;Se espera que
current_databaseseaappdb,engine_editionsea5,editionseaSQL Azureyconnectedsea1. Estos valores confirman que te has conectado a tu base de datos de usuario en el motor Azure SQL Database. Si la edición es diferente, comprueba que has iniciado la imagen de Azure SQL Database en lugar de la imagen de SQL Server.
Ahora dispone de una base de datos local para el desarrollo de aplicaciones. Usa el mismo nombre de base de datos en la cadena de conexión de tu aplicación.
Desarrolla con Azure SQL Dev Hub
Visita Azure SQL Dev Hub para elegir un escenario de aplicación y comenzar con indicaciones, ejemplos y habilidades de agentes. Puedes crear una aplicación de seguimiento de tareas, crear una API o explorar la búsqueda vectorial para una aplicación de generación aumentada por recuperación (RAG).
Algunos avisos de Dev Hub, como el prompt de la aplicación JavaScript, apuntan a bases de datos en la nube y requieren autenticación Microsoft Entra. Antes de ejecutar un aviso localmente, adapte tanto sus instrucciones como su configuración de conexión al servidor de su contenedor, al puerto asignado, al nombre de la base de datos y al método de autenticación. Si utiliza la ruta predeterminada de autenticación SQL de la guía de instalación, sustituya los requisitos de autenticación solo en la nube por sus credenciales SQL configuradas, mantenga las credenciales fuera del control de versiones y confíe en el certificado autofirmado solo para la conexión local del contenedor. Revisa los cambios en SQL, permisos y esquema generados antes de ejecutarlos.
Cuando estés listo para migrar a Azure, crea una base de datos en Azure SQL Database, despliega tu esquema y datos, y actualiza la configuración de conexión de tu aplicación. Se requiere una suscripción a Azure para los recursos en la nube. La capa gratuita de Azure SQL Database es una opción en la nube separada con sus propias asignaciones y límites.
Antes del despliegue, prueba contra Azure SQL Database en Azure. Las restricciones de vista previa, los valores predeterminados y el soporte de funciones pueden diferir del servicio en la nube. Revisa las limitaciones conocidas.
Limpieza de recursos
Cuando termines, detén el contenedor con su entorno de ejecución o herramienta de desarrollo.
| Runtime | Detener el contenedor | Elimine el contenedor parado |
|---|---|---|
| Docker | docker stop sqldb |
docker rm sqldb |
| Podman | podman stop sqldb |
podman rm sqldb |
| Contenedores de WSL | wslc stop sqldb |
wslc rm sqldb |
| contenedor de Apple | container stop sqldb |
container delete sqldb |
Los comandos de ejecución en este inicio rápido no configuran el almacenamiento persistente. Eliminar el contenedor puede borrar sus archivos de base de datos, así que conserva primero cualquier dato que necesites. Si configuras un volumen de datos por separado, elimínalo solo si tienes intención de eliminar sus datos.