Configurar e personalizar contêineres do SQL Server Linux

Aplica-se a:SQL Server - Linux

Este artigo explica como você pode configurar e personalizar contêineres do SQL Server Linux usando o Docker. Você pode persistir seus dados, mover arquivos de e para contêineres e alterar as configurações padrão.

Dica

Você pode usar sqlcmd (Go) para criar uma nova instância do SQL Server em um contêiner para fins de desenvolvimento. Para obter mais informações, consulte Criar e consultar um contêiner do SQL Server.

Criar um contêiner personalizado

Você pode criar seu próprio Dockerfile para criar um contêiner personalizado do SQL Server. Para obter mais informações, consulte uma demonstração que combina o SQL Server e um aplicativo Node. Se você criar seu próprio Dockerfile, esteja ciente do processo em primeiro plano, porque esse processo controla a vida útil do contêiner. Se ele sair, o contêiner será desligado. Por exemplo, se você quiser executar um script e iniciar o SQL Server, verifique se o processo do SQL Server é o comando mais à direita. Todos os outros comandos são executados em segundo plano. O comando a seguir ilustra isso dentro de um Dockerfile:

/usr/src/app/do-my-sql-commands.sh & /opt/mssql/bin/sqlservr

Se invertesses os comandos no exemplo anterior, o contentor seria desligado quando o script do-my-sql-commands.sh fosse concluído.

Guarde os dados

As alterações de configuração do SQL Server e os arquivos de banco de dados persistem no contêiner mesmo se você reiniciar o contêiner com docker stop e docker start. No entanto, se você remover o contêiner com docker rm, tudo no contêiner será excluído, incluindo o SQL Server e seus bancos de dados. A seção a seguir explica como usar volumes de dados para manter seus arquivos de banco de dados, mesmo se os contêineres associados forem excluídos.

Importante

Para o SQL Server, é fundamental que você entenda a persistência de dados no Docker. Além da discussão nesta seção, consulte a documentação do Docker sobre como gerenciar dados em contêineres do Docker.

Montar um diretório host como volume de dados

A primeira opção é montar um diretório em seu host como um volume de dados em seu contêiner. Para fazer isso, use o comando docker run com o sinalizador -v <host directory>:/var/opt/mssql, onde <host directory> é um determinado caminho. Por exemplo: C:\SQL no Windows, ou ~/sqlvolumes no Linux. Isso permite que os dados sejam restaurados entre as execuções de contêiner.

Observação

Os contêineres para SQL Server 2019 (15.x) e versões posteriores são iniciados automaticamente como não raiz, enquanto os contêineres do SQL Server 2017 (14.x) são iniciados como raiz por padrão. Para obter mais informações sobre como executar contêineres do SQL Server como usuário não raiz, consulte Proteger contêineres do SQL Server Linux.

Importante

A variável de ambiente SA_PASSWORD foi preterida. Use MSSQL_SA_PASSWORD em vez disso.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' \
-p 1433:1433 \
-v <host directory>/data:/var/opt/mssql/data \
-v <host directory>/log:/var/opt/mssql/log \
-v <host directory>/secrets:/var/opt/mssql/secrets \
-d mcr.microsoft.com/mssql/server:2022-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" `
-p 1433:1433 `
-v <host directory>/data:/var/opt/mssql/data `
-v <host directory>/log:/var/opt/mssql/log `
-v <host directory>/secrets:/var/opt/mssql/secrets `
-d mcr.microsoft.com/mssql/server:2022-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" ^
-p 1433:1433 ^
-v <host directory>/data:/var/opt/mssql/data ^
-v <host directory>/log:/var/opt/mssql/log ^
-v <host directory>/secrets:/var/opt/mssql/secrets ^
-d mcr.microsoft.com/mssql/server:2022-latest

Atenção

