Definir configurações do SQL Server com variáveis de ambiente em Linux

Aplica-se a: SQL Server no Linux

Você pode usar várias variáveis de ambiente diferentes para configurar o SQL Server no Linux. Essas variáveis são usadas em dois cenários:

Tip

Se você precisar configurar o SQL Server após esses cenários de instalação, confira Configurar o SQL Server em Linux com a ferramenta mssql-conf.

Variáveis de ambiente

Variável de ambiente Description
ACCEPT_EULA Defina a variável ACCEPT_EULA para qualquer valor para confirmar a aceitação do Contrato de Licença de Usuário Final. Configuração exigida para a imagem do SQL Server.
MSSQL_SA_PASSWORD Configura a sa senha.

A variável de ambiente SA_PASSWORD foi preterida. Use MSSQL_SA_PASSWORD em seu lugar.
MSSQL_DB Define o nome de um banco de dados a ser criado na inicialização do contêiner.
MSSQL_USER Se MSSQL_DB estiver definido, define o nome de um usuário que não seja sa a ser criado na inicialização do contêiner. O usuário recebe direitos de acesso no MSSQL_DB banco de dados. Se essa variável for usada, MSSQL_PASSWORD também deverá ser definida. Se MSSQL_DB não estiver definido, essa variável será ignorada.
MSSQL_PASSWORD Define a senha do usuário cujo nome está em MSSQL_USER. Se essa variável for usada, MSSQL_USER também deverá ser definida. Se MSSQL_DB não estiver definido, essa variável será ignorada.
MSSQL_PID Define a SQL Server edition ou chave do produto. Os valores possíveis são listados na tabela de edições do SQL Server a seguir. Se você especificar uma chave do produto, ela deverá estar na forma de #####-#####-#####-#####-#####, onde # está um número ou uma letra.
MSSQL_LCID Define a ID de idioma a ser usada para o SQL Server. Por exemplo, 1036 é francês.
MSSQL_COLLATION Define a ordenação padrão para o SQL Server. Essa configuração substitui o mapeamento padrão do LCID (ID de idioma) na ordenação.
MSSQL_MEMORY_LIMIT_MB Define a quantidade máxima de memória (em MB) que o SQL Server pode usar. Por padrão, essa quantidade corresponde a 80% da memória física total.
MSSQL_TCP_PORT Configura a porta TCP que SQL Server escuta (padrão 1433).
MSSQL_IP_ADDRESS Define o endereço IP. Atualmente, o endereço IP deve ser no estilo IPv4 (0.0.0.0).
MSSQL_BACKUP_DIR Define o local do diretório de backup padrão.
MSSQL_DATA_DIR Altera o diretório em que os novos arquivos de dados do banco de dados SQL Server (.mdf) são criados.
MSSQL_LOG_DIR Altera o diretório em que os novos arquivos de log de banco de dados SQL Server (.ldf) são criados.
MSSQL_DUMP_DIR Altera o diretório em que SQL Server deposita os despejos de memória e outros arquivos de solução de problemas por padrão.
MSSQL_ENABLE_HADR Habilita grupos de disponibilidade. Por exemplo, 1 habilita e 0 desabilita o recurso.
MSSQL_AGENT_ENABLED Habilita SQL Server Agent. Por exemplo, true habilita e false desabilita o agente. Por padrão, o agente está desabilitado.
MSSQL_MASTER_DATA_FILE Define o local do arquivo de dados de banco de dados master. Deve chamar-se master.mdf até a primeira execução do SQL Server.
MSSQL_MASTER_LOG_FILE Define o local do arquivo de log de banco de dados master. Deve chamar-se mastlog.ldf até a primeira execução do SQL Server.
MSSQL_ERROR_LOG_FILE Define o local dos arquivos errorlog. Por exemplo, /var/opt/mssql/log/errorlog.

Edições do SQL Server

MSSQL_PID Edition
Evaluation Edição de Avaliação do SQL Server
Developer SQL Server Developer Edition
Express Edição do SQL Server Express
Web Edição Web do SQL Server
Standard Edição Standard do SQL Server
Enterprise Essa opção herdada representa o licenciamento baseado em Enterprise Edition Server + CAL (Licença de Acesso ao Cliente) e é limitada a um máximo de 20 núcleos por instância do SQL Server. O Enterprise não está disponível para novos contratos. Você deve escolher o EnterpriseCore quando desejar implantar a Edição Enterprise.
EnterpriseCore Edição do SQL Server Enterprise Core. O EnterpriseCore representa o modelo de licenciamento de servidor baseado em núcleo sem limites de núcleo. Para saber mais, confira Calcular limites de capacidade por edição do SQL Server.
A product key Se você especificar uma chave do produto, ela deverá estar na forma de #####-#####-#####-#####-#####, onde # está um número ou uma letra.

Para obter mais informações sobre essas edições, consulte as edições do SQL Server.

MSSQL_PID Edition
Evaluation Edição de Avaliação do SQL Server
Express Edição do SQL Server Express
StandardDeveloper Edição Developer Standard do SQL Server
Standard Edição Standard do SQL Server
EnterpriseDeveloper Edição Developer Enterprise do SQL Server
Enterprise Essa opção herdada representa o licenciamento baseado em Enterprise Edition Server + CAL (Licença de Acesso ao Cliente) e é limitada a um máximo de 20 núcleos por instância do SQL Server. O Enterprise não está disponível para novos contratos. Você deve escolher o EnterpriseCore quando desejar implantar a Edição Enterprise.
EnterpriseCore Edição do SQL Server Enterprise Core. O EnterpriseCore representa o modelo de licenciamento de servidor baseado em núcleo sem limites de núcleo. Para saber mais, confira Calcular limites de capacidade por edição do SQL Server.
A product key Se você especificar uma chave do produto, ela deverá estar na forma de #####-#####-#####-#####-#####, onde # está um número ou uma letra.

Para obter mais informações sobre essas edições, consulte as edições do SQL Server.

Usar com a configuração inicial

Este exemplo executa o mssql-conf setup com variáveis de ambiente configuradas. As seguintes variáveis de ambiente são especificadas:

  • ACCEPT_EULA aceita o contrato de licença do usuário final.

  • MSSQL_PID especifica a Developer Edition licenciada gratuitamente do SQL Server para uso de não produção.

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

  • MSSQL_TCP_PORT define como 1234 a porta TCP em que o SQL Server escuta.

sudo ACCEPT_EULA='Y' MSSQL_PID='Developer' MSSQL_SA_PASSWORD='<password>' MSSQL_TCP_PORT=1234 /opt/mssql/bin/mssql-conf setup

Usar com o Docker

Este comando do docker de exemplo usa as seguintes variáveis de ambiente para criar um novo contêiner do SQL Server:

  • ACCEPT_EULA aceita o contrato de licença do usuário final.

  • MSSQL_PID especifica a Developer Edition licenciada gratuitamente do SQL Server para uso de não produção.

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

  • MSSQL_TCP_PORT define como 1234 a porta TCP em que o SQL Server escuta. Isso significa que, em vez de mapear a porta 1433 (padrão) para uma porta de host, a porta TCP personalizada deve ser mapeada com o comando -p 1234:1234 neste exemplo.

Se você estiver executando o Docker em Linux, use a seguinte sintaxe com aspas simples:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID='Developer' -e MSSQL_SA_PASSWORD='<password>' -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2017-latest

Se você estiver executando o Docker no Windows, use a seguinte sintaxe com aspas duplas:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<password>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2017-latest

Note

O processo para executar edições de produção em contêineres é um pouco diferente. Para obter mais informações, veja Executar imagens de contêiner de produção.

Se você estiver executando o Docker em Linux, use a seguinte sintaxe com aspas simples:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID='Developer' -e MSSQL_SA_PASSWORD='<password>' -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2019-latest

Se você estiver executando o Docker no Windows, use a seguinte sintaxe com aspas duplas:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<password>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2019-latest

Se você estiver executando o Docker em Linux, use a seguinte sintaxe com aspas simples:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID='Developer' -e MSSQL_SA_PASSWORD='<password>' -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2022-latest

Se você estiver executando o Docker no Windows, use a seguinte sintaxe com aspas duplas:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<password>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2022-latest

Se você estiver executando o Docker em Linux, use a seguinte sintaxe com aspas simples:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID='Developer' -e MSSQL_SA_PASSWORD='<password>' -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2025-latest

Se você estiver executando o Docker no Windows, use a seguinte sintaxe com aspas duplas:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<password>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2025-latest

Caution

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

Conteúdo relacionado

Contribua com a documentação do SQL

Você sabia que pode editar o conteúdo do SQL por conta própria? Ao fazer isso, além de melhorar nossa documentação, você também será creditado como um colaborador da página.

Para obter mais informações, consulte a documentação Edit Microsoft Learn.

  • Last updated on