Implementación y conexión a contenedores de Linux de SQL Server

Se aplica a: SQL Server - Linux

En este artículo se explica cómo implementar y conectarse a contenedores de Linux de SQL Server.

Para otros escenarios de implementación, consulte:

• Windows
• Linux
• Clúster de contenedor en Azure

En este vídeo de 6 minutos se muestra una introducción a la ejecución de SQL Server en contenedores:

Extraer y ejecutar la imagen de contenedor

Para extraer y ejecutar las imágenes de contenedor de Docker para SQL Server, siga los requisitos previos y los pasos descritos en las siguientes guías de inicio rápido:

• Inicio rápido: Ejecución de imágenes de contenedor de SQL Server con Docker (SQL Server 2017)
• Ejecución de imágenes de contenedor de SQL Server 2019 con Docker
• Ejecución de imágenes de contenedor de SQL Server 2022 para Linux con Docker

En este artículo de configuración se proporcionan escenarios de uso adicionales en las secciones siguientes.

Conexión y consultas

Puede conectarse a SQL Server y realizar consultas en un contenedor desde fuera o desde dentro del contenedor. En las siguientes secciones se explican ambos escenarios.

Herramientas fuera del contenedor

Puede conectarse a la instancia de SQL Server en el host de contenedor desde cualquier herramienta externa de Linux, Windows o macOS que admita conexiones de SQL. Algunas herramientas comunes son:

• sqlcmd
• Azure Data Studio
• Visual Studio Code
• SQL Server Management Studio (SSMS) en Windows

En el ejemplo siguiente se usa sqlcmd para conectarse a una instancia de SQL Server que se ejecuta en un contenedor. La dirección IP de la cadena de conexión es la dirección IP del equipo host que ejecuta el contenedor.

sqlcmd -S 10.3.2.4 -U SA -P '<YourPassword>'

sqlcmd -S 10.3.2.4 -U SA -P "<YourPassword>"

sqlcmd -S 10.3.2.4 -U SA -P "<YourPassword>"

Si asignó un puerto de host distinto del valor predeterminado 1433, agréguelo a la cadena de conexión. Por ejemplo, si especificó -p 1400:1433 en el comando docker run, establezca de forma explícita el puerto 1400.

sqlcmd -S 10.3.2.4,1400 -U SA -P '<YourPassword>'

sqlcmd -S 10.3.2.4,1400 -U SA -P "<YourPassword>"

sqlcmd -S 10.3.2.4,1400 -U SA -P "<YourPassword>"

Herramientas dentro del contenedor

A partir de SQL Server 2017 (14.x), las herramientas de línea de comandos de SQL Server se incluyen en la imagen de contenedor. Si se asocia a la imagen con un símbolo del sistema interactivo, puede ejecutar las herramientas de forma local.

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, e69e056c702d es el identificador del contenedor.

   docker exec -it e69e056c702d "bash"
   

   Sugerencia

   No siempre tiene que especificar el id. completo del contenedor. Solo tiene que especificar suficientes caracteres para identificarlo de forma única. Por tanto, en este ejemplo, podría ser suficiente usar e6 o e69 en lugar del id. completo. Para averiguar el id. del contenedor, ejecute el comando docker ps -a.

2. Una vez dentro del contenedor, conéctese localmente con sqlcmd mediante su ruta de acceso completa.

   /opt/mssql-tools18/bin/sqlcmd -S localhost -U SA -P '<YourPassword>'
   

   Nota

   Las versiones más recientes de sqlcmd están protegidas de manera predeterminada. Para obtener más información sobre el cifrado de conexión, consulte Utilidad de sqlcmd para Windows y Conexión con sqlcmd para Linux y macOS. Si la conexión no se realiza correctamente, puede agregar la opción -No a sqlcmd para especificar que el cifrado es opcional, no obligatorio.

3. Cuando termine con sqlcmd, escriba exit.

4. Cuando termine con el símbolo del sistema interactivo, escriba exit. El contenedor continuará ejecutándose después de salir del shell de Bash interactivo.

Comprobación de la versión de contenedor

Si quiere conocer la versión de SQL Server en un contenedor en ejecución, ejecute el siguiente comando para mostrarla. Reemplace <Container ID or name> por el identificador o el nombre del contenedor de destino. Reemplace <YourStrong!Passw0rd> por la contraseña de SQL Server de la cuenta del administrador del sistema.

docker exec -it <Container ID or name> /opt/mssql-tools/bin/sqlcmd \
-S localhost -U SA -P '<YourStrong!Passw0rd>' \
-Q 'SELECT @@VERSION'

docker exec -it <Container ID or name> /opt/mssql-tools/bin/sqlcmd `
-S localhost -U SA -P "<YourStrong!Passw0rd>" `
-Q "SELECT @@VERSION"

docker exec -it <Container ID or name> /opt/mssql-tools/bin/sqlcmd ^
-S localhost -U SA -P "<YourStrong!Passw0rd>" ^
-Q "SELECT @@VERSION"

