Inicio rápido: Ejecución de imágenes de contenedor de SQL Server con Docker
Se aplica a:SQL Server (todas las versiones compatibles) - Linux
En este inicio rápido, se usará Docker para extraer y ejecutar la imagen de contenedor de SQL Server 2017, mssql-server-linux. Después, se podrá conectar con sqlcmd para crear la primera base de datos y ejecutar consultas.
Sugerencia
Si quiere crear contenedores de SQL Server 2019, vea la versión de SQL Server 2019 de este artículo.
Nota
- A partir de SQL Server 2019 CU3, se admite Ubuntu 18.04.
- A partir de SQL Server 2019 CU10, se admite Ubuntu 20.04.
Para más información sobre las plataformas admitidas, consulte Notas de la versión de SQL Server 2019 en Linux.
En este inicio rápido, se usará Docker para extraer y ejecutar la imagen de contenedor de SQL Server 2019, mssql-server-linux. Después, se podrá conectar con sqlcmd para crear la primera base de datos y ejecutar consultas.
Sugerencia
En este inicio rápido se crean contenedores de SQL Server 2019. Si prefiere crear contenedores de SQL Server 2017, vea la versión de SQL Server 2017 de este artículo.
Esta imagen se compone de SQL Server, que se ejecuta en un sistema Linux basado en Ubuntu 20.04. Se puede usar junto al motor de Docker 1.8 o versiones posteriores en Linux.
Nota
En los ejemplos que se muestran a continuación se el comando de docker. Sin embargo, la mayoría de estos comandos también funcionan con Podman, que ofrece una interfaz de línea de comandos (CLI) similar a la del Motor de Docker. Puede obtener más información sobre Podman.
Requisitos previos
- Motor de Docker 1.8 o versiones posteriores en cualquier distribución de Linux admitida. Para obtener más información, consulte Instalar Docker. Para obtener más información sobre los requisitos de hardware y la compatibilidad con procesadores, vea SQL Server 2019: requisitos de hardware y software.
- Controlador de almacenamiento overlay2 de Docker. Este es el valor predeterminado para la mayoría de los usuarios. Si no usa este proveedor de almacenamiento y necesita cambiarlo, consulte las instrucciones y advertencias de la documentación de Docker para configurar overlay2.
- Un mínimo de 2 GB de espacio en disco.
- Un mínimo de 2 GB de RAM.
- Requisitos del sistema para SQL Server en Linux.
Extracción y ejecución de la imagen de contenedor 2017
Antes de iniciar los pasos siguientes, asegúrese de que ha seleccionado el shell preferido (Bash, PowerShell o cmd) en la parte superior de este artículo.
Extraiga la imagen de contenedor de Linux de SQL Server 2017 desde Microsoft Container Registry.
sudo docker pull mcr.microsoft.com/mssql/server:2017-latest
docker pull mcr.microsoft.com/mssql/server:2017-latest
docker pull mcr.microsoft.com/mssql/server:2017-latest
Sugerencia
Si quiere crear contenedores de SQL Server 2019, vea la versión de SQL Server 2019 de este artículo.
En el comando anterior, se extrae la última imagen de contenedor de SQL Server 2017. Si quiere extraer una imagen específica, agregue dos puntos y el nombre de etiqueta (por ejemplo,
mcr.microsoft.com/mssql/server:2017-GA-ubuntu
). Para ver todas las imágenes disponibles, vea la página de Docker Hub de mssql-server.En los comandos de Bash de este artículo se usa
sudo
. Si no quiere usarsudo
para ejecutar Docker, puede configurar un grupo docker y agregarle usuarios. Para obtener más información, vea Pasos posteriores a la instalación para Linux.Para ejecutar la imagen de contenedor con Docker, puede usar el siguiente comando desde un shell de Bash, o bien una línea de comandos de PowerShell con privilegios elevados.
sudo docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=<YourStrong@Passw0rd>" \ -p 1433:1433 --name sql1 --hostname sql1 \ -d \ mcr.microsoft.com/mssql/server:2017-latest
Nota
Si usa PowerShell Core, reemplace las comillas dobles por comillas simples.
docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=<YourStrong@Passw0rd>" ` -p 1433:1433 --name sql1 --hostname sql1 ` -d ` mcr.microsoft.com/mssql/server:2017-latest
docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=<YourStrong@Passw0rd>" ` -p 1433:1433 --name sql1 --hostname sql1 ` -d ` mcr.microsoft.com/mssql/server:2017-latest
Nota
La contraseña debe seguir la directiva de contraseñas predeterminada de SQL Server. En caso contrario, el contenedor no podrá instalar SQL Server y dejará de funcionar. De forma predeterminada, la contraseña debe tener al menos 8 caracteres y contener caracteres de tres de los cuatro conjuntos siguientes: Letras mayúsculas, letras minúsculas, dígitos de Base 10 y símbolos. Puede examinar el registro de errores ejecutando el comando docker logs.
De forma predeterminada, se creará un contenedor con la edición para desarrolladores de SQL Server 2017. El proceso para ejecutar las ediciones de producción en contenedores es ligeramente diferente. Para obtener más información, vea Run production container image (Ejecutar imágenes de contenedor de producción).
En la tabla siguiente, se proporciona una descripción de los parámetros del ejemplo de
docker run
anterior:Parámetro Descripción -e "ACCEPT_EULA=Y" Establezca la variable ACCEPT_EULA en cualquier valor para confirmar que acepta el Contrato de licencia de usuario final. Configuración requerida para la imagen de SQL Server. -e "SA_PASSWORD=<YourStrong@Passw0rd>" Especifique su propia contraseña segura con al menos ocho caracteres y que cumpla los requisitos de contraseña de SQL Server. Configuración requerida para la imagen de SQL Server. -p 1433:1433 Asigne un puerto TCP en el entorno de host (el primer valor) a un puerto TCP en el contenedor (el segundo valor). En este ejemplo, SQL Server escucha en TCP 1433 en el contenedor y se expone al puerto 1433 del host. --name sql1 Especifique un nombre personalizado para el contenedor en lugar de uno generado aleatoriamente. Si ejecuta más de un contenedor, no podrá usar el mismo nombre. --hostname sql1 Se usa para establecer explícitamente el nombre de host del contenedor. Si no especifica el nombre de host, se adopta como predeterminado el identificador del contenedor, que es un GUID del sistema generado aleatoriamente. -d Ejecute el contenedor en segundo plano (demonio). mcr.microsoft.com/mssql/server:2017-latest La imagen de contenedor de SQL Server 2017 para Linux. Para ver los contenedores de Docker, use el comando
docker ps
.sudo docker ps -a
docker ps -a
docker ps -a
Debería ver un resultado similar al de la captura de pantalla siguiente:
Si la columna ESTADO muestra el estado Activo, esto indica que SQL Server se está ejecutando en el contenedor y que está escuchando en el puerto especificado en la columna PUERTOS. Si la columna ESTADO de su contenedor de SQL Server muestra Cerrado, consulte la sección Solución de problemas de la guía de configuración. Estará listo para la conexión, una vez que los registros de errores de SQL Server muestren el mensaje:
SQL Server is now ready for client connections. This is an informational message; no user action is required
. Puede revisar el registro de errores de SQL Server dentro del contenedor utilizando el comando:docker exec -t sql1 cat /var/opt/mssql/log/errorlog | grep connection
El parámetro --hostname
, tal y como se indicó anteriormente, cambia el nombre interno del contenedor a un valor personalizado. Este es el nombre que verá que se devuelve en la siguiente consulta de Transact-SQL:
SELECT @@SERVERNAME,
SERVERPROPERTY('ComputerNamePhysicalNetBIOS'),
SERVERPROPERTY('MachineName'),
SERVERPROPERTY('ServerName')
Establecer --hostname
y --name
en el mismo valor es una buena manera de identificar fácilmente el contenedor de destino.
- Como paso final, cambie la contraseña de administrador del sistema porque
SA_PASSWORD
se ve en la salida deps -eax
y se almacena en la variable de entorno con el mismo nombre. Vea los pasos siguientes.
Extracción y ejecución de la imagen de contenedor 2019
Antes de iniciar los pasos siguientes, asegúrese de que ha seleccionado el shell preferido (Bash, PowerShell o cmd) en la parte superior de este artículo.
Extraiga la imagen de contenedor de Linux de SQL Server 2019 desde Microsoft Container Registry.
sudo docker pull mcr.microsoft.com/mssql/server:2019-latest
Nota
Si usa PowerShell Core, reemplace las comillas dobles por comillas simples.
docker pull mcr.microsoft.com/mssql/server:2019-latest
docker pull mcr.microsoft.com/mssql/server:2019-latest
Sugerencia
En este inicio rápido se usa la imagen de Docker de SQL Server 2019. Si quiere ejecutar la imagen de SQL Server 2017, vea la versión de SQL Server 2017 de este artículo.
El comando anterior extrae la imagen de contenedor de SQL Server 2019 basada en Ubuntu. Para usar en su lugar imágenes de contenedor basadas en RedHat, vea Ejecución de imágenes de contenedor basadas en RHEL. Para ver todas las imágenes disponibles, vea la página mssql-server-linux de Docker Hub.
En los comandos de Bash de este artículo se usa
sudo
. Si no quiere usarsudo
para ejecutar Docker, puede configurar un grupo docker y agregarle usuarios. Para obtener más información, vea Pasos posteriores a la instalación para Linux.Para ejecutar la imagen de contenedor con Docker, puede usar el siguiente comando desde un shell de Bash, o bien una línea de comandos de PowerShell con privilegios elevados.
sudo docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=<YourStrong@Passw0rd>" \ -p 1433:1433 --name sql1 --hostname sql1 \ -d mcr.microsoft.com/mssql/server:2019-latest
docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=<YourStrong@Passw0rd>" ` -p 1433:1433 --name sql1 --hostname sql1 ` -d mcr.microsoft.com/mssql/server:2019-latest
docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=<YourStrong@Passw0rd>" ` -p 1433:1433 --name sql1 --hostname sql1 ` -d mcr.microsoft.com/mssql/server:2019-latest
Nota
La contraseña debe seguir la directiva de contraseñas predeterminada de SQL Server. En caso contrario, el contenedor no podrá instalar SQL Server y dejará de funcionar. De forma predeterminada, la contraseña debe tener al menos 8 caracteres y contener caracteres de tres de los cuatro conjuntos siguientes: Letras mayúsculas, letras minúsculas, dígitos de Base 10 y símbolos. Puede examinar el registro de errores ejecutando el comando docker logs.
De forma predeterminada, se creará un contenedor con la edición para desarrolladores de SQL Server 2019.
En la tabla siguiente, se proporciona una descripción de los parámetros del ejemplo de
docker run
anterior:Parámetro Descripción -e "ACCEPT_EULA=Y" Establezca la variable ACCEPT_EULA en cualquier valor para confirmar que acepta el Contrato de licencia de usuario final. Configuración requerida para la imagen de SQL Server. -e "SA_PASSWORD=<YourStrong@Passw0rd>" Especifique su propia contraseña segura con al menos ocho caracteres y que cumpla los requisitos de contraseña de SQL Server. Configuración requerida para la imagen de SQL Server. -p 1433:1433 Asigne un puerto TCP en el entorno de host (el primer valor) a un puerto TCP en el contenedor (el segundo valor). En este ejemplo, SQL Server escucha en TCP 1433 en el contenedor y se expone al puerto 1433 del host. --name sql1 Especifique un nombre personalizado para el contenedor en lugar de uno generado aleatoriamente. Si ejecuta más de un contenedor, no podrá usar el mismo nombre. --hostname sql1 Se usa para establecer explícitamente el nombre de host del contenedor. Si no especifica el nombre de host, se adopta como predeterminado el identificador del contenedor, que es un GUID del sistema generado aleatoriamente. mcr.microsoft.com/mssql/server:2019-latest Imagen de contenedor de Ubuntu Linux de SQL Server 2019. Para ver los contenedores de Docker, use el comando
docker ps
.sudo docker ps -a
docker ps -a
docker ps -a
Debería ver un resultado similar al de la captura de pantalla siguiente:
Si la columna ESTADO muestra el estado Activo, esto indica que SQL Server se está ejecutando en el contenedor y que está escuchando en el puerto especificado en la columna PUERTOS. Si la columna ESTADO de su contenedor de SQL Server muestra Cerrado, consulte la sección Solución de problemas de la guía de configuración. Estará listo para la conexión, una vez que los registros de errores de SQL Server muestren el mensaje:
SQL Server is now ready for client connections. This is an informational message; no user action is required
. Puede revisar el registro de errores de SQL Server dentro del contenedor utilizando el comando:docker exec -t sql1 cat /var/opt/mssql/log/errorlog | grep connection
El parámetro --hostname
, tal y como se indicó anteriormente, cambia el nombre interno del contenedor a un valor personalizado. Esto cambia el nombre interno del contenedor a un valor personalizado. Este es el nombre que verá que se devuelve en la siguiente consulta de Transact-SQL:
SELECT @@SERVERNAME,
SERVERPROPERTY('ComputerNamePhysicalNetBIOS'),
SERVERPROPERTY('MachineName'),
SERVERPROPERTY('ServerName')
Establecer -h
y --name
en el mismo valor es una buena manera de identificar fácilmente el contenedor de destino.
- Como paso final, cambie la contraseña de administrador del sistema porque
SA_PASSWORD
se ve en la salida deps -eax
y se almacena en la variable de entorno con el mismo nombre. Vea los pasos siguientes.
Cambiar la contraseña de SA
La cuenta SA es un administrador del sistema en la instancia de SQL Server que se crea durante la instalación. Después de crear el contenedor de SQL Server, la variable de entorno SA_PASSWORD
especificada se reconoce mediante la ejecución de echo $SA_PASSWORD
en el contenedor. Por motivos de seguridad, cambie la contraseña de administrador del sistema.
Elija una contraseña segura que se usará para el usuario SA.
Use
docker exec
para ejecutar sqlcmd a fin de cambiar la contraseña mediante Transact-SQL. En el ejemplo siguiente, la contraseña anterior y la nueva se leen de la entrada del usuario.sudo docker exec -it sql1 /opt/mssql-tools/bin/sqlcmd \ -S localhost -U SA \ -P "$(read -sp "Enter current SA password: "; echo "${REPLY}")" \ -Q "ALTER LOGIN SA WITH PASSWORD=\"$(read -sp "Enter new SA password: "; echo "${REPLY}")\""
Elija una contraseña segura que se usará para el usuario SA.
En el ejemplo siguiente, reemplace la contraseña anterior,
<YourStrong@Passw0rd>
, y la nueva contraseña,<YourNewStrong@Passw0rd>
, por sus propios valores de contraseña.docker exec -it sql1 /opt/mssql-tools/bin/sqlcmd ` -S localhost -U SA -P "<YourStrong@Passw0rd>" ` -Q "ALTER LOGIN SA WITH PASSWORD='<YourNewStrong@Passw0rd>'"
Elija una contraseña segura que se usará para el usuario SA.
En el ejemplo siguiente, reemplace la contraseña anterior,
<YourStrong@Passw0rd>
, y la nueva contraseña,<YourNewStrong@Passw0rd>
, por sus propios valores de contraseña.docker exec -it sql1 /opt/mssql-tools/bin/sqlcmd ` -S localhost -U SA -P "<YourStrong@Passw0rd>" ` -Q "ALTER LOGIN SA WITH PASSWORD='<YourNewStrong@Passw0rd>'"
Conectar a SQL Server
En los pasos siguientes se usa la herramienta de línea de comandos sqlcmd de SQL Server, dentro del contenedor para conectarse a SQL Server.
Use el comando
docker exec -it
para iniciar un shell de Bash interactivo dentro de su contenedor en ejecución. En el ejemplo siguiente, el parámetro--name
especifica el nombre desql1
al crear el contenedor.sudo docker exec -it sql1 "bash"
docker exec -it sql1 "bash"
docker exec -it sql1 "bash"
Una vez dentro del contenedor, conéctese localmente con sqlcmd mediante su ruta de acceso completa.
/opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P "<YourNewStrong@Passw0rd>"
Sugerencia
Puede omitir la contraseña en la línea de comandos para que se le solicite escribirla.
Si se realiza correctamente, debe ver un símbolo de sistema de sqlcmd:
1>
.
Creación y consulta de datos
En las secciones siguientes se le guía por el uso de sqlcmd y Transact-SQL para crear una base de datos, agregar datos y ejecutar una consulta.
Creación de una base de datos
En los pasos siguientes se crea una base de datos denominada TestDB
.
En el símbolo del sistema de sqlcmd, pegue el comando Transact-SQL siguiente para crear una base de datos de prueba:
CREATE DATABASE TestDB
En la línea siguiente, escriba una consulta para devolver el nombre de todas las bases de datos del servidor:
SELECT Name from sys.Databases
Los dos comandos anteriores no se ejecutaron de inmediato. Escriba
GO
en una línea nueva para ejecutar los comandos anteriores:GO
Insertar datos
Luego cree una tabla, Inventory
, e inserte dos filas nuevas.
En el símbolo del sistema de sqlcmd, cambie el contexto a la nueva base de datos
TestDB
:USE TestDB
Cree una tabla llamada
Inventory
:CREATE TABLE Inventory (id INT, name NVARCHAR(50), quantity INT)
Inserte datos en la nueva tabla:
INSERT INTO Inventory VALUES (1, 'banana', 150); INSERT INTO Inventory VALUES (2, 'orange', 154);
Escriba
GO
para ejecutar los comandos anteriores:GO
Selección de datos
Ahora ejecute una consulta para devolver datos desde la tabla Inventory
.
En el símbolo del sistema sqlcmd, escriba una consulta que devuelva filas desde la tabla
Inventory
donde la cantidad sea mayor que 152:SELECT * FROM Inventory WHERE quantity > 152;
Ejecute el comando:
GO
Salida del símbolo del sistema de sqlcmd
Para finalizar la sesión de sqlcmd, escriba
QUIT
:QUIT
Para salir de la línea de comandos interactiva del contenedor, escriba
exit
. El contenedor continuará ejecutándose después de salir del shell de Bash interactivo.
Conectarse desde fuera del contenedor
También puede conectarse a la instancia de SQL Server en la máquina de Docker desde cualquier herramienta externa de Linux, Windows o Mac OS que admita conexiones de SQL.
En los pasos siguientes, se usa sqlcmd fuera de su contenedor para conectarse a la instancia de SQL Server que se ejecuta en el contenedor. En estos pasos, se presupone que ya dispone de las herramientas de línea de comandos de SQL Server instaladas fuera de su contenedor. Se aplican los mismos principios que al usar otras herramientas, pero el proceso de conexión es único para cada herramienta.
Busque la dirección IP del equipo host del contenedor mediante ifconfig o ip addr.
En este ejemplo, instale la herramienta sqlcmd en el equipo cliente. Para obtener más información, vea Instalación de sqlcmd en Windows o Instalación de sqlcmd en Linux.
Ejecute sqlcmd especificando la dirección IP y el puerto asignado al puerto 1433 en el contenedor. En este ejemplo se trata del mismo puerto, 1433, que en el equipo host. Si ha especificado otro puerto asignado en el equipo host, se usa aquí. También tendrá que abrir el puerto de entrada adecuado en el firewall para permitir la conexión.
sqlcmd -S <ip_address>,1433 -U SA -P "<YourNewStrong@Passw0rd>"
sqlcmd -S <ip_address>,1433 -U SA -P "<YourNewStrong@Passw0rd>"
sqlcmd -S <ip_address>,1433 -U SA -P "<YourNewStrong@Passw0rd>"
Ejecute los comandos Transact-SQL. Cuando termine, escriba
QUIT
.
Estas son otras herramientas de uso común para conectarse a SQL Server:
- Visual Studio Code
- SQL Server Management Studio (SSMS) en Windows
- Azure Data Studio
- mssql-cli (versión preliminar)
- PowerShell Core
Quitar el contenedor
Si quiere quitar el contenedor de SQL Server que se usa en este tutorial, ejecute los comandos siguientes:
sudo docker stop sql1
sudo docker rm sql1
docker stop sql1
docker rm sql1
docker stop sql1
docker rm sql1
Advertencia
Al detener y quitar un contenedor, se eliminarán permanentemente los datos de SQL Server que contenga. Si tiene que conservar sus datos, cree un archivo de copia de seguridad y cópielo en una ubicación externa al contenedor, o bien use una técnica de persistencia de datos de contenedor.
Demostración de Docker
Tras haber intentado usar la imagen de contenedor de SQL Server en Docker, puede que quiera saber cómo usar Docker para mejorar el desarrollo y las pruebas. En el vídeo siguiente se muestra cómo se puede usar Docker en un escenario de implementación e integración continuas.
Pasos siguientes
Para ver un tutorial sobre cómo restaurar archivos de copia de seguridad de bases de datos en un contenedor, consulte Restore a SQL Server database in a Linux Docker container (Restaurar una base de datos de SQL Server en un contenedor de Docker en Linux). Explore otros escenarios, como la ejecución de varios contenedores, la persistencia de datos y la solución de problemas.
También puede consultar el repositorio de Github mssql-docker para ver una serie de recursos, comentarios y problemas conocidos.