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

Gäller för:SQL Server i 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

Information om hur du konfigurerar SQL Server efter dessa installationsscenarier finns i Konfigurera SQL Server on Linux med verktyget mssql-conf.

Miljövariabler

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

Miljövariabeln SA_PASSWORD är inaktuell. Använd MSSQL_SA_PASSWORD i stället.
MSSQL_DB Anger namnet på en databas som ska skapas vid start av containern.
MSSQL_USER Om MSSQL_DB anges anger du namnet på en icke-användaresa som ska skapas vid start av containern. Användaren beviljas åtkomstbehörighet för MSSQL_DB databasen. Om den här variabeln används MSSQL_PASSWORD måste du också ange den. Om MSSQL_DB inte har angetts ignoreras den här variabeln.
MSSQL_PASSWORD Anger lösenordet för den användare vars namn finns i MSSQL_USER. Om den här variabeln används MSSQL_USER måste du också ange den. Om MSSQL_DB inte har angetts ignoreras den här variabeln.
MSSQL_PID Anger SQL Server edition eller produktnyckel. 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. Den här inställningen åsidosätter standardmappningen av språk-ID (LCID) till 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 Konfigurerar TCP-porten som SQL Server lyssnar på (standard 1433).
MSSQL_IP_ADDRESS Ställer in IP-adressen. För närvarande måste IP-adressen vara IPv4-formatmall (0.0.0.0).
MSSQL_BACKUP_DIR Anger standardplatsen för säkerhetskopieringskatalogen.
MSSQL_DATA_DIR Ändrar katalogen där de nya SQL Server databasdatafilerna (.mdf) skapas.
MSSQL_LOG_DIR Ändrar katalogen där de nya SQL Server databasloggfilerna (.ldf) skapas.
MSSQL_DUMP_DIR Ändrar katalogen där SQL Server lagrar minnesdumpar och andra felsökningsfiler som standard.
MSSQL_ENABLE_HADR Aktiverar tillgänglighetsgrupper. Till exempel 1 aktiverar och 0 inaktiverar funktionen.
MSSQL_AGENT_ENABLED Aktiverar SQL Server Agent. Till exempel true aktiverar och false inaktiverar agenten. 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-utgåva
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-utgåva
StandardDeveloper SQL Server Standard Developer Edition
Standard SQL Server Standardutgåva
EnterpriseDeveloper 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.

  • 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

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.