Konfigurera SQL Server-inställningar med miljövariabler i Linux

gäller för:SQL Server – Linux

Du kan använda flera olika miljövariabler för att konfigurera SQL Server på Linux. Dessa variabler används i två scenarier:

  • Så här konfigurerar du den första installationen med kommandot mssql-conf setup.
  • För att konfigurera en ny SQL Server Linux-containeravbildning .

Tips

Om du behöver konfigurera SQL Server efter dessa installationsscenarier kan du läsa Konfigurera SQL Server på Linux med verktyget mssql-conf.

Miljövariabler

Miljövariabel Beskrivning
ACCEPT_EULA Ange variabeln ACCEPT_EULA till valfritt värde för att bekräfta att du godkänner End-User licensavtalet. Obligatorisk inställning för SQL Server-avbildningen.
MSSQL_SA_PASSWORD Konfigurera lösenordet för sa.

Miljövariabeln SA_PASSWORD är inaktuell. Använd MSSQL_SA_PASSWORD i stället.
MSSQL_PID Ange SQL Server-utgåvan eller produktnyckeln. Möjliga värden visas i följande SQL Server-versionstabell . Om du anger en produktnyckel måste den vara i form av #####-#####-#####-#####-#####, där # är ett tal eller en bokstav.
MSSQL_LCID Anger vilket språk-ID som ska användas för SQL Server. Till exempel är 1036 franska.
MSSQL_COLLATION Anger standardsortering för SQL Server. Detta åsidosätter standardmappningen av språk-ID (LCID) för sortering.
MSSQL_MEMORY_LIMIT_MB Anger den maximala mängden minne (i MB) som SQL Server kan använda. Som standard är det 80% av det totala fysiska minnet.
MSSQL_TCP_PORT Konfigurera TCP-porten som SQL Server lyssnar på (standard 1433).
MSSQL_IP_ADDRESS Ange IP-adressen. För närvarande måste IP-adressen vara IPv4-formatmall (0.0.0.0).
MSSQL_BACKUP_DIR Ange standardplatsen för säkerhetskopieringskatalogen.
MSSQL_DATA_DIR Ändra katalogen där de nya SQL Server-databasdatafilerna (.mdf) skapas.
MSSQL_LOG_DIR Ändra katalogen där de nya SQL Server-databasloggfilerna (.ldf) skapas.
MSSQL_DUMP_DIR Ändra katalogen där SQL Server lagrar minnesdumpar och andra felsökningsfiler som standard.
MSSQL_ENABLE_HADR Aktivera tillgänglighetsgrupp. Till exempel är "1" aktiverat och "0" är inaktiverat
MSSQL_AGENT_ENABLED Aktivera SQL Server-agent. Till exempel är "true" aktiverat och "false" är inaktiverat. Agenten är inaktiverad som standard.
MSSQL_MASTER_DATA_FILE Anger platsen för master databasdatafil. Måste heta master.mdf tills SQL Server körs första gången.
MSSQL_MASTER_LOG_FILE Anger platsen för master databasloggfilen. Måste heta mastlog.ldf tills SQL Server körs första gången.
MSSQL_ERROR_LOG_FILE Anger platsen för errorlog-filerna. Till exempel /var/opt/mssql/log/errorlog.

SQL Server-utgåvor

MSSQL_PID Edition
Evaluation SQL Server Evaluation Edition
Developer SQL Server Developer Edition
Express SQL Server Express edition
Web SQL Server Web Edition
Standard SQL Server Standardutgåva
Enterprise Det här äldre alternativet representerar licensiering baserad på Server + klientåtkomstlicens (CAL) i Enterprise Edition och är begränsat till högst 20 kärnor per SQL Server-instans. Enterprise är inte tillgängligt för nya avtal. Du bör välja EnterpriseCore när du vill distribuera Enterprise Edition.
EnterpriseCore SQL Server Enterprise Core Edition. EnterpriseCore representerar den kärnbaserade serverlicensieringsmodellen utan kärngränser. Mer information finns i Beräkningskapacitetsbegränsningar per utgåva av SQL Server.
A product key Om du anger en produktnyckel måste den vara i form av #####-#####-#####-#####-#####, där # är ett tal eller en bokstav.

Mer information om dessa utgåvor finns i SQL Server-utgåvor.

MSSQL_PID Edition
Evaluation SQL Server Evaluation Edition
Express SQL Server Express edition
StandardDeveloper

(För containrar använder du DeveloperStandard)
SQL Server Standard Developer Edition
Standard SQL Server Standardutgåva
EnterpriseDeveloper

