Inicio rápido: Ejecución de imágenes de contenedor de SQL Server con Docker

¿Le resultó útil esta página?

¿Tiene comentarios adicionales?

Los comentarios se enviarán a Microsoft: Al presionar el botón Enviar, los comentarios se usarán para mejorar los productos y servicios de Microsoft. Directiva de privacidad.

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.

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

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

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

   

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

5. Como paso final, cambie la contraseña de administrador del sistema porque SA_PASSWORD se ve en la salida de ps -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.

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

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

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

   

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

5. Como paso final, cambie la contraseña de administrador del sistema porque SA_PASSWORD se ve en la salida de ps -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.

1. Elija una contraseña segura que se usará para el usuario SA.

2. 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}")\""
   
   

1. Elija una contraseña segura que se usará para el usuario SA.

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

1. Elija una contraseña segura que se usará para el usuario SA.

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

1. 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 de sql1 al crear el contenedor.

   sudo docker exec -it sql1 "bash"
   

   docker exec -it sql1 "bash"
   

   docker exec -it sql1 "bash"
   

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

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

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

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

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

1. En el símbolo del sistema de sqlcmd, cambie el contexto a la nueva base de datos TestDB:

   USE TestDB
   

2. Cree una tabla llamada Inventory:

   CREATE TABLE Inventory (id INT, name NVARCHAR(50), quantity INT)
   

3. Inserte datos en la nueva tabla:

   INSERT INTO Inventory VALUES (1, 'banana', 150); INSERT INTO Inventory VALUES (2, 'orange', 154);
   

4. Escriba GO para ejecutar los comandos anteriores:

   GO
   

Selección de datos

Ahora ejecute una consulta para devolver datos desde la tabla Inventory.

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

2. Ejecute el comando:

   GO
   

Salida del símbolo del sistema de sqlcmd

1. Para finalizar la sesión de sqlcmd, escriba QUIT:

   QUIT
   

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

1. Busque la dirección IP del equipo host del contenedor mediante ifconfig o ip addr.

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

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

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