SQL Server-instellingen configureren met omgevingsvariabelen in Linux

Van toepassing op:SQL Server op Linux

U kunt verschillende omgevingsvariabelen gebruiken om SQL Server in Linux te configureren. Deze variabelen worden in twee scenario's gebruikt:

Tip

Als u SQL Server na deze installatiescenario's wilt configureren, raadpleegt u SQL Server configureren in Linux met het hulpprogramma mssql-conf.

Omgevingsvariabelen

Omgevingsvariabele Description
ACCEPT_EULA Hiermee stelt u de ACCEPT_EULA variabele in op een waarde om uw acceptatie van de End-User licentieovereenkomst te bevestigen. Vereiste instelling voor de SQL Server-afbeelding.
MSSQL_SA_PASSWORD Hiermee configureert u het sa wachtwoord.

De omgevingsvariabele SA_PASSWORD is afgeschaft. Gebruik in plaats daarvan MSSQL_SA_PASSWORD.
MSSQL_DB Hiermee stelt u de naam van een database in die moet worden gemaakt bij het opstarten van de container.
MSSQL_USER Als MSSQL_DB is ingesteld, geeft u de naam op van een gebruiker die geen sa is en die bij het starten van de container moet worden aangemaakt. De gebruiker krijgt toegangsrechten voor de MSSQL_DB database. Als deze variabele wordt gebruikt, MSSQL_PASSWORD moet u ook instellen. Als MSSQL_DB deze variabele niet is ingesteld, wordt deze variabele genegeerd.
MSSQL_PASSWORD Hiermee stelt u het wachtwoord van de gebruiker in waarvan de naam zich bevindt MSSQL_USER. Als deze variabele wordt gebruikt, MSSQL_USER moet u ook instellen. Als MSSQL_DB deze variabele niet is ingesteld, wordt deze variabele genegeerd.
MSSQL_PID Hiermee stelt u de SQL Server editie of productsleutel in. Mogelijke waarden worden vermeld in de volgende tabel met SQL Server-edities . Als u een productcode opgeeft, moet deze een #####-#####-#####-#####-###### getal of een letter zijn.
MSSQL_LCID Hiermee stelt u de taal-id in die moet worden gebruikt voor SQL Server. 1036 is bijvoorbeeld Frans.
MSSQL_COLLATION Hiermee stelt u de standaardsortering voor SQL Server in. Met deze instelling wordt de standaardtoewijzing van taal-ID (LCID) naar sortering overschreven.
MSSQL_MEMORY_LIMIT_MB Hiermee stelt u de maximale hoeveelheid geheugen (in MB) in die SQL Server kan gebruiken. Standaard is dit 80% van het totale fysieke geheugen.
MSSQL_TCP_PORT Hiermee configureert u de TCP-poort waarop SQL Server luistert (standaard 1433).
MSSQL_IP_ADDRESS Hiermee stelt u het IP-adres in. Op dit moment moet het IP-adres de IPv4-stijl (0.0.0.0) zijn.
MSSQL_BACKUP_DIR Hiermee stelt u de standaardlocatie van de back-upmap in.
MSSQL_DATA_DIR Hiermee wijzigt u de map waarin de nieuwe SQL Server databasegegevensbestanden (.mdf) worden gemaakt.
MSSQL_LOG_DIR Hiermee wijzigt u de map waarin de nieuwe SQL Server databaselogboekbestanden (.ldf) worden gemaakt.
MSSQL_DUMP_DIR Hiermee wijzigt u de map waarin SQL Server de geheugendumps en andere probleemoplossingsbestanden standaard opslaat.
MSSQL_ENABLE_HADR Hiermee schakelt u beschikbaarheidsgroepen in. Hiermee schakelt u bijvoorbeeld 1 de functie in en 0 uit.
MSSQL_AGENT_ENABLED Schakelt SQL Server Agent in. Hiermee schakelt u bijvoorbeeld true de agent in en false uit. De agent is standaard uitgeschakeld.
MSSQL_MASTER_DATA_FILE Hiermee stelt u de locatie van het master databasegegevensbestand in. Moet master.mdf genoemd worden tot de eerste keer dat SQL Server wordt uitgevoerd.
MSSQL_MASTER_LOG_FILE Hiermee stelt u de locatie van het master databaselogboekbestand in. Moet mastlog.ldf genoemd worden tot de eerste keer dat SQL Server wordt uitgevoerd.
MSSQL_ERROR_LOG_FILE Hiermee stelt u de locatie van de errorlog-bestanden in. Bijvoorbeeld: /var/opt/mssql/log/errorlog.

SQL Server edities

MSSQL_PID Edition
Evaluation SQL Server Evaluation Edition
Developer SQL Server Developer Edition
Express SQL Server Express-editie
Web SQL Server Web Edition
Standard SQL Server Standard-editie
Enterprise Deze verouderde optie vertegenwoordigt licenties op basis van Enterprise Edition Server + Client Access License (CAL) en is beperkt tot maximaal 20 kernen per SQL Server-exemplaar. Enterprise is niet beschikbaar voor nieuwe overeenkomsten. Kies EnterpriseCore wanneer u Enterprise Edition wilt implementeren.
EnterpriseCore SQL Server Enterprise Core-editie. EnterpriseCore vertegenwoordigt het licentiemodel op basis van de kernserver zonder kernlimieten. Zie Compute-capaciteitslimieten per editie van SQL Servervoor meer informatie.
A product key Als u een productcode opgeeft, moet deze een #####-#####-#####-#####-###### getal of een letter zijn.

Zie SQL Server-edities voor meer informatie over deze edities.

MSSQL_PID Edition
Evaluation SQL Server Evaluation Edition
Express SQL Server Express-editie
StandardDeveloper SQL Server Standard Developer Edition
Standard SQL Server Standard-editie
EnterpriseDeveloper SQL Server Enterprise Developer Edition
Enterprise Deze verouderde optie vertegenwoordigt licenties op basis van Enterprise Edition Server + Client Access License (CAL) en is beperkt tot maximaal 20 kernen per SQL Server-exemplaar. Enterprise is niet beschikbaar voor nieuwe overeenkomsten. Kies EnterpriseCore wanneer u Enterprise Edition wilt implementeren.
EnterpriseCore SQL Server Enterprise Core-editie. EnterpriseCore vertegenwoordigt het licentiemodel op basis van de kernserver zonder kernlimieten. Zie Compute-capaciteitslimieten per editie van SQL Servervoor meer informatie.
A product key Als u een productcode opgeeft, moet deze een #####-#####-#####-#####-###### getal of een letter zijn.

Zie SQL Server-edities voor meer informatie over deze edities.

Gebruiken bij de eerste instelling

In dit voorbeeld wordt mssql-conf setup uitgevoerd met geconfigureerde omgevingsvariabelen. De volgende omgevingsvariabelen worden opgegeven:

  • ACCEPT_EULA accepteert de gebruiksrechtovereenkomst.

  • MSSQL_PID geeft de vrij gelicentieerde Developer Edition van SQL Server op voor niet-productiegebruik.

  • MSSQL_SA_PASSWORD stelt een sterk wachtwoord in. Uw wachtwoord moet het SQL Server standaardbeleid voor password volgen. Standaard moet het wachtwoord ten minste acht tekens lang zijn en tekens bevatten uit drie van de volgende vier sets: hoofdletters, kleine letters, basis-10 cijfers en symbolen. Wachtwoorden mogen maximaal 128 tekens lang zijn. Gebruik wachtwoorden die zo lang en complex mogelijk zijn.

  • MSSQL_TCP_PORT stelt de TCP-poort waarop SQL Server luistert, in op 1234.

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

Gebruiken met Docker

In dit voorbeeld docker opdracht de volgende omgevingsvariabelen gebruikt om een nieuwe SQL Server-container te maken:

  • ACCEPT_EULA accepteert de gebruiksrechtovereenkomst.

  • MSSQL_PID geeft de vrij gelicentieerde Developer Edition van SQL Server op voor niet-productiegebruik.

  • MSSQL_SA_PASSWORD stelt een sterk wachtwoord in. Uw wachtwoord moet het SQL Server standaardbeleid voor password volgen. Standaard moet het wachtwoord ten minste acht tekens lang zijn en tekens bevatten uit drie van de volgende vier sets: hoofdletters, kleine letters, basis-10 cijfers en symbolen. Wachtwoorden mogen maximaal 128 tekens lang zijn. Gebruik wachtwoorden die zo lang en complex mogelijk zijn.

  • MSSQL_TCP_PORT stelt de TCP-poort waarop SQL Server luistert, in op 1234. Dit betekent dat in plaats van poort 1433 (standaard) toe te wijzen aan een hostpoort, de aangepaste TCP-poort moet worden toegewezen met de opdracht -p 1234:1234 in dit voorbeeld.

Als u Docker op Linux uitvoert, gebruikt u de volgende syntaxis met enkele aanhalingstekens:

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

Als u Docker uitvoert in Windows, gebruikt u de volgende syntaxis met dubbele aanhalingstekens:

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

Note

Het proces voor het uitvoeren van productie-edities in containers is iets anders. Raadpleeg productiecontainerafbeeldingen uitvoeren voor meer informatie.

Als u Docker op Linux uitvoert, gebruikt u de volgende syntaxis met enkele aanhalingstekens:

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

Als u Docker uitvoert in Windows, gebruikt u de volgende syntaxis met dubbele aanhalingstekens:

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

Als u Docker op Linux uitvoert, gebruikt u de volgende syntaxis met enkele aanhalingstekens:

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

Als u Docker uitvoert in Windows, gebruikt u de volgende syntaxis met dubbele aanhalingstekens:

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

Als u Docker op Linux uitvoert, gebruikt u de volgende syntaxis met enkele aanhalingstekens:

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

Als u Docker uitvoert in Windows, gebruikt u de volgende syntaxis met dubbele aanhalingstekens:

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

Caution

Uw wachtwoord moet het SQL Server standaardbeleid voor password volgen. Standaard moet het wachtwoord ten minste acht tekens lang zijn en tekens bevatten uit drie van de volgende vier sets: hoofdletters, kleine letters, basis-10 cijfers en symbolen. Wachtwoorden mogen maximaal 128 tekens lang zijn. Gebruik wachtwoorden die zo lang en complex mogelijk zijn.

Bijdragen aan SQL-documentatie

Wist u dat u zelf SQL-inhoud kunt bewerken? Door dit te doen helpt u niet alleen onze documentatie te verbeteren, maar krijgt u ook erkenning als bijdrager aan de pagina.

Zie Microsoft Learn-documentatie bewerken voor meer informatie.