Konfigurieren von SQL Server-Einstellungen mit Umgebungsvariablen unter Linux

Gilt für:yesSQL Server (alle unterstützten Versionen) – Linux

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

Sie können mehrere verschiedene Umgebungsvariablen verwenden, um SQL Server 2019 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 Ihre Zustimmung zum End-User Licensing Agreement (Benutzerlizenzvertrag) zu geben. 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:

Evaluation
Developer
Express
Web
Standard
Enterprise
Ein Product Key

Bei Angabe eines Product Keys muss dieser im Format #####-#####-#####-#####-##### vorliegen, wobei „#“ eine Zahl oder einen Buchstaben darstellt.
MSSQL_LCID Legt die Sprach-ID fest, die für SQL Server verwendet werden soll. Beispiel: 1036 ist 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 Festlegen des Speicherorts der Masterdatenbankdatei. Muss bis zur ersten Ausführung von SQL Server als master.mdf benannt werden.
MSSQL_MASTER_LOG_FILE Festlegen des Speicherorts der Masterdatenbank-Protokolldatei. Muss bis zur ersten Ausführung von SQL Server als mastlog.mdf benannt werden.
MSSQL_ERROR_LOG_FILE Legt den Speicherort der errorlog-Dateien fest.
Umgebungsvariable BESCHREIBUNG
ACCEPT_EULA Legen Sie für die Variable ACCEPT_EULA einen beliebigen Wert fest, um Ihre Zustimmung zum End-User Licensing Agreement (Benutzerlizenzvertrag) zu geben. 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:

Evaluation
Developer
Express
Web
Standard
Enterprise
Ein Product Key

Bei Angabe eines Product Keys muss dieser im Format #####-#####-#####-#####-##### vorliegen, wobei „#“ eine Zahl oder einen Buchstaben darstellt.
MSSQL_LCID Legt die Sprach-ID fest, die für SQL Server verwendet werden soll. Beispiel: 1036 ist 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 Festlegen des Speicherorts der Masterdatenbankdatei. Muss bis zur ersten Ausführung von SQL Server als master.mdf benannt werden.
MSSQL_MASTER_LOG_FILE Festlegen des Speicherorts der Masterdatenbank-Protokolldatei. Muss bis zur ersten Ausführung von SQL Server als mastlog.mdf benannt werden.
MSSQL_ERROR_LOG_FILE Legt den Speicherort der errorlog-Dateien fest.

Verwendung mit der ersten Einrichtung

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

  • ACCEPT_EULA akzeptiert die Lizenzbedingungen für Endbenutzer.
  • 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 die Lizenzbedingungen für Endbenutzer.
  • 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/macOS 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-GA-ubuntu-16.04

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-GA-ubuntu-16.04

Nächste Schritte

Weitere hier nicht aufgeführte SQL Server-Einstellungen finden Sie unter Konfigurieren von SQL Server für Linux mit dem mssql-conf-Tool.

Weitere Informationen zum Installieren und Ausführen von SQL Server unter Linux finden Sie unter Installationsanleitung für SQL Server unter Linux.