También puede identificar la versión de SQL Server y el número de compilación de una imagen de contenedor de destino. El siguiente comando muestra la versión de SQL Server y la información de compilación de la imagen mcr.microsoft.com/mssql/server:2022-latest. Para ello, ejecuta un nuevo contenedor con una variable de entorno PAL_PROGRAM_INFO=1. El contenedor resultante se cierra al instante y el comando docker rm lo quita.

docker run -e PAL_PROGRAM_INFO=1 --name sqlver \
-ti mcr.microsoft.com/mssql/server:2022-latest && \
docker rm sqlver

docker run -e PAL_PROGRAM_INFO=1 --name sqlver `
-ti mcr.microsoft.com/mssql/server:2022-latest; `
docker rm sqlver

docker run -e PAL_PROGRAM_INFO=1 --name sqlver ^
-ti mcr.microsoft.com/mssql/server:2022-latest && ^
docker rm sqlver

Los comandos anteriores muestran información de versión similar a la siguiente salida:

sqlservr
  Version 16.0.1000.6
  Build ID d81e9b6de06534e649bd57dd609aa3050f5e380f361b7f8a80a80eeb71e7422c
  Build Type release
  Git Version 2aede92f
  Built at Tue Nov 01 06:11:40 GMT 2022

PAL
  Build ID 754097e8f0db68f559e1cbc9d46952ac9fd518b5da9f12964ef40fc9033720e3
  Build Type release
  Git Version d88e3e1130
  Built at Tue Nov 01 06:08:02 GMT 2022

Packages
  system.security                         mssql-16.0.1000.6_26_official-release
  system.certificates                     mssql-16.0.1000.6_26_official-release
  sqlagent                                16.0.1000.6
  system.wmi                              10.0.17763.2061.202107231
  system.netfx                            4.7.0.0.202104262
  system                                  mssql-16.0.1000.6_26_official-release
  system.common                           10.0.17763.2061.202107231
  sqlservr                                16.0.1000.6
  secforwarderxplat                       16.0.1000.6

Ejecución de una imagen de contenedor de SQL Server determinada

Hay escenarios en los que es posible que no quiera usar la imagen de contenedor de SQL Server más reciente. Para ejecutar una imagen de contenedor de SQL Server determinada, siga estos pasos:

1. Identifique la tag de Docker para la versión que quiere usar. Para ver las etiquetas disponibles, consulte el Registro de artefactos Microsoft.

2. Extraiga la imagen de contenedor de SQL Server con la etiqueta. Por ejemplo, para extraer la imagen 2019-CU18-ubuntu-20.04, reemplace <image_tag> en el comando siguiente por 2019-CU18-ubuntu-20.04.

   docker pull mcr.microsoft.com/mssql/server:<image_tag>
   

3. Para ejecutar un nuevo contenedor con esa imagen, especifique el nombre de la etiqueta en el comando docker run. En el siguiente comando, reemplace <image_tag> por la versión que quiere ejecutar.

   Importante

   La variable de entorno SA_PASSWORD está en desuso. En su lugar, use MSSQL_SA_PASSWORD.

   docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>' -p 1401:1433 -d mcr.microsoft.com/mssql/server:<image_tag>
   

   docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1401:1433 -d mcr.microsoft.com/mssql/server:<image_tag>
   

   docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1401:1433 -d mcr.microsoft.com/mssql/server:<image_tag>
   

Estos pasos también se pueden usar para degradar un contenedor existente. Por ejemplo, puede que quiera revertir o degradar un contenedor en ejecución para solucionar problemas o realizar pruebas. Para degradar un contenedor en ejecución, debe usar una técnica de persistencia para la carpeta de datos. Siga los mismos pasos descritos en la sección de actualización, pero especifique el nombre de etiqueta de la versión anterior al ejecutar el nuevo contenedor.

docker pull mcr.microsoft.com/mssql/rhel/server:2019-CU18-rhel-8.4

docker pull mcr.microsoft.com/mssql/rhel/server:2019-CU18-rhel-8.4

docker pull mcr.microsoft.com/mssql/rhel/server:2019-CU18-rhel-8.4

Ejecución de imágenes de contenedor de producción

En el inicio rápido de la sección anterior se ejecuta la edición para desarrolladores gratuita de SQL Server del Registro de artefactos Microsoft. La mayor parte de la información sigue siendo aplicable si quiere ejecutar imágenes de contenedor de producción, como las ediciones Enterprise, Standard o Web. Pero hay algunas diferencias que se describen aquí.

• Solo puede usar SQL Server en un entorno de producción si tiene una licencia válida. Puede obtener una licencia de producción gratuita de SQL Server Express aquí. Las licencias de edición SQL Server Standard y Enterprise están disponibles mediante licencias por volumen de Microsoft.

• La imagen de contenedor para desarrolladores también se puede configurar para que ejecute las ediciones de producción.

Para ejecutar una edición de producción, revise los requisitos y los procedimientos de ejecución en el inicio rápido. Debe especificar la edición de producción con la variable de entorno MSSQL_PID. En el ejemplo siguiente se muestra cómo ejecutar la imagen de contenedor más reciente de SQL Server 2022 (16.x) para la edición Enterprise Core.

docker run --name sqlenterprise \
-e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>' \
-e 'MSSQL_PID=EnterpriseCore' -p 1433:1433 \
-d mcr.microsoft.com/mssql/server:2022-latest

docker run --name sqlenterprise `
-e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" `
-e "MSSQL_PID=EnterpriseCore" -p 1433:1433 `
-d "mcr.microsoft.com/mssql/server:2022-latest"

docker run --name sqlenterprise ^
-e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" ^
-e "MSSQL_PID=EnterpriseCore" -p 1433:1433 ^
-d "mcr.microsoft.com/mssql/server:2022-latest"

Ejecución de varios contenedores de SQL Server

Docker proporciona una manera de ejecutar varios contenedores de SQL Server en el mismo equipo host. Use este enfoque para escenarios en los que se requieran varias instancias de SQL Server en el mismo host. Cada contenedor debe exponerse en un puerto diferente.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>' -p 1401:1433 -d mcr.microsoft.com/mssql/server:2017-latest
docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>' -p 1402:1433 -d mcr.microsoft.com/mssql/server:2017-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1401:1433 -d mcr.microsoft.com/mssql/server:2017-latest
docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1402:1433 -d mcr.microsoft.com/mssql/server:2017-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1401:1433 -d mcr.microsoft.com/mssql/server:2017-latest
docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1402:1433 -d mcr.microsoft.com/mssql/server:2017-latest

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>' -p 1401:1433 -d mcr.microsoft.com/mssql/server:2019-latest
docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>' -p 1402:1433 -d mcr.microsoft.com/mssql/server:2019-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1401:1433 -d mcr.microsoft.com/mssql/server:2019-latest
docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1402:1433 -d mcr.microsoft.com/mssql/server:2019-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1401:1433 -d mcr.microsoft.com/mssql/server:2019-latest
docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1402:1433 -d mcr.microsoft.com/mssql/server:2019-latest

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>' -p 1401:1433 -d mcr.microsoft.com/mssql/server:2022-latest
docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>' -p 1402:1433 -d mcr.microsoft.com/mssql/server:2022-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1401:1433 -d mcr.microsoft.com/mssql/server:2022-latest
docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1402:1433 -d mcr.microsoft.com/mssql/server:2022-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1401:1433 -d mcr.microsoft.com/mssql/server:2022-latest
docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong!Passw0rd>" -p 1402:1433 -d mcr.microsoft.com/mssql/server:2022-latest

Ahora hay dos instancias de SQL Server que se ejecutan en contenedores independientes. Los clientes pueden conectarse a cada instancia de SQL Server mediante la dirección IP del host de contenedor y el número de puerto del contenedor.

sqlcmd -S 10.3.2.4,1401 -U SA -P '<YourPassword>'
sqlcmd -S 10.3.2.4,1402 -U SA -P '<YourPassword>'

sqlcmd -S 10.3.2.4,1401 -U SA -P "<YourPassword>"
sqlcmd -S 10.3.2.4,1402 -U SA -P "<YourPassword>"

sqlcmd -S 10.3.2.4,1401 -U SA -P "<YourPassword>"
sqlcmd -S 10.3.2.4,1402 -U SA -P "<YourPassword>"

Actualización de SQL Server en contenedores

Para actualizar la imagen de contenedor con Docker, primero identifique la etiqueta de la versión de la actualización. Extraiga esta versión del registro con el comando docker pull:

docker pull mcr.microsoft.com/mssql/server:<image_tag>

Esto actualiza la imagen de SQL Server para los nuevos contenedores que cree, pero no actualiza SQL Server en ningún contenedor en ejecución. Para ello, debe crear un nuevo contenedor con la imagen de contenedor de SQL Server más reciente y migrar los datos a ese nuevo contenedor.

1. Asegúrese de que usa una de las técnicas de persistencia de datos para el contenedor de SQL Server existente. Esto le permite iniciar un nuevo contenedor con los mismos datos.

2. Detenga el contenedor de SQL Server con el comando docker stop.

3. Cree un nuevo contenedor de SQL Server con docker run y especifique un directorio de host asignado o un contenedor de volúmenes de datos. Asegúrese de usar la etiqueta específica para la actualización de SQL Server. El nuevo contenedor ahora usa una nueva versión de SQL Server con los datos de SQL Server existentes.

   Importante

   La actualización solo se admite entre RC1, RC2 y GA en este momento.

4. Compruebe las bases de datos y los datos del nuevo contenedor.

5. Opcionalmente, quite el contenedor anterior con docker rm.

Contenido relacionado

• Referencia de la configuración y personalización adicionales para contenedores de Docker
• Vea el repositorio mssql-docker de GitHub para obtener recursos, comentarios y problemas conocidos.
• Solución de problemas de contenedores de Docker de SQL Server
• Explore la Alta disponibilidad para contenedores de SQL Server
• Protección de contenedores de Docker de SQL Server

Contribuya a la documentación de SQL

¿Sabía que puede editar el contenido de SQL usted mismo? Si lo hace, no solo contribuirá a mejorar la documentación, sino que también se le reconocerá como colaborador de la página.

Para más información, vea Cómo colaborar en la documentación de SQL Server.