Sua senha deve seguir a política de senha de padrão do SQL Server. Por padrão, a senha deve ter pelo menos oito caracteres e conter caracteres de três dos quatro conjuntos a seguir: letras maiúsculas, letras minúsculas, dígitos de base 10 e símbolos. As palavras-passe podem ter até 128 caracteres. Use senhas tão longas e complexas quanto possível.

Essa técnica também permite que você compartilhe e visualize os arquivos no host fora do Docker.

Usar contêineres de volume de dados

A segunda opção é usar um contêiner de volume de dados. Você pode criar um contêiner de volume de dados especificando um nome de volume em vez de um diretório host com o parâmetro -v. O exemplo a seguir cria um volume de dados compartilhado chamado sqlvolume.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' \
-p 1433:1433 \
-v sqlvolume:/var/opt/mssql \
-d mcr.microsoft.com/mssql/server:2022-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" `
-p 1433:1433 `
-v sqlvolume:/var/opt/mssql `
-d mcr.microsoft.com/mssql/server:2022-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" ^
-p 1433:1433 ^
-v sqlvolume:/var/opt/mssql ^
-d mcr.microsoft.com/mssql/server:2022-latest

Atenção

Sua senha deve seguir a política de senha de padrão do SQL Server. Por padrão, a senha deve ter pelo menos oito caracteres e conter caracteres de três dos quatro conjuntos a seguir: letras maiúsculas, letras minúsculas, dígitos de base 10 e símbolos. As palavras-passe podem ter até 128 caracteres. Use senhas tão longas e complexas quanto possível.

Essa técnica para criar implicitamente um volume de dados no comando run não funciona com versões mais antigas do Docker. Nesse caso, use as etapas explícitas descritas na documentação do Docker, Criação e montagem de um contêiner de volume de dados.

Mesmo se você parar e remover esse contêiner, o volume de dados persiste. Você pode visualizá-lo com o comando docker volume ls.

docker volume ls

Se você criar outro contêiner com o mesmo nome de volume, o novo contêiner usará os mesmos dados do SQL Server contidos no volume.

Para remover um contêiner de volume de dados, use o comando docker volume rm.

Advertência

Se você excluir o contêiner de volume de dados, todos os dados do SQL Server no contêiner serão excluídos permanentemente.

Backup e restauração

Além dessas técnicas de contêiner, você também pode usar técnicas padrão de backup e restauração do SQL Server. Você pode usar arquivos de backup para proteger seus dados ou para movê-los para outra instância do SQL Server. Para obter mais informações, consulte Fazer backup e restaurar bancos de dados do SQL Server no Linux.

Advertência

Se você criar backups, certifique-se de criar ou copiar os arquivos de backup fora do contêiner. Caso contrário, se o contêiner for removido, os arquivos de backup também serão excluídos.

Habilite o backup e a restauração de VDI em contêineres

As operações de backup e restauração da Virtual Device Interface (VDI) agora têm suporte em implantações de contêiner do SQL Server, começando com CU15 para SQL Server 2019 (15.x) e CU28 para SQL Server 2017 (14.x). Siga estas etapas para habilitar o backup ou restaurações baseados em VDI para contêineres do SQL Server:

1. Ao implantar contêineres do SQL Server, use a opção --shm-size. Para começar, defina o dimensionamento para 1 GB, conforme mostrado no comando a seguir. Substitua <password> por uma senha válida.

   docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" \
   --shm-size 1g \
   -p 1433:1433 \
   --name sql19 \
   --hostname sql19 \
   -d mcr.microsoft.com/mssql/server:2019-latest
   

   A opção --shm-size permite configurar o tamanho do diretório de memória compartilhada (/dev/shm) dentro do contêiner, que é definido como 64 MB por padrão. Esse tamanho padrão da memória compartilhada é insuficiente para suportar backups VDI. Recomendamos que você configure isso para um mínimo de 1 GB ao implantar contêineres do SQL Server e quiser oferecer suporte a backups VDI.

2. Você também deve habilitar o novo parâmetro memory.enablecontainersharedmemory em mssql.conf dentro do contêiner. Você pode montar mssql.conf na implantação do contêiner usando a opção -v, conforme descrito na seção Persista seus dados ou depois de implantar o contêiner atualizando manualmente mssql.conf dentro do contêiner. Aqui está um exemplo de arquivo mssql.conf com a configuração memory.enablecontainersharedmemory definida como true.

   [memory]
   enablecontainersharedmemory = true
   

Copiar arquivos de um contêiner

Para copiar um arquivo para fora do contêiner, use o seguinte comando:

docker cp <Container ID>:<Container path> <host path>

Você pode obter o ID do contêiner executando o comando docker ps -a.

Exemplo:

docker cp d6b75213ef80:/var/opt/mssql/log/errorlog /tmp/errorlog

docker cp d6b75213ef80:/var/opt/mssql/log/errorlog C:\Temp\errorlog

docker cp d6b75213ef80:/var/opt/mssql/log/errorlog C:\Temp\errorlog

Copiar arquivos para um contêiner

Para copiar um arquivo para o contêiner, use o seguinte comando:

docker cp <Host path> <Container ID>:<Container path>

Exemplo:

docker cp /tmp/mydb.mdf d6b75213ef80:/var/opt/mssql/data

docker cp C:\Temp\mydb.mdf d6b75213ef80:/var/opt/mssql/data

docker cp C:\Temp\mydb.mdf d6b75213ef80:/var/opt/mssql/data

Configurar o fuso horário

Para executar o SQL Server em um contêiner Linux com um fuso horário específico, configure a TZ variável de ambiente (consulte Configurar o fuso horário para o SQL Server 2022 e versões posteriores no Linux para obter mais informações). Para encontrar o valor de fuso horário correto, execute o comando tzselect a partir de um prompt bash do Linux:

tzselect

Depois de selecionar o fuso horário, tzselect exibe uma saída semelhante ao exemplo a seguir:

The following information has been given:

    United States
    Pacific

Therefore TZ='America/Los_Angeles' will be used.

Você pode usar essas informações para definir a mesma variável de ambiente em seu contêiner Linux. O exemplo a seguir mostra como executar o SQL Server em um contêiner no fuso horário Americas/Los_Angeles:

sudo docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' \
-p 1433:1433 --name sql1 \
-e 'TZ=America/Los_Angeles' \
-d mcr.microsoft.com/mssql/server:2025-latest

sudo docker run -e 'ACCEPT_EULA=Y' -e "MSSQL_SA_PASSWORD=<password>" `
-p 1433:1433 --name sql1 `
-e "TZ=America/Los_Angeles" `
-d mcr.microsoft.com/mssql/server:2025-latest

sudo docker run -e 'ACCEPT_EULA=Y' -e "MSSQL_SA_PASSWORD=<password>" ^
-p 1433:1433 --name sql1 ^
-e "TZ=America/Los_Angeles" ^
-d mcr.microsoft.com/mssql/server:2025-latest

Atenção

Sua senha deve seguir a política de senha de padrão do SQL Server. Por padrão, a senha deve ter pelo menos oito caracteres e conter caracteres de três dos quatro conjuntos a seguir: letras maiúsculas, letras minúsculas, dígitos de base 10 e símbolos. As palavras-passe podem ter até 128 caracteres. Use senhas tão longas e complexas quanto possível.

Alterar o caminho tempdb

É uma boa prática manter o banco de dados tempdb separado dos bancos de dados de usuários.

1. Conecte-se à instância do SQL Server e execute o seguinte script Transact-SQL (T-SQL). Se houver mais arquivos associados a tempdb, você precisará movê-los também.

   ALTER DATABASE tempdb
       MODIFY FILE (NAME = tempdev, FILENAME = '/var/opt/mssql/tempdb/tempdb.mdf');
   GO
   
   ALTER DATABASE tempdb
       MODIFY FILE (NAME = templog, FILENAME = '/var/opt/mssql/tempdb/templog.ldf');
   GO
   

2. Verifique se o local do arquivo tempdb foi modificado, usando o seguinte script T-SQL:

   SELECT *
   FROM sys.sysaltfiles
   WHERE dbid = 2;
   

3. Você deve reiniciar o contêiner do SQL Server para que essas alterações entrem em vigor.

   docker stop sql1
   docker start sql1
   

   docker stop sql1
   docker start sql1
   

   docker stop sql1
   docker start sql1
   

4. Abra uma sessão de bash interativa para se conectar ao contêiner.

   docker exec -it sql1 bash
   

   docker exec -it sql1 bash
   

   docker exec -it sql1 bash
   

   Uma vez conectado ao shell interativo, execute o seguinte comando para verificar a localização do tempdb:

   ls /var/opt/mssql/tempdb/
   

   Se a mudança foi bem-sucedida, irá ver um resultado semelhante:

   tempdb.mdf templog.ldf
   

Alterar o local do arquivo padrão

Adicione a variável MSSQL_DATA_DIR para alterar o diretório de dados no comando docker run e, em seguida, monte um volume nesse local ao qual o usuário do contêiner tem acesso.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' \
-e 'MSSQL_DATA_DIR=/my/file/path' \
-v /my/host/path:/my/file/path \
-p 1433:1433 \
-d mcr.microsoft.com/mssql/server:2025-latest

docker run -e 'ACCEPT_EULA=Y' -e "MSSQL_SA_PASSWORD=<password>" `
-e "MSSQL_DATA_DIR=/my/file/path" `
-v /my/host/path:/my/file/path `
-p 1433:1433 `
-d mcr.microsoft.com/mssql/server:2025-latest

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" ^
-e "MSSQL_DATA_DIR=/my/file/path" ^
-v /my/host/path:/my/file/path ^
-p 1433:1433 ^
-d mcr.microsoft.com/mssql/server:2025-latest

Usar mssql-config para configurar o SQL Server dentro de um contêiner

Você pode usar a ferramenta mssql-conf para definir parâmetros em contêineres do SQL Server.

Por exemplo, você pode definir um limite de memória para a instância usando as seguintes etapas:

1. Conecte-se diretamente ao contêiner usando docker exec como usuário raiz. Substitua sqlcontainer pelo nome do contêiner.

   docker exec -u root -it sqlcontainer "bash"
   

2. Use mssql-conf para alterar uma configuração. Este exemplo altera a configuração memory.memorylimitmb para 2 GB (2.048 MB).

   /opt/mssql/bin/mssql-conf set memory.memorylimitmb 2048
   

Exemplos de contêineres personalizados do Docker

Para obter exemplos de contêineres personalizados do Docker, consulte https://github.com/microsoft/mssql-docker/tree/master/linux/preview/examples. Os exemplos incluem:

• exemplo do Dockerfile com Full-Text de Pesquisa
• Exemplo de Dockerfile para RHEL 7 e SQL Server 2019
• exemplo do Dockerfile para RHEL 8 e SQL Server 2017
• exemplo de Dockerfile para Ubuntu 20.04 e SQL Server 2019 com Full-Text Search, PolyBase e Tools

Para obter informações sobre como criar e executar contêineres do Docker usando o Dockerfiles, consulte os exemplos de ML Services no GitHub.

Conteúdo relacionado

• Introdução ao SQL Server 2025 (17.x) Visualize imagens de contêiner no Docker passando pelo início rápido

• Implantar e conectar-se a contentores do SQL Server no Linux

• Solucionar problemas de contêineres do SQL Server Docker

• Proteja os contêineres do SQL Server Linux

Contribuir para a documentação SQL

Você sabia que você mesmo pode editar conteúdo SQL? Se o fizer, não só ajudará a melhorar a nossa documentação, como também será creditado como contribuidor da página.

Para obter mais informações, consulte Editar documentação do Microsoft Learn.