Konfigurieren von SQL Server-Einstellungen mit Umgebungsvariablen unter Linux

Gilt für:SQL Server – Linux

Sie können verschiedene Umgebungsvariablen verwenden, um SQL Server unter Linux zu konfigurieren. Diese Variablen werden in zwei Szenarien verwendet:

• Zum Konfigurieren der ersten Einrichtung mit dem mssql-conf setup-Befehl.
• So konfigurieren Sie ein neues SQL Server Linux-Containerimage.

Tipp

Wenn Sie SQL Server nach diesen Setupszenarien konfigurieren müssen, lesen Sie " Konfigurieren von SQL Server unter Linux mit dem mssql-conf-Tool".

Umgebungsvariablen

Umgebungsvariable	Beschreibung
ACCEPT_EULA	Legen Sie die ACCEPT_EULA Variable auf einen beliebigen Wert fest, um ihre Annahme des End-User Lizenzvertrags zu bestätigen. Diese Einstellung ist für das SQL Server-Image zwingend erforderlich.
MSSQL_SA_PASSWORD	Konfigurieren Sie das Kennwort von sa. Die Umgebungsvariable SA_PASSWORD ist veraltet. Verwenden Sie stattdessen MSSQL_SA_PASSWORD.
MSSQL_PID	Festlegen von SQL Server-Edition oder Product Key. Mögliche Werte sind: Evaluation Developer Express Web Standard Enterprise 1 EnterpriseCore 1 A product key Wenn ein Product Key angegeben wird, muss er das Format #####-#####-#####-#####-##### aufweisen, wobei „#“ eine Ziffer oder ein Buchstabe ist.
MSSQL_LCID	Legt die Sprach-ID fest, die für SQL Server verwendet werden soll. Beispielsweise steht „1036“ für „Französisch“.
MSSQL_COLLATION	Legt die Standardsortierung für SQL Server fest. Dadurch wird die Standardzuordnung der Sprachen-ID (LCID) zur Sortierung überschrieben.
MSSQL_MEMORY_LIMIT_MB	Festlegen der maximalen Größe des Arbeitsspeichers (in MB), der von SQL Server verwendet werden kann. Der Standardwert ist 80 % des gesamten physischen Speichers.
MSSQL_TCP_PORT	Konfigurieren des TCP-Ports, auf dem SQL Server lauscht (standardmäßig 1433).
MSSQL_IP_ADDRESS	Festlegen der IP-Adresse. Derzeit muss die IP-Adresse das IPv4-Format (0.0.0.0) aufweisen.
MSSQL_BACKUP_DIR	Festlegen des Standardspeicherorts für das Sicherungsverzeichnis.
MSSQL_DATA_DIR	Ändern des Verzeichnisses zum Erstellen der neuen SQL Server-Datenbank-Datendateien (.mdf).
MSSQL_LOG_DIR	Ändern des Verzeichnisses zum Erstellen der neuen SQL Server-Datenbank-Protokolldateien (.ldf).
MSSQL_DUMP_DIR	Ändern des Verzeichnisses, in dem SQL Server standardmäßig die Speicherabbilder und andere Dateien für die Problembehandlung ablegt.
MSSQL_ENABLE_HADR	Aktivieren der Verfügbarkeitsgruppe. Beispielsweise bedeutet „1“ aktiviert und „0“ deaktiviert.
MSSQL_AGENT_ENABLED	Aktivieren des SQL Server-Agents. Beispielsweise bedeutet „true“ aktiviert und „false“ deaktiviert. Standardmäßig ist der Agent deaktiviert.
MSSQL_MASTER_DATA_FILE	Legt den Speicherort der Datenbank-Datendatei master fest Muss bis zur ersten Ausführung von SQL Server als master.mdf benannt werden.
MSSQL_MASTER_LOG_FILE	Legt den Speicherort der Datenbank-Protokolldatei master fest Muss bis zur ersten Ausführung von SQL Server als mastlog.ldf benannt werden.
MSSQL_ERROR_LOG_FILE	Legt den Speicherort der errorlog-Dateien fest. Beispiel: /var/opt/mssql/log/errorlog.

¹ Die „Enterprise Edition“ wird durch die Legacylizenz Enterprise mit Server + Client Access License (CAL) basierter Lizenzierung dargestellt und ist auf maximal 20 Kerne pro SQL Server-Instanz beschränkt. Enterprise ist für neue Vereinbarungen nicht verfügbar. Sie sollten EnterpriseCore wählen, wenn Sie die Enterprise Edition bereitstellen möchten. EnterpriseCore stellt das kernbasierte Serverlizenzierungsmodell ohne Kerngrenzwerte dar. Weitere Informationen finden Sie unter Berechnungsgrenzen der Kapazität nach Edition von SQL Server.

Verwendung mit der ersten Einrichtung

Dieses Beispiel führt mssql-conf setup mit konfigurierten Umgebungsvariablen aus. Die folgenden Umgebungsvariablen werden angegeben:

• ACCEPT_EULA akzeptiert den Endbenutzer-Lizenzvertrag.

• MSSQL_PID gibt die frei lizenzierte Developer Edition von SQL Server für die Verwendung außerhalb von Produktionsumgebungen an.

• MSSQL_SA_PASSWORD legt ein sicheres Kennwort fest. Ihr Kennwort sollte der SQL Server-Standardkennwortrichtlinie entsprechen. Ein Standardkennwort enthält mindestens acht Zeichen, die aus drei der folgenden vier Kategorien stammen müssen: Großbuchstaben, Kleinbuchstaben, Grundzahlen (0–9) und Symbole. Kennwörter können bis zu 128 Zeichen lang sein. Verwenden Sie möglichst lange und komplexe Kennwörter.

• MSSQL_TCP_PORT legt 1234 als TCP-Port fest, auf dem SQL Server lauscht.

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

Verwendung mit Docker

Dieser docker-Beispielbefehl verwendet die folgenden Umgebungsvariablen, um einen neuen SQL Server-Container zu erstellen:

• ACCEPT_EULA akzeptiert den Endbenutzer-Lizenzvertrag.

• MSSQL_PID gibt die frei lizenzierte Developer Edition von SQL Server für die Verwendung außerhalb von Produktionsumgebungen an.

• MSSQL_SA_PASSWORD legt ein sicheres Kennwort fest. Ihr Kennwort sollte der SQL Server-Standardkennwortrichtlinie entsprechen. Ein Standardkennwort enthält mindestens acht Zeichen, die aus drei der folgenden vier Kategorien stammen müssen: Großbuchstaben, Kleinbuchstaben, Grundzahlen (0–9) und Symbole. Kennwörter können bis zu 128 Zeichen lang sein. Verwenden Sie möglichst lange und komplexe Kennwörter.

• MSSQL_TCP_PORT legt 1234 als TCP-Port fest, auf dem SQL Server lauscht. Dies bedeutet, dass in diesem Beispiel anstelle der Zuordnung von Port 1433 (Standard) zu einem Hostport der benutzerdefinierte TCP-Port mit dem -p 1234:1234-Befehl zugeordnet werden muss.

Wenn Sie Docker unter Linux ausführen, verwenden Sie die folgende Syntax in einfachen Anführungszeichen:

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

Wenn Sie Docker unter Windows ausführen, verwenden Sie die folgende Syntax in doppelten Anführungszeichen:

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

Achtung

Ihr Kennwort sollte der SQL Server-Standardkennwortrichtlinie entsprechen. Ein Standardkennwort enthält mindestens acht Zeichen, die aus drei der folgenden vier Kategorien stammen müssen: Großbuchstaben, Kleinbuchstaben, Grundzahlen (0–9) und Symbole. Kennwörter können bis zu 128 Zeichen lang sein. Verwenden Sie möglichst lange und komplexe Kennwörter.

Zugehöriger Inhalt

• Konfigurieren von SQL Server unter Linux mit dem Mssql-conf-Tool
• Installationsleitfaden für SQL Server unter Linux

Zur SQL-Dokumentation beitragen

Wussten Sie schon, dass Sie SQL-Inhalte selbst bearbeiten könnten? Hierdurch helfen Sie nicht nur mit, unsere Dokumentation zu verbessern, sondern Sie werden auch als Mitwirkender an der Seite aufgeführt.

Weitere Informationen finden Sie in der Dokumentation zum Bearbeiten von Microsoft Learn.