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 2022 (16.x) unter Linux zu konfigurieren. Diese Variablen werden in zwei Szenarien verwendet:

• Zum Konfigurieren der ersten Einrichtung mit dem mssql-conf setup-Befehl.
• Zum Konfigurieren eines neuen SQL Server-Containers in Docker.

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.

¹Die 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: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

Zugehöriger Inhalt

• Konfigurieren von SQL Server für Linux mit dem mssql-conf-Tool
• Installieren von SQL Server für 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 unter Mitwirken an der SQL Server-Dokumentation.