(För containrar använder du Developer)
SQL Server Enterprise Developer Edition
Enterprise Det här äldre alternativet representerar licensiering baserad på Server + klientåtkomstlicens (CAL) i Enterprise Edition och är begränsat till högst 20 kärnor per SQL Server-instans. Enterprise är inte tillgängligt för nya avtal. Du bör välja EnterpriseCore när du vill distribuera Enterprise Edition.
EnterpriseCore SQL Server Enterprise Core Edition. EnterpriseCore representerar den kärnbaserade serverlicensieringsmodellen utan kärngränser. Mer information finns i Beräkningskapacitetsbegränsningar per utgåva av SQL Server.
A product key Om du anger en produktnyckel måste den vara i form av #####-#####-#####-#####-#####, där # är ett tal eller en bokstav.

Mer information om dessa utgåvor finns i SQL Server-utgåvor.

Använd med inledande konfiguration

Det här exemplet kör mssql-conf setup med konfigurerade miljövariabler. Följande miljövariabler anges:

  • ACCEPT_EULA godkänner slutanvändarlicensavtalet.

  • MSSQL_PID anger den fritt licensierade Developer Edition av SQL Server för icke-produktionsanvändning.

  • MSSQL_SA_PASSWORD anger ett starkt lösenord. Lösenordet bör följa SQL Server-standardprincipen för lösenord. Lösenordet måste som standard vara minst åtta tecken långt och innehålla tecken från tre av följande fyra uppsättningar: versaler, gemener, bas-10 siffror och symboler. Lösenord kan vara upp till 128 tecken långa. Använd lösenord som är så långa och komplexa som möjligt.

  • MSSQL_TCP_PORT anger TCP-porten som SQL Server lyssnar på till 1234.

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

Använda med Docker

Det här exemplet docker kommandot använder följande miljövariabler för att skapa en ny SQL Server-container:

  • ACCEPT_EULA godkänner slutanvändarlicensavtalet.

  • MSSQL_PID anger den fritt licensierade Developer Edition av SQL Server för icke-produktionsanvändning.

    När du distribuerar en container för SQL Server 2025 (17.x) eller en senare version använder du MSSQL_PID=DeveloperStandard för Standard Developer Edition och MSSQL_PID=Developer för Enterprise Developer Edition.

  • MSSQL_SA_PASSWORD anger ett starkt lösenord. Lösenordet bör följa SQL Server-standardprincipen för lösenord. Lösenordet måste som standard vara minst åtta tecken långt och innehålla tecken från tre av följande fyra uppsättningar: versaler, gemener, bas-10 siffror och symboler. Lösenord kan vara upp till 128 tecken långa. Använd lösenord som är så långa och komplexa som möjligt.

  • MSSQL_TCP_PORT anger TCP-porten som SQL Server lyssnar på till 1234. Det innebär att i stället för att mappa port 1433 (standard) till en värdport måste den anpassade TCP-porten mappas med kommandot -p 1234:1234 i det här exemplet.

Om du kör Docker på Linux använder du följande syntax med enkla citattecken:

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

Om du kör Docker i Windows använder du följande syntax med dubbla citattecken:

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

Notera

Processen för att köra produktionsutgåvor i containrar skiljer sig något åt. Mer information finns i Köra produktionscontaineravbildningar.

Om du kör Docker på Linux använder du följande syntax med enkla citattecken:

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

Om du kör Docker i Windows använder du följande syntax med dubbla citattecken:

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

Om du kör Docker på Linux använder du följande syntax med enkla citattecken:

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

Om du kör Docker i Windows använder du följande syntax med dubbla citattecken:

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

Om du kör Docker på Linux använder du följande syntax med enkla citattecken:

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

Om du kör Docker i Windows använder du följande syntax med dubbla citattecken:

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

När du distribuerar en container för SQL Server 2025 (17.x) eller en senare version använder du MSSQL_PID=DeveloperStandard för Standard Developer Edition och MSSQL_PID=Developer för Enterprise Developer Edition.

Försiktighet

Lösenordet bör följa SQL Server-standardprincipen för lösenord. Lösenordet måste som standard vara minst åtta tecken långt och innehålla tecken från tre av följande fyra uppsättningar: versaler, gemener, bas-10 siffror och symboler. Lösenord kan vara upp till 128 tecken långa. Använd lösenord som är så långa och komplexa som möjligt.

Bidra till SQL-dokumentation

Visste du att du kan redigera SQL-innehåll själv? Om du gör det hjälper du inte bara till att förbättra vår dokumentation, utan du får även kredit som deltagare på sidan.

Mer information finns i Redigera Microsoft Learn-dokumentation.