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

Aplica-se a:SQL Server – 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 instalação inicial com o comando mssql-conf setup.
• Para configurar uma nova imagem de contêiner do SQL Server Linux.

Dica

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	Descrição
ACCEPT_EULA	Defina a variável ACCEPT_EULA com qualquer valor para confirmar sua aceitação do Contrato de Licença do Usuário Final. Configuração exigida para a imagem do SQL Server.
MSSQL_SA_PASSWORD	Configure a senha sa. 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 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. Isso substitui o mapeamento padrão do identificador de idioma (LCID) 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	Configure a porta TCP em que o 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	Defina a localização do diretório de backup Padrão.
MSSQL_DATA_DIR	Altere o diretório no qual os arquivos de dados (.mdf) do novo banco de dados do SQL Server são criados.
MSSQL_LOG_DIR	Altere o diretório no qual os arquivos de log (.ldf) do novo banco de dados do SQL Server são criados.
MSSQL_DUMP_DIR	Altere o diretório em que 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' é habilitado e '0' ´é desabilitado
MSSQL_AGENT_ENABLED	Habilitar o SQL Server Agent. Por exemplo, 'true' é habilitado e 'false' é desabilitado. 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
Express	Edição do SQL Server Express
StandardDeveloper (Para contêineres, use DeveloperStandard)	Edição Developer Standard do SQL Server
Standard	Edição Standard do SQL Server
EnterpriseDeveloper (Para contêineres, use Developer)	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 longas e complexas.

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

  Ao implantar um contêiner para o SQL Server 2025 (17.x) ou uma versão posterior, use MSSQL_PID=DeveloperStandard para a edição Standard Developer e MSSQL_PID=Developer para o Enterprise Developer Edition.

• 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 longas e complexas.

• 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: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

Ao implantar um contêiner para o SQL Server 2025 (17.x) ou uma versão posterior, use MSSQL_PID=DeveloperStandard para a edição Standard Developer e MSSQL_PID=Developer para o Enterprise Developer Edition.

Cuidado

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 longas e complexas.

Conteúdo relacionado

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

Contribua com a documentação do SQL

Você sabia que pode editar 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 Editar a documentação do Microsoft Learn.