Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für:
SQL Server unter 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
Informationen zum Konfigurieren von SQL Server nach diesen Setupszenarien finden Sie unter Configure SQL Server für Linux mit dem mssql-conf-Tool.
Umgebungsvariablen
| Umgebungsvariable | Beschreibung |
|---|---|
ACCEPT_EULA |
Legt 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 |
Konfiguriert das sa Kennwort.Die Umgebungsvariable SA_PASSWORD ist veraltet. Verwenden Sie stattdessen MSSQL_SA_PASSWORD. |
MSSQL_DB |
Legt den Namen einer Datenbank fest, die beim Containerstart erstellt werden soll. |
MSSQL_USER |
Wenn MSSQL_DB dieser Wert festgelegt ist, wird der Name eines Nichtbenutzerssa festgelegt, der beim Containerstart erstellt werden soll. Dem Benutzer werden Zugriffsrechte für die MSSQL_DB Datenbank gewährt. Wenn diese Variable verwendet wird, MSSQL_PASSWORD muss auch festgelegt werden. Wenn MSSQL_DB nicht gesetzt ist, wird die Variable ignoriert. |
MSSQL_PASSWORD |
Legt das Kennwort des Benutzers fest, dessen Name in MSSQL_USER steht. Wenn diese Variable verwendet wird, MSSQL_USER muss auch festgelegt werden. Wenn MSSQL_DB nicht festgelegt ist, wird diese Variable ignoriert. |
MSSQL_PID |
Legt den SQL Server Edition oder Product Key fest. Mögliche Werte sind in der folgenden TABELLE der SQL Server-Editionen aufgeführt. Wenn Sie einen Product Key angeben, muss er die Form #####-#####-#####-#####-##### haben, wobei # eine Zahl 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. Diese Einstellung setzt die Standardzuordnung der Sprach-ID (LCID) für die Sortierung außer Kraft. |
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 |
Konfiguriert den TCP-Port, der den SQL Server abhört (Standard-Portnummer 1433). |
MSSQL_IP_ADDRESS |
Legt die IP-Adresse fest. Derzeit muss die IP-Adresse das IPv4-Format (0.0.0.0) aufweisen. |
MSSQL_BACKUP_DIR |
Legt den Standardspeicherort des Sicherungsverzeichnisses fest. |
MSSQL_DATA_DIR |
Ändert das Verzeichnis, in dem die neuen SQL Server Datenbankdatendateien (.mdf) erstellt werden. |
MSSQL_LOG_DIR |
Ändert das Verzeichnis, in dem die neuen SQL Server-Datenbankprotokolldateien (.ldf) erstellt werden. |
MSSQL_DUMP_DIR |
Ändert das Verzeichnis, in dem SQL Server die Speicherabbilder und andere Problembehandlungsdateien standardmäßig einlagert. |
MSSQL_ENABLE_HADR |
Aktiviert Verfügbarkeitsgruppen. Zum Beispiel aktiviert 1 und deaktiviert 0 das Feature. |
MSSQL_AGENT_ENABLED |
Aktiviert SQL Server-Agent. Aktiviert beispielsweise true und false deaktiviert den Agent. 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. |
SQL Server-Editionen
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 Standard Edition |
Enterprise |
Diese Legacyoption stellt enterprise edition Server + Client Access License (CAL)-basierte Lizenzierung dar 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 |
SQL Server Enterprise Core Edition.
EnterpriseCore stellt das kernbasierte Serverlizenzierungsmodell ohne Kerngrenzwerte dar. Weitere Informationen finden Sie unter Berechnungsgrenzen der Kapazität nach Edition von SQL Server. |
A product key |
Wenn Sie einen Product Key angeben, muss er die Form #####-#####-#####-#####-##### haben, wobei # eine Zahl oder ein Buchstabe ist. |
Weitere Informationen zu diesen Editionen finden Sie unter SQL Server-Editionen.
MSSQL_PID |
Edition |
|---|---|
Evaluation |
SQL Server Evaluation Edition |
Express |
SQL Server Express-Edition |
StandardDeveloper |
SQL Server Standard Developer Edition |
Standard |
SQL Server Standard Edition |
EnterpriseDeveloper |
SQL Server Enterprise Developer Edition |
Enterprise |
Diese Legacyoption stellt enterprise edition Server + Client Access License (CAL)-basierte Lizenzierung dar 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 |
SQL Server Enterprise Core Edition.
EnterpriseCore stellt das kernbasierte Serverlizenzierungsmodell ohne Kerngrenzwerte dar. Weitere Informationen finden Sie unter Berechnungsgrenzen der Kapazität nach Edition von SQL Server. |
A product key |
Wenn Sie einen Product Key angeben, muss er die Form #####-#####-#####-#####-##### haben, wobei # eine Zahl oder ein Buchstabe ist. |
Weitere Informationen zu diesen Editionen finden Sie unter SQL Server-Editionen.
Verwendung mit der Erstinstallation
Dieses Beispiel führt mssql-conf setup mit konfigurierten Umgebungsvariablen aus. Die folgenden Umgebungsvariablen werden angegeben:
ACCEPT_EULAakzeptiert den Endbenutzer-Lizenzvertrag.MSSQL_PIDgibt die frei lizenzierte Developer Edition von SQL Server für die Verwendung außerhalb von Produktionsumgebungen an.MSSQL_SA_PASSWORDlegt 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_PORTlegt 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_EULAakzeptiert den Endbenutzer-Lizenzvertrag.MSSQL_PIDgibt die frei lizenzierte Developer Edition von SQL Server für die Verwendung außerhalb von Produktionsumgebungen an.MSSQL_SA_PASSWORDlegt 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_PORTlegt 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:2017-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:2017-latest
Hinweis
Die Vorgehensweise zum Ausführen von Produktionseditionen in Containern weicht hiervon minimal ab. Weitere Informationen finden Sie unter Ausführen von Produktions-Containerbildern.
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:2019-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:2019-latest
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:2022-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:2022-latest
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.