Konfigurieren von SQL Server-Einstellungen mit Umgebungsvariablen unter Linux

Gilt für: SQL Server – Linux

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

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

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

Tipp

Wenn Sie SQL Server nach diesen Setupszenarien konfigurieren müssen, nutzen Sie die Informationen in Konfigurieren von SQL Server für Linux mit dem mssql-conf-Tool.

Umgebungsvariablen

Umgebungsvariable Beschreibung
ACCEPT_EULA Legen Sie für die Variable ACCEPT_EULA einen beliebigen Wert fest, um zu bestätigen, dass Sie dem Endbenutzer-Lizenzvertrag zustimmen. Diese Einstellung ist für das SQL Server-Image zwingend erforderlich.
MSSQL_SA_PASSWORD Konfigurieren des Benutzerkennworts des Systemadministrators.

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.

1Die Enterprise-Legacy-Lizenz entspricht der Enterprise Edition mit Server + Client Access License (CAL)-basierter Lizenzierung 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 Rechenkapazitätsgrenzen von bestimmten Editionen 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.
  • MSSQL_TCP_PORT legt 1234 als TCP-Port fest, auf dem SQL Server lauscht.
sudo ACCEPT_EULA='Y' MSSQL_PID='Developer' MSSQL_SA_PASSWORD='<YourStrong!Passw0rd>' 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.
  • 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='<YourStrong!Passw0rd>' -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="<YourStrong!Passw0rd>" -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 Run production container images (Ausführen von Containerimages für Produktionsumgebungen).

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='<YourStrong!Passw0rd>' -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="<YourStrong!Passw0rd>" -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='<YourStrong!Passw0rd>' -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="<YourStrong!Passw0rd>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2022-latest

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 unter Mitwirken an der SQL Server-Dokumentation.