Partilhar via

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

  • Artigo

Aplica-se a:SQL Server - Linux

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

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

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

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

Evaluation
Developer
Express
Web
Standard
Enterprise 1
EnterpriseCore 1
A product key

Se especificar uma chave de produto, ela deve estar 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 Habilite 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 nomeado 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.

1 A licença Enterprise herdada representa a edição Enterprise com licenciamento baseado em Server + Client Access License (CAL) e é limitada a um máximo de 20 núcleos por instância do SQL Server. Enterprise não está disponível para novos contratos. Você deve escolher EnterpriseCore quando desejar implantar a edição Enterprise. 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.

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

Usar com o 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.

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

Observação

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

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

Atenção

A sua senha deve seguir a política padrão de senha 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

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 Como contribuir para a documentação do SQL Server