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

Aplica-se a:SQL Server em 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:

• Para configurar a configuração inicial com o comando mssql-conf setup.
• Para configurar uma nova imagem de contêineres do SQL Server Linux.

Dica

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

Variáveis de ambiente

Variável de ambiente	Descrição
ACCEPT_EULA	Defina a variável ACCEPT_EULA para um valor qualquer para confirmar a sua aceitação do Contrato de Licenciamento End-User. Configuração necessária para a imagem do SQL Server.
MSSQL_SA_PASSWORD	Configure a sa senha. A variável de ambiente SA_PASSWORD foi preterida. Use MSSQL_SA_PASSWORD em vez disso.
MSSQL_PID	Defina a edição do SQL Server ou a chave de produto. Os valores possíveis estão listados na seguinte tabela de edições do SQL Server . Se especificar uma chave de produto, deve ser na forma de #####-#####-#####-#####-#####, onde # é 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 o agrupamento padrão para o SQL Server. Isso substitui o mapeamento padrão de ID de idioma (LCID) para agrupamento.
MSSQL_MEMORY_LIMIT_MB	Define a quantidade máxima de memória (em MB) que o SQL Server pode usar. Por padrão, é 80% da memória física total.
MSSQL_TCP_PORT	Configure a porta TCP na qual o SQL Server escuta (padrão 1433).
MSSQL_IP_ADDRESS	Defina o endereço IP. Atualmente, o endereço IP deve ser estilo IPv4 (0.0.0.0).
MSSQL_BACKUP_DIR	Defina o local do diretório de backup padrão.
MSSQL_DATA_DIR	Altere o diretório onde os novos arquivos de dados de banco de dados do SQL Server (.mdf) são criados.
MSSQL_LOG_DIR	Altere o diretório onde os novos arquivos de log (.ldf) do banco de dados do SQL Server são criados.
MSSQL_DUMP_DIR	Altere o diretório onde o SQL Server deposita os despejos de memória e outros arquivos de solução de problemas por padrão.
MSSQL_ENABLE_HADR	Habilite o Grupo de Disponibilidade. Por exemplo, '1' está ativado e '0' está desativado
MSSQL_AGENT_ENABLED	Ativar o SQL Server Agent. Por exemplo, 'true' está ativado e 'false' está desativado. Por padrão, o agente está desativado.
MSSQL_MASTER_DATA_FILE	Define o local do arquivo de dados do banco de dados master. Deve ser designado master.mdf até à primeira execução do SQL Server.
MSSQL_MASTER_LOG_FILE	Define o local do arquivo de log do banco de dados master. Deve ser designado mastlog.ldf até à 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
Express	Edição SQL Server Express
StandardDeveloper (Para recipientes, usar DeveloperStandard)	SQL Server Standard Developer Edition
Standard	Edição Standard do SQL Server
EnterpriseDeveloper (Para recipientes, usar Developer)	Edição para Desenvolvedores Empresariais do SQL Server
Enterprise	Esta opção legada representa licenciamento baseado em Enterprise edition Server + Client Access License (CAL), e está limitada a um máximo de 20 núcleos por instância SQL Server. Enterprise não está disponível para novos contratos. Você deve escolher EnterpriseCore quando desejar implantar a edição Enterprise.
EnterpriseCore	Edição SQL Server Enterprise Core. EnterpriseCore representa o modelo de licenciamento de servidor baseado em núcleo sem limites de núcleo. Para obter mais informações, consulte Limites de capacidade de computação por edição do SQL Server.
A product key	Se especificar uma chave de produto, deve ser na forma de #####-#####-#####-#####-#####, onde # é um número ou uma letra.

Para mais informações sobre estas edições, consulte edições SQL Server.

Utilizar com a configuração inicial

Este exemplo executa 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 de usuário final.

• MSSQL_PID especifica a Developer Edition licenciada livremente do SQL Server para uso fora da produção.

• MSSQL_SA_PASSWORD define uma senha forte. 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.

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

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

Utilizar com Docker

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

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

• MSSQL_PID especifica a Developer Edition licenciada livremente do SQL Server para uso fora da produção.

  Quando implementar um contentor para SQL Server 2025 (17.x) ou uma versão posterior, utilize MSSQL_PID=DeveloperStandard a edição Standard Developer e MSSQL_PID=Developer a edição Enterprise Developer.

• MSSQL_SA_PASSWORD define uma senha forte. 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.

• MSSQL_TCP_PORT define a porta TCP que o SQL Server escuta como 1234. 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 no Linux, use a seguinte sintaxe entre 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

Quando implementar um contentor para SQL Server 2025 (17.x) ou uma versão posterior, utilize MSSQL_PID=DeveloperStandard a edição Standard Developer e MSSQL_PID=Developer a edição Enterprise Developer.

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.

Conteúdo relacionado

• Configurar o SQL Server no Linux com a ferramenta mssql-conf
• Diretrizes de instalação do SQL Server no Linux

Contribuir para a documentação do 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.