Konfigurieren von SQL Server für Linux mit dem mssql-conf-ToolConfigure SQL Server on Linux with the mssql-conf tool

GILT FÜR: JaSQL Server (nur Linux) NeinAzure SQL-DatenbankNeinAzure SQL Data Warehouse NeinParallel Data WarehouseAPPLIES TO: yesSQL Server (Linux only) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

mssql-conf ist ein Konfigurationsskript, das mit SQL Server 2017 für Red Hat Enterprise Linux, SUSE Linux Enterprise Server und Ubuntu installiert wird.mssql-conf is a configuration script that installs with SQL Server 2017 for Red Hat Enterprise Linux, SUSE Linux Enterprise Server, and Ubuntu. Mit diesem Hilfsprogramm können Sie die folgenden Parameter festlegen:You can use this utility to set the following parameters:

AgentAgent Aktivieren des SQL Server-Agents.Enable SQL Server Agent.
SortierungCollation Festlegen einer neuen Sortierung für SQL Server für Linux.Set a new collation for SQL Server on Linux.
KundenfeedbackCustomer feedback Festlegen, ob SQL Server Feedback an Microsoft sendet.Choose whether or not SQL Server sends feedback to Microsoft.
Datenbank-E-Mail-ProfilDatabase Mail Profile Festlegen des Standardprofils von Datenbank-E-Mails für SQL Server für Linux.Set the default database mail profile for SQL Server on Linux.
StandarddatenverzeichnisDefault data directory Festlegen eines anderen Standardverzeichnisses für neue SQL Server-Datenbank-Datendateien (MDF).Change the default directory for new SQL Server database data files (.mdf).
StandardprotokollverzeichnisDefault log directory Festlegen eines anderen Standardverzeichnisses für neue SQL Server-Datenbank-Protokolldateien (LDF).Changes the default directory for new SQL Server database log (.ldf) files.
Standardverzeichnis für MasterdatenbankDefault master database directory Festlegen eines anderen Standardverzeichnisses für die Masterdatenbank und für Protokolldateien.Changes the default directory for the master database and log files.
Standarddateiname für MasterdatenbankDefault master database file name Festlegen eines anderen Namens für Masterdatenbank-Dateien.Changes the name of master database files.
Standardverzeichnis für SpeicherabbilderDefault dump directory Festlegen eines anderen Standardverzeichnisses für neue Speicherabbilder und andere Dateien zur Problembehandlung.Change the default directory for new memory dumps and other troubleshooting files.
Standardverzeichnis für FehlerprotokolleDefault error log directory Festlegen eines anderen Standardverzeichnisses für neue SQL Server-Dateien für Fehlerprotokolle, Standardprofiler-Ablaufverfolgungen, XE-Systemintegritätssitzungen und Hekaton-XE-Sitzungen.Changes the default directory for new SQL Server ErrorLog, Default Profiler Trace, System Health Session XE, and Hekaton Session XE files.
Standardverzeichnis für SicherungenDefault backup directory Festlegen eines anderen Standardverzeichnisses für neue Sicherungsdateien.Change the default directory for new backup files.
Typ des SpeicherabbildsDump type Festlegen des Typs der Speicherabbilddateien, die erfasst werden sollen.Choose the type of dump memory dump file to collect.
High Availability (Hohe Verfügbarkeit)High availability Aktivieren von Verfügbarkeitsgruppen.Enable Availability Groups.
Verzeichnis für lokale ÜberwachungenLocal Audit directory Festlegen eines Verzeichnisses, dem Dateien für lokale Überwachungen hinzugefügt werden sollen.Set a directory to add Local Audit files.
GebietsschemaLocale Festlegen eines Gebietsschemas, das SQL Server verwenden soll.Set the locale for SQL Server to use.
ArbeitsspeicherlimitMemory limit Festlegen des Arbeitsspeicherlimits für SQL Server.Set the memory limit for SQL Server.
TCP-PortTCP port Festlegen eines anderen Ports, auf dem SQL Server nach Verbindungen lauscht.Change the port where SQL Server listens for connections.
TLSTLS Konfigurieren der Verschlüsselung mit Transport Layer Security.Configure Transport Level Security.
AblaufverfolgungsflagsTraceflags Festlegen der Ablaufverfolgungsflags, die vom Dienst verwendet werden sollen.Set the traceflags that the service is going to use.

mssql-conf ist ein Konfigurationsskript, das mit SQL Server 2019SQL Server 2019 für Red Hat Enterprise Linux, SUSE Linux Enterprise Server und Ubuntu installiert wird.mssql-conf is a configuration script that installs with SQL Server 2019SQL Server 2019 for Red Hat Enterprise Linux, SUSE Linux Enterprise Server, and Ubuntu. Mit diesem Hilfsprogramm können Sie die folgenden Parameter festlegen:You can use this utility to set the following parameters:

AgentAgent Aktivieren des SQL Server-Agents.Enable SQL Server Agent
SortierungCollation Festlegen einer neuen Sortierung für SQL Server für Linux.Set a new collation for SQL Server on Linux.
KundenfeedbackCustomer feedback Festlegen, ob SQL Server Feedback an Microsoft sendet.Choose whether or not SQL Server sends feedback to Microsoft.
Datenbank-E-Mail-ProfilDatabase Mail Profile Festlegen des Standardprofils von Datenbank-E-Mails für SQL Server für Linux.Set the default database mail profile for SQL Server on Linux.
StandarddatenverzeichnisDefault data directory Festlegen eines anderen Standardverzeichnisses für neue SQL Server-Datenbank-Datendateien (MDF).Change the default directory for new SQL Server database data files (.mdf).
StandardprotokollverzeichnisDefault log directory Festlegen eines anderen Standardverzeichnisses für neue SQL Server-Datenbank-Protokolldateien (LDF).Changes the default directory for new SQL Server database log (.ldf) files.
Standardverzeichnis für Masterdatenbank-DateienDefault master database file directory Festlegen eines anderen Standardverzeichnisses für die Masterdatenbank-Dateien auf einer vorhandenen SQL-Installation.Changes the default directory for the master database files on existing SQL installation.
Standarddateiname für MasterdatenbankDefault master database file name Festlegen eines anderen Namens für Masterdatenbank-Dateien.Changes the name of master database files.
Standardverzeichnis für SpeicherabbilderDefault dump directory Festlegen eines anderen Standardverzeichnisses für neue Speicherabbilder und andere Dateien zur Problembehandlung.Change the default directory for new memory dumps and other troubleshooting files.
Standardverzeichnis für FehlerprotokolleDefault error log directory Festlegen eines anderen Standardverzeichnisses für neue SQL Server-Dateien für Fehlerprotokolle, Standardprofiler-Ablaufverfolgungen, XE-Systemintegritätssitzungen und Hekaton-XE-Sitzungen.Changes the default directory for new SQL Server ErrorLog, Default Profiler Trace, System Health Session XE, and Hekaton Session XE files.
Standardverzeichnis für SicherungenDefault backup directory Festlegen eines anderen Standardverzeichnisses für neue Sicherungsdateien.Change the default directory for new backup files.
Typ des SpeicherabbildsDump type Festlegen des Typs der Speicherabbilddateien, die erfasst werden sollen.Choose the type of dump memory dump file to collect.
High Availability (Hohe Verfügbarkeit)High availability Aktivieren von Verfügbarkeitsgruppen.Enable Availability Groups.
Verzeichnis für lokale ÜberwachungenLocal Audit directory Festlegen eines Verzeichnisses, dem Dateien für lokale Überwachungen hinzugefügt werden sollen.Set a directory to add Local Audit files.
GebietsschemaLocale Festlegen eines Gebietsschemas, das SQL Server verwenden soll.Set the locale for SQL Server to use.
ArbeitsspeicherlimitMemory limit Festlegen des Arbeitsspeicherlimits für SQL Server.Set the memory limit for SQL Server.
Microsoft Distributed Transaction CoordinatorMicrosoft Distributed Transaction Coordinator Konfigurieren von MS DTC unter Linux und Durchführen einer Problembehandlung.Configure and troubleshoot MSDTC on Linux.
Lizenzbedingungen für ML ServicesMLServices EULAs Festlegen, dass R- und Python-bezogene Lizenzbedingungen für mlservices-Pakete akzeptiert werden.Accept R and Python EULAs for mlservices packages. Gilt nur für SQL Server 2019.Applies to SQL Server 2019 only.
outboundnetworkaccessoutboundnetworkaccess Aktivieren des Zugriffs auf ausgehenden Netzwerkdatenverkehr für R-, Python- und Java-Erweiterungen von mlservices.Enable outbound network access for mlservices R, Python, and Java extensions.
TCP-PortTCP port Festlegen eines anderen Ports, auf dem SQL Server nach Verbindungen lauscht.Change the port where SQL Server listens for connections.
TLSTLS Konfigurieren der Verschlüsselung mit Transport Layer Security.Configure Transport Level Security.
AblaufverfolgungsflagsTraceflags Festlegen der Ablaufverfolgungsflags, die vom Dienst verwendet werden sollen.Set the traceflags that the service is going to use.

Tipp

Einige dieser Einstellungen können auch mit Umgebungsvariablen konfiguriert werden.Some of these settings can also be configured with environment variables. Weitere Informationen finden Sie unter Konfigurieren von SQL Server-Einstellungen mit Umgebungsvariablen.For more information, see Configure SQL Server settings with environment variables.

VerwendungstippsUsage tips

  • Nehmen Sie für Always On-Verfügbarkeitsgruppen und Cluster mit gemeinsam genutzten Datenträgern immer dieselben Konfigurationsänderungen an jedem Knoten vor.For Always On Availability Groups and shared disk clusters, always make the same configuration changes on each node.

  • Versuchen Sie bei Clustern mit gemeinsam genutzten Datenträgern nicht, den mssql-server-Dienst neu zu starten, um die Änderungen zu übernehmen.For the shared disk cluster scenario, do not attempt to restart the mssql-server service to apply changes. SQL Server wird als Anwendung ausgeführt.SQL Server is running as an application. Versetzen Sie die Ressource stattdessen zuerst in den Offline- und anschließend wieder in den Onlinezustand.Instead, take the resource offline and then back online.

  • In den Beispielen wird für die Ausführung von mssql-conf der vollständige Pfad /opt/mssql/bin/mssql-conf verwendet.These examples run mssql-conf by specifying the full path: /opt/mssql/bin/mssql-conf. Wenn Sie zu diesem Pfad navigieren, müssen Sie mssql-conf im aktuellen Verzeichnis ./mssql-conf ausführen.If you choose to navigate to that path instead, run mssql-conf in the context of the current directory: ./mssql-conf.

Aktivieren des SQL Server-AgentsEnable SQL Server Agent

Durch die Einstellung sqlagent.enabled wird der SQL Server-Agent aktiviert.The sqlagent.enabled setting enables SQL Server Agent. Standardmäßig ist der SQL Server-Agent deaktiviert.By default, SQL Server Agent is disabled. Wenn sqlagent.enabled nicht in der Einstellungsdatei „mssql.conf“ vorhanden ist, wird von SQL Server intern angenommen, dass der SQL Server-Agent deaktiviert ist.If sqlagent.enabled is not present in the mssql.conf settings file, then SQL Server internally assumes that SQL Server Agent is disabled.

Führen Sie die folgenden Schritte aus, um diese Einstellung zu ändern:To change this setting, use the following steps:

  1. Aktivieren Sie den SQL Server-Agent:Enable the SQL Server Agent:

    sudo /opt/mssql/bin/mssql-conf set sqlagent.enabled true 
    
  2. Starten Sie den SQL Server-Dienst neu:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    

Ändern der SQL Server-SortierungChange the SQL Server collation

Mit der Option set-collation kann ein anderer unterstützter Sortierungswert angegeben werden.The set-collation option changes the collation value to any of the supported collations.

  1. Sichern Sie zuerst alle Benutzerdatenbanken auf Ihrem Server.First backup any user databases on your server.

  2. Verwenden Sie dann die gespeicherte Prozedur sp_detach_db, um die Benutzerdatenbanken zu trennen.Then use the sp_detach_db stored procedure to detach the user databases.

  3. Führen Sie die Option set-collation aus, und folgen Sie den Anweisungen:Run the set-collation option and follow the prompts:

    sudo /opt/mssql/bin/mssql-conf set-collation
    
  4. Das mssql-conf-Hilfsprogramm versucht, den angegebenen Sortierungswert festzulegen und den Dienst neu zu starten.The mssql-conf utility will attempt to change to the specified collation value and restart the service. Wenn Fehler auftreten, wird ein Rollback ausgeführt, und die Sortierung wird auf den vorherigen Wert zurückgesetzt.If there are any errors, it rolls back the collation to the previous value.

  5. Stellen Sie die Sicherungen der Benutzerdatenbanken wieder her.Restore your user database backups.

Führen Sie die sys.fn_helpcollations-Funktion aus, um eine Liste der unterstützten Sortierungen anzuzeigen: SELECT Name from sys.fn_helpcollations().For a list of supported collations, run the sys.fn_helpcollations function: SELECT Name from sys.fn_helpcollations().

Konfigurieren von Einstellungen für KundenfeedbackConfigure customer feedback

Mit der Einstellung telemetry.customerfeedback können Sie festlegen, ob SQL Server Feedback an Microsoft sendet.The telemetry.customerfeedback setting changes whether SQL Server sends feedback to Microsoft or not. Standardmäßig ist dieser Wert für alle Editionen auf true festgelegt.By default, this value is set to true for all editions. Führen Sie die folgenden Befehle aus, um den Wert zu ändern:To change the value, run the following commands:

Wichtig

Sie können das Kundenfeedback für kostenlose Editionen von SQL Server, Express und Developer nicht deaktivieren.You can not turn off customer feedback for free editions of SQL Server, Express and Developer.

  1. Führen Sie das mssql-conf-Skript als Rootbenutzer mit dem Befehl set für telemetry.customerfeedback aus.Run the mssql-conf script as root with the set command for telemetry.customerfeedback. Im folgenden Beispiel wird das Kundenfeedback durch die Angabe von false deaktiviert.The following example turns off customer feedback by specifying false.

    sudo /opt/mssql/bin/mssql-conf set telemetry.customerfeedback false
    
  2. Starten Sie den SQL Server-Dienst neu:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    

Weitere Informationen finden Sie unter Kundenfeedback für SQL Server für Linux und SQL Server-Datenschutzbestimmungen.For more information, see Customer Feedback for SQL Server on Linux and the SQL Server Privacy Statement.

Ändern des Standardspeicherorts für das Verzeichnis der Datenbank- oder ProtokolldateienChange the default data or log directory location

Mit den Einstellungen filelocation.defaultdatadir und filelocation.defaultlogdir können Sie den Speicherort festlegen, an dem die neuen Datenbank- und Protokolldateien erstellt werden.The filelocation.defaultdatadir and filelocation.defaultlogdir settings change the location where the new database and log files are created. Der Standardspeicherort ist /var/opt/mssql/data.By default, this location is /var/opt/mssql/data. Führen Sie die folgenden Schritte aus, um diese Einstellungen zu ändern:To change these settings, use the following steps:

  1. Erstellen Sie das Zielverzeichnis für neue Datenbank- und Protokolldateien.Create the target directory for new database data and log files. Im folgenden Beispiel wird das Verzeichnis /tmp/data erstellt:The following example creates a new /tmp/data directory:

    sudo mkdir /tmp/data
    
  2. Legen Sie für das Verzeichnis den mssql-Benutzer als Besitzer und Gruppe fest:Change the owner and group of the directory to the mssql user:

    sudo chown mssql /tmp/data
    sudo chgrp mssql /tmp/data
    
  3. Verwenden Sie mssql-conf mit dem set-Befehl, um das Standarddatenverzeichnis zu ändern:Use mssql-conf to change the default data directory with the set command:

    sudo /opt/mssql/bin/mssql-conf set filelocation.defaultdatadir /tmp/data
    
  4. Starten Sie den SQL Server-Dienst neu:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    
  5. Nun werden alle Datenbankdateien für neu erstellte Datenbanken an diesem Speicherort gespeichert.Now all the database files for the new databases created will be stored in this new location. Wenn Sie für die Protokolldateien (LDF) der neuen Datenbanken einen anderen Speicherort festlegen möchten, können Sie den folgenden „set“-Befehl nutzen:If you would like to change the location of the log (.ldf) files of the new databases, you can use the following "set" command:

    sudo /opt/mssql/bin/mssql-conf set filelocation.defaultlogdir /tmp/log
    
  6. Auch dieser Befehl setzt voraus, dass das Verzeichnis /tmp/log vorhanden ist und dem Benutzer sowie der Gruppe mssql zugeordnet ist.This command also assumes that a /tmp/log directory exists, and that it is under the user and group mssql.

Ändern des Standardspeicherorts für das Verzeichnis der Masterdatenbank-DateienChange the default master database file directory location

Mit der Einstellung filelocation.masterdatafile und filelocation.masterlogfile können Sie einen anderen Speicherort festlegen, an dem die SQL Server-Engine nach Masterdatenbank-Dateien sucht.The filelocation.masterdatafile and filelocation.masterlogfile setting changes the location where the SQL Server engine looks for the master database files. Der Standardspeicherort ist /var/opt/mssql/data.By default, this location is /var/opt/mssql/data.

Führen Sie die folgenden Schritte aus, um diese Einstellungen zu ändern:To change these settings, use the following steps:

  1. Erstellen Sie das Zielverzeichnis für neue Fehlerprotokolldateien.Create the target directory for new error log files. Im folgenden Beispiel wird das Verzeichnis /tmp/masterdatabasedir erstellt:The following example creates a new /tmp/masterdatabasedir directory:

    sudo mkdir /tmp/masterdatabasedir
    
  2. Legen Sie für das Verzeichnis den mssql-Benutzer als Besitzer und Gruppe fest:Change the owner and group of the directory to the mssql user:

    sudo chown mssql /tmp/masterdatabasedir
    sudo chgrp mssql /tmp/masterdatabasedir
    
  3. Verwenden Sie mssql-conf mit dem set-Befehl, um das Standardverzeichnis der Masterdatenbank für die Masterdaten und Protokolldateien zu ändern:Use mssql-conf to change the default master database directory for the master data and log files with the set command:

    sudo /opt/mssql/bin/mssql-conf set filelocation.masterdatafile /tmp/masterdatabasedir/master.mdf
    sudo /opt/mssql/bin/mssql-conf set filelocation.masterlogfile /tmp/masterdatabasedir/mastlog.ldf
    

    Hinweis

    Dadurch werden nicht nur die Masterdaten und Protokolldateien, sondern auch das Standardverzeichnis für alle anderen Systemdatenbanken verschoben.In addition to moving the master data and log files, this also moves the default location for all other system databases.

  4. Halten Sie den SQL Server-Dienst an:Stop the SQL Server service:

    sudo systemctl stop mssql-server
    
  5. Verschieben Sie die Dateien „master.mdf“ und „masterlog.ldf“:Move the master.mdf and masterlog.ldf:

    sudo mv /var/opt/mssql/data/master.mdf /tmp/masterdatabasedir/master.mdf 
    sudo mv /var/opt/mssql/data/mastlog.ldf /tmp/masterdatabasedir/mastlog.ldf
    
  6. Starten Sie den SQL Server-Dienst:Start the SQL Server service:

    sudo systemctl start mssql-server
    

    Hinweis

    Wenn SQL Server die Dateien „master.mdf“ und „mastlog.ldf“ nicht im angegebenen Verzeichnis findet, wird eine auf Vorlagen basierende Kopie der Systemdatenbanken automatisch im angegebenen Verzeichnis erstellt. Anschließend wird SQL Server gestartet.If SQL Server cannot find master.mdf and mastlog.ldf files in the specified directory, a templated copy of the system databases will be automatically created in the specified directory, and SQL Server will successfully start up. Metadaten wie Benutzerdatenbanken, Serveranmeldungen, Serverzertifikate, Verschlüsselungsschlüssel, SQL Server-Agent-Aufträge oder alte Systemadministrator-Anmeldekennwörter werden jedoch nicht in der neuen Masterdatenbank aktualisiert.However, metadata such as user databases, server logins, server certificates, encryption keys, SQL agent jobs, or old SA login password will not be updated in the new master database. Wenn Sie die vorhandenen Metadaten weiterhin verwenden möchten, müssen Sie SQL Server anhalten, die alten Dateien „master.mdf“ und „mastlog.ldf“ an den angegebenen Speicherort verschieben und SQL Server anschließend neu starten.You will have to stop SQL Server and move your old master.mdf and mastlog.ldf to the new specified location and start SQL Server to continue using the existing metadata.

Ändern der Masterdatenbank-DateinamenChange the name of master database files

Mit der Einstellung filelocation.masterdatafile und filelocation.masterlogfile können Sie einen anderen Speicherort festlegen, an dem die SQL Server-Engine nach Masterdatenbank-Dateien sucht.The filelocation.masterdatafile and filelocation.masterlogfile setting changes the location where the SQL Server engine looks for the master database files. Außerdem können Sie damit den Namen der Masterdatenbank- und Protokolldateien ändern.You can also use this to change the name of the master database and log files.

Führen Sie die folgenden Schritte aus, um diese Einstellungen zu ändern:To change these settings, use the following steps:

  1. Halten Sie den SQL Server-Dienst an:Stop the SQL Server service:

    sudo systemctl stop mssql-server
    
  2. Verwenden Sie mssql-conf mit dem set-Befehl, um die Masterdatenbank-Namen für die Masterdaten und Protokolldateien zu ändern:Use mssql-conf to change the expected master database names for the master data and log files with the set command:

    sudo /opt/mssql/bin/mssql-conf set filelocation.masterdatafile /var/opt/mssql/data/masternew.mdf
    sudo /opt/mssql/bin/mssql-conf set filelocation.mastlogfile /var/opt/mssql/data/mastlognew.ldf
    

    Wichtig

    Sie können den Namen der Masterdatenbank- und Protokolldateien erst ändern, nachdem SQL Server gestartet wurde.You can only change the name of the master database and log files after SQL Server has started successfully. Vor der ersten Ausführung wird von SQL Server vorausgesetzt, dass die Dateien „master.mdf“ und „mastlog.ldf“ heißen.Before the initial run, SQL Server expects the files to be named master.mdf and mastlog.ldf.

  3. Ändern Sie den Namen der Masterdatenbank-Daten- und Protokolldateien:Change the name of the master database data and log files

    sudo mv /var/opt/mssql/data/master.mdf /var/opt/mssql/data/masternew.mdf
    sudo mv /var/opt/mssql/data/mastlog.ldf /var/opt/mssql/data/mastlognew.ldf
    
  4. Starten Sie den SQL Server-Dienst:Start the SQL Server service:

    sudo systemctl start mssql-server
    

Ändern des Standardspeicherorts für das SpeicherabbildverzeichnisChange the default dump directory location

Mit der Einstellung filelocation.defaultdumpdir können Sie einen anderen Standardspeicherort festlegen, an dem die Speicher- und SQL-Abbilder erstellt werden, wenn es zu einem Absturz kommt.The filelocation.defaultdumpdir setting changes the default location where the memory and SQL dumps are generated whenever there is a crash. Standardmäßig werden diese Dateien im Verzeichnis /var/opt/mssql/log erstellt.By default, these files are generated in /var/opt/mssql/log.

Verwenden Sie die folgenden Befehle, um einen neuen Speicherort festzulegen:To set up this new location, use the following commands:

  1. Erstellen Sie das Zielverzeichnis für neue Speicherabbilddateien.Create the target directory for new dump files. Im folgenden Beispiel wird das Verzeichnis /tmp/dump erstellt:The following example creates a new /tmp/dump directory:

    sudo mkdir /tmp/dump
    
  2. Legen Sie für das Verzeichnis den mssql-Benutzer als Besitzer und Gruppe fest:Change the owner and group of the directory to the mssql user:

    sudo chown mssql /tmp/dump
    sudo chgrp mssql /tmp/dump
    
  3. Verwenden Sie mssql-conf mit dem set-Befehl, um das Standarddatenverzeichnis zu ändern:Use mssql-conf to change the default data directory with the set command:

    sudo /opt/mssql/bin/mssql-conf set filelocation.defaultdumpdir /tmp/dump
    
  4. Starten Sie den SQL Server-Dienst neu:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    

Ändern des Standardspeicherorts für das Verzeichnis der FehlerprotokolldateienChange the default error log file directory location

Mit der Einstellung filelocation.errorlogfile können Sie einen anderen Speicherort festlegen, an dem Dateien für Fehlerprotokolle, Standardprofiler-Ablaufverfolgungen, XE-Systemintegritätssitzungen und Hekaton-XE-Sitzungen erstellt werden.The filelocation.errorlogfile setting changes the location where the new error log, default profiler trace, system health session XE and Hekaton session XE files are created. Der Standardspeicherort ist /var/opt/mssql/log.By default, this location is /var/opt/mssql/log. Das Verzeichnis, in dem die SQL-Fehlerprotokolldatei abgelegt wird, wird zum Standardverzeichnis für andere Protokolle.The directory in which SQL errorlog file is set becomes the default log directory for other logs.

Gehen Sie wie folgt vor, um diese Einstellungen zu ändern:To change these settings:

  1. Erstellen Sie das Zielverzeichnis für neue Fehlerprotokolldateien.Create the target directory for new error log files. Im folgenden Beispiel wird das Verzeichnis /tmp/logs erstellt:The following example creates a new /tmp/logs directory:

    sudo mkdir /tmp/logs
    
  2. Legen Sie für das Verzeichnis den mssql-Benutzer als Besitzer und Gruppe fest:Change the owner and group of the directory to the mssql user:

    sudo chown mssql /tmp/logs
    sudo chgrp mssql /tmp/logs
    
  3. Verwenden Sie mssql-conf mit dem set-Befehl, um den Standardnamen für Fehlerprotokolle zu ändern:Use mssql-conf to change the default errorlog filename with the set command:

    sudo /opt/mssql/bin/mssql-conf set filelocation.errorlogfile /tmp/logs/errorlog
    
  4. Starten Sie den SQL Server-Dienst neu:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    

Ändern des Standardspeicherorts für das SicherungsverzeichnisChange the default backup directory location

Mit der Einstellung filelocation.defaultbackupdir können Sie einen anderen Standardspeicherort festlegen, an dem Sicherungsdateien erstellt werden.The filelocation.defaultbackupdir setting changes the default location where the backup files are generated. Standardmäßig werden diese Dateien im Verzeichnis /var/opt/mssql/data erstellt.By default, these files are generated in /var/opt/mssql/data.

Verwenden Sie die folgenden Befehle, um einen neuen Speicherort festzulegen:To set up this new location, use the following commands:

  1. Erstellen Sie das Zielverzeichnis für neue Sicherungsdateien.Create the target directory for new backup files. Im folgenden Beispiel wird das Verzeichnis /tmp/backup erstellt:The following example creates a new /tmp/backup directory:

    sudo mkdir /tmp/backup
    
  2. Legen Sie für das Verzeichnis den mssql-Benutzer als Besitzer und Gruppe fest:Change the owner and group of the directory to the mssql user:

    sudo chown mssql /tmp/backup
    sudo chgrp mssql /tmp/backup
    
  3. Verwenden Sie mssql-conf mit dem „set“-Befehl, um das Standardsicherungsverzeichnis zu ändern:Use mssql-conf to change the default backup directory with the "set" command:

    sudo /opt/mssql/bin/mssql-conf set filelocation.defaultbackupdir /tmp/backup
    
  4. Starten Sie den SQL Server-Dienst neu:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    

Festlegen der Einstellungen für KernspeicherabbilderSpecify core dump settings

Wenn in einem SQL Server-Prozess eine Ausnahme auftritt, erstellt SQL Server ein Speicherabbild.If an exception occurs in one of the SQL Server processes, SQL Server creates a memory dump.

Sie können mit den Optionen coredump.coredumptype und coredump.captureminiandfull zwei Typen von Speicherabbildern festlegen, die von SQL Server erfasst werden.There are two options for controlling the type of memory dumps that SQL Server collects: coredump.coredumptype and coredump.captureminiandfull. Diese Optionen beziehen sich auf die beiden Phasen zur Erfassung von Kernspeicherabbildern.These relate to the two phases of core dump capture.

Die Erfassung in der ersten Phase wird durch die Einstellung coredump.coredumptype gesteuert. Mit dieser wird der Typ der Speicherabbilddatei festgelegt, die bei einer Ausnahme erstellt wird.The first phase capture is controlled by the coredump.coredumptype setting, which determines the type of dump file generated during an exception. Die zweite Phase wird durch die Einstellung coredump.captureminiandfull aktiviert.The second phase is enabled when the coredump.captureminiandfull setting. Wenn coredump.captureminiandfull auf „true“ festgelegt ist, werden die durch coredump.coredumptype angegebene Speicherabbilddatei und ein zweites Minimalspeicherabbild erstellt.If coredump.captureminiandfull is set to true, the dump file specified by coredump.coredumptype is generated and a second mini dump is also generated. Wenn Sie coredump.captureminiandfull auf „false“ festlegen, wird die zweite Erfassungsphase deaktiviert.Setting coredump.captureminiandfull to false disables the second capture attempt.

  1. Mit der Einstellung coredump.captureminiandfull können Sie festlegen, ob sowohl Minimalspeicherabbilder als auch vollständige Speicherabbilder erfasst werden.Decide whether to capture both mini and full dumps with the coredump.captureminiandfull setting.

    sudo /opt/mssql/bin/mssql-conf set coredump.captureminiandfull <true or false>
    

    Die Standardeinstellung ist false.Default: false

  2. Mit der Einstellung coredump.coredumptype können Sie den Typ der Speicherabbilddatei angeben.Specify the type of dump file with the coredump.coredumptype setting.

    sudo /opt/mssql/bin/mssql-conf set coredump.coredumptype <dump_type>
    

    Die Standardeinstellung ist miniplus.Default: miniplus

    In der folgenden Tabelle sind die möglichen Werte für coredump.coredumptype aufgeführt.The following table lists the possible coredump.coredumptype values.

    TypType und BeschreibungDescription
    minimini „mini“ ist der kleinste Speicherabbild-Dateityp.Mini is the smallest dump file type. Mithilfe von Linux-Systeminformationen werden die Threads und Module eines Prozesses ermittelt.It uses the Linux system information to determine threads and modules in the process. Das Speicherabbild enthält nur die Threadstapel und Module der Hostumgebung.The dump contains only the host environment thread stacks and modules. Es umfasst keine indirekten Speicherverweise oder globale Variablen.It does not contain indirect memory references or globals.
    miniplusminiplus „miniplus“ ist mit „mini“ vergleichbar, jedoch werden zusätzliche Speicherbereiche erfasst.MiniPlus is similar to mini, but it includes additional memory. Interne Vorgänge in SQL PAL und in der Hostumgebung werden berücksichtigt, wodurch dem Speicherabbild mehrere Speicherbereiche hinzugefügt werden. Diese betreffen:It understands the internals of SQLPAL and the host environment, adding the following memory regions to the dump:
    – verschiedene globale Variablen- Various globals
    – sämtlichen Speicher über 64 TB- All memory above 64TB
    – benannte Bereiche in /proc/$pid/maps- All named regions found in /proc/$pid/maps
    – indirekten Arbeitsspeicher aus Threads und Stapeln- Indirect memory from threads and stacks
    – Threadinformationen- Thread information
    – zugeordnete TEBs und PEBs- Associated Teb's and Peb's
    – Modulinformationen- Module Information
    – VMM und die VAD-Struktur- VMM and VAD tree
    filteredfiltered Für „filtered“ wird ein subtraktionsbasierter Entwurf verwendet, bei dem sämtlicher Speicher im Prozess erfasst wird, falls er nicht explizit ausgeschlossen wird.Filtered uses a subtraction-based design where all memory in the process is included unless specifically excluded. Interne Vorgänge in SQL PAL und in der Hostumgebung werden berücksichtigt. Bestimmte Bereiche werden jedoch nicht im Speicherabbild erfasst.The design understands the internals of SQLPAL and the host environment, excluding certain regions from the dump.
    fullfull Durch „full“ wird ein vollständiges Prozessspeicherabbild erstellt, das sämtliche Bereiche in /proc/$pid/maps einschließt.Full is a complete process dump that includes all regions located in /proc/$pid/maps. Dieser Vorgang wird nicht durch die Einstellung coredump.captureminiandfull gesteuert.This is not controlled by coredump.captureminiandfull setting.

Festlegen des Standardprofils von Datenbank-E-Mails für SQL Server für LinuxSet the default database mail profile for SQL Server on Linux

Mit der Einstellung sqlpagent.databasemailprofile können Sie das Standardprofil von Datenbank-E-Mails für E-Mail-Benachrichtigungen festlegen.The sqlpagent.databasemailprofile allows you to set the default DB Mail profile for email alerts.

sudo /opt/mssql/bin/mssql-conf set sqlagent.databasemailprofile <profile_name>

HochverfügbarkeitHigh Availability

Mit der Option hadr.hadrenabled können Sie Verfügbarkeitsgruppen auf Ihrer SQL Server-Instanz aktivieren.The hadr.hadrenabled option enables availability groups on your SQL Server instance. Mit dem folgenden Befehl wird die Einstellung hadr.hadrenabled auf 1 festgelegt, wodurch Verfügbarkeitsgruppen aktiviert werden.The following command enables availability groups by setting hadr.hadrenabled to 1. Sie müssen SQL Server neu starten, damit die Einstellung übernommen wird.You must restart SQL Server for the setting to take effect.

sudo /opt/mssql/bin/mssql-conf set hadr.hadrenabled  1
sudo systemctl restart mssql-server

Wie Sie diese Einstellung für Verfügbarkeitsgruppen nutzen, wird in den folgenden beiden Artikeln beschrieben:For information on how this is used with availability groups, see the following two topics.

Festlegen des Verzeichnisses für lokale ÜberwachungenSet local audit directory

Mit der Einstellung telemetry.userrequestedlocalauditdirectory werden lokale Überwachungen aktiviert. Zusätzlich können Sie das Verzeichnis festlegen, in dem die Protokolle für lokale Überwachungen erstellt werden.The telemetry.userrequestedlocalauditdirectory setting enables Local Audit and lets you set the directory where the Local Audit logs are created.

  1. Erstellen Sie ein Zielverzeichnis für neue Protokolle von lokalen Überwachungen.Create a target directory for new Local Audit logs. Im folgenden Beispiel wird das Verzeichnis /tmp/audit erstellt:The following example creates a new /tmp/audit directory:

    sudo mkdir /tmp/audit
    
  2. Ändern Sie Besitzer und Gruppe des Verzeichnisses in den mssql-Benutzer:Change the owner and group of the directory to the mssql user:

    sudo chown mssql /tmp/audit
    sudo chgrp mssql /tmp/audit
    
  3. Führen Sie das mssql-conf-Skript als Rootbenutzer mit dem set-Befehl für telemetry.userrequestedlocalauditdirectory aus:Run the mssql-conf script as root with the set command for telemetry.userrequestedlocalauditdirectory:

    sudo /opt/mssql/bin/mssql-conf set telemetry.userrequestedlocalauditdirectory /tmp/audit
    
  4. Starten Sie den SQL Server-Dienst neu:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    

Weitere Informationen finden Sie unter Kundenfeedback für SQL Server für Linux.For more information, see Customer Feedback for SQL Server on Linux.

Ändern des SQL Server-GebietsschemasChange the SQL Server locale

Mit der Einstellung language.lcid können Sie ein anderes SQL Server-Gebietsschema festlegen. Dazu nutzen geben Sie einen der unterstützten Gebietsschemabezeichner (LCID) an.The language.lcid setting changes the SQL Server locale to any supported language identifier (LCID).

  1. Im folgenden Beispiel wird Französisch (1036) als Gebietsschema festgelegt:The following example changes the locale to French (1036):

    sudo /opt/mssql/bin/mssql-conf set language.lcid 1036
    
  2. Starten Sie den SQL Server-Dienst neu, damit die Änderungen übernommen werden:Restart the SQL Server service to apply the changes:

    sudo systemctl restart mssql-server
    

Festlegen des ArbeitsspeicherlimitsSet the memory limit

Mit der Einstellung memory.memorylimitmb können Sie festlegen, wie viel verfügbarer physischer Speicher (in MB) für SQL Server bereitgestellt wird.The memory.memorylimitmb setting controls the amount physical memory (in MB) available to SQL Server. Der Standardwert ist 80 % des physischen Speichers.The default is 80% of the physical memory.

  1. Führen Sie das mssql-conf-Skript als Rootbenutzer mit dem Befehl set für memory.memorylimitmb aus.Run the mssql-conf script as root with the set command for memory.memorylimitmb. Im folgenden Beispiel wird als verfügbarer Arbeitsspeicher für SQL Server 3,25 GB (3.328 MB) festgelegt.The following example changes the memory available to SQL Server to 3.25 GB (3328 MB).

    sudo /opt/mssql/bin/mssql-conf set memory.memorylimitmb 3328
    
  2. Starten Sie den SQL Server-Dienst neu, damit die Änderungen übernommen werden:Restart the SQL Server service to apply the changes:

    sudo systemctl restart mssql-server
    

Konfigurieren von MS DTCConfigure MSDTC

Mit den Einstellungen network.rpcport und distributedtransaction.servertcpport können Sie den Microsoft Distributed Transaction Coordinator (MS DTC) konfigurieren.The network.rpcport and distributedtransaction.servertcpport settings are used to configure the Microsoft Distributed Transaction Coordinator (MSDTC). Führen Sie die folgenden Befehle aus, um diese Einstellungen zu ändern:To change these settings, run the following commands:

  1. Führen Sie das mssql-conf-Skript als Rootbenutzer mit dem Befehl set für „network.rpcport“ aus:Run the mssql-conf script as root with the set command for "network.rpcport":

    sudo /opt/mssql/bin/mssql-conf set network.rpcport <rcp_port>
    
  2. Legen Sie anschließend die Einstellung „distributedtransaction.servertcpport“ fest:Then set the "distributedtransaction.servertcpport" setting:

    sudo /opt/mssql/bin/mssql-conf set distributedtransaction.servertcpport <servertcpport_port>
    

Zusätzlich zum Festlegen dieser Werte müssen Sie auch das Routing konfigurieren und die Firewall für Port 135 aktualisieren.In addition to setting these values, you must also configure routing and update the firewall for port 135. Weitere Informationen hierzu finden Sie unter Konfigurieren von MS DTC unter Linux.For more information on how to do this, see How to configure MSDTC on Linux.

Für mssql-conf sind einige weitere Einstellungen verfügbar, mit denen Sie MS DTC überwachen und eine Problembehandlung durchführen können.There are several other settings for mssql-conf that you can use to monitor and troubleshoot MSDTC. Diese Einstellungen werden in der folgenden Tabelle kurz beschrieben.The following table briefly describes these settings. Weitere Informationen zu deren Verwendung finden Sie im Windows-Supportartikel Aktivieren der Diagnoseablaufverfolgungen für MS DTC.For more information on their use, see the details in the Windows support article, How to enable diagnostic tracing for MS DTC.

mssql-conf-Einstellungmssql-conf setting und BeschreibungDescription
distributedtransaction.allowonlysecurerpccallsdistributedtransaction.allowonlysecurerpccalls Konfigurieren von sicheren RPC-Aufrufen für verteilte Transaktionen.Configure secure only RPC calls for distributed transactions
distributedtransaction.fallbacktounsecurerpcifnecessarydistributedtransaction.fallbacktounsecurerpcifnecessary Konfigurieren von sicheren RPC-Aufrufen für verteilteConfigure security only RPC calls for distributed Transaktionentransactions
distributedtransaction.maxlogsizedistributedtransaction.maxlogsize Dateigröße des DTC-Transaktionsprotokolls in MB.DTC transaction log file size in MB. Der Standardwert ist 64 MB.Default is 64MB
distributedtransaction.memorybuffersizedistributedtransaction.memorybuffersize Puffergröße des Ringspeichers, in dem Ablaufverfolgungen gespeichert werden.Circular buffer size in which traces are stored. Die Größe wird in MB angegeben. Der Standardwert ist 10 MB.This size is in MB and default is 10MB
distributedtransaction.servertcpportdistributedtransaction.servertcpport Port des MS DTC-RPC-Servers.MSDTC rpc server port
distributedtransaction.trace_cmdistributedtransaction.trace_cm Ablaufverfolgungen im Verbindungs-Manager.Traces in the connection manager
distributedtransaction.trace_contactdistributedtransaction.trace_contact Ablaufverfolgungen für den Kontaktpool und für Kontakte.Traces the contact pool and contacts
distributedtransaction.trace_gatewaydistributedtransaction.trace_gateway Ablaufverfolgungen; GatewayquelleTraces Gateway source
distributedtransaction.trace_logdistributedtransaction.trace_log Protokollablaufverfolgung.Log tracing
distributedtransaction.trace_miscdistributedtransaction.trace_misc Ablaufverfolgungen, die nicht in die anderen Kategorien fallen.Traces that cannot be categorized into the other categories
distributedtransaction.trace_proxydistributedtransaction.trace_proxy Ablaufverfolgungen, die im MS DTC-Proxy generiert werden.Traces that are generated in the MSDTC proxy
distributedtransaction.trace_svcdistributedtransaction.trace_svc Ablaufverfolgungen für den Start der EXE-Datei und des DienstsTraces service and .exe file startup
distributedtransaction.trace_tracedistributedtransaction.trace_trace Die eigentliche Ablaufverfolgungsinfrastruktur.The trace infrastructure itself
distributedtransaction.trace_utildistributedtransaction.trace_util Für Ablaufverfolgungen verwendete Hilfsroutinen, die von unterschiedlichen Speicherorten aus aufgerufen werden.Traces utility routines that are called from multiple locations
distributedtransaction.trace_xadistributedtransaction.trace_xa Ablaufverfolgungsquelle für XA-Transaktions-Manager (XATM).XA Transaction Manager (XATM) tracing source
distributedtransaction.tracefilepathdistributedtransaction.tracefilepath Ordner, in dem Ablaufverfolgungsdateien gespeichert werden sollen.Folder in which trace files should be stored
distributedtransaction.turnoffrpcsecuritydistributedtransaction.turnoffrpcsecurity Aktivieren oder Deaktivieren der RPC-Sicherheit für verteilte Transaktionen.Enable or disable RPC security for distributed transactions

Akzeptieren der Lizenzbedingungen für ML ServicesAccept MLServices EULAs

Wenn Sie der Datenbank-Engine R- oder Python-Pakete für maschinelles Lernen hinzufügen möchten, müssen Sie die Lizenzbedingungen für die Open-Source-Verteilungen von R und Python akzeptieren.Adding machine learning R or Python packages to the database engine requires that you accept the licensing terms for open-source distributions of R and Python. In der folgenden Tabelle werden alle verfügbaren Befehle oder Optionen aufgelistet, die sich auf die mlservices-Lizenzbedingungen beziehen.The following table enumerates all available commands or options related to mlservices EULAs. Für R und Python wird je nach Installation der gleiche Lizenzbedingungsparameter verwendet.The same EULA parameter is used for R and Python, depending on what you installed.

# For all packages: database engine and mlservices
# Setup prompts for mlservices EULAs, which you need to accept
sudo /opt/mssql/bin/mssql-conf setup

# Add R or Python to an existing installation
sudo /opt/mssql/bin/mssql-conf setup accept-eula-ml

# Alternative valid syntax
# Adds the EULA section to the INI and sets acceptulam to yes
sudo /opt/mssql/bin/mssql-conf set EULA accepteulaml Y

# Rescind EULA acceptance and removes the setting
sudo /opt/mssql/bin/mssql-conf unset EULA accepteulaml

In der Datei mssql.conf können Sie direkt festlegen, dass die Lizenzbedingungen akzeptiert werden:You can also add EULA acceptance directly to the mssql.conf file:

[EULA]
accepteula = Y
accepteulaml = Y

Aktivieren des Zugriffs auf ausgehenden NetzwerkdatenverkehrEnable outbound network access

In SQL Server Machine Learning Services haben R-, Python- und Java-Erweiterungen standardmäßig keinen Zugriff auf ausgehenden Netzwerkdatenverkehr.Outbound network access for R, Python, and Java extensions in the SQL Server Machine Learning Services feature is disabled by default. Sie können mit mssql-conf die boolesche Eigenschaft „outboundnetworkaccess“ festlegen, um ausgehende Anforderungen zu aktivieren.To enable outbound requests, set the "outboundnetworkaccess" Boolean property using mssql-conf.

Starten Sie anschließend das SQL Server-Launchpad neu, um die aktualisierten Werte aus der INI-Datei zu lesen.After setting the property, restart SQL Server Launchpad service to read the updated values from the INI file. Wenn eine Erweiterbarkeitseinstellung geändert wird, werden Sie in einer Neustartmeldung darauf hingewiesen.A restart message reminds you whenever an extensibility-related setting is modified.

# Adds the extensibility section and property.
# Sets "outboundnetworkaccess" to true.
# This setting is required if you want to access data or operations off the server.
sudo /opt/mssql/bin/mssql-conf set extensibility outboundnetworkaccess 1

# Turns off network access but preserves the setting
sudo /opt/mssql/bin/mssql-conf set extensibility outboundnetworkaccess 0

# Removes the setting and rescinds network access
sudo /opt/mssql/bin/mssql-conf unset extensibility.outboundnetworkaccess

Sie können „outboundnetworkaccess“ auch direkt der Datei mssql.conf hinzufügen:You can also add "outboundnetworkaccess" directly to the mssql.conf file:

[extensibility]
outboundnetworkaccess = 1

Ändern des TCP-PortsChange the TCP port

Mit der Einstellung network.tcpport können Sie einen anderen TCP-Port festlegen, auf dem SQL Server nach Verbindungen lauscht.The network.tcpport setting changes the TCP port where SQL Server listens for connections. In der Standardeinstellung ist dies der Port 1433.By default, this port is set to 1433. Führen Sie die folgenden Befehle aus, um den Port zu ändern:To change the port, run the following commands:

  1. Führen Sie das mssql-conf-Skript als Rootbenutzer mit dem Befehl „set“ für „network.tcpport“ aus:Run the mssql-conf script as root with the "set" command for "network.tcpport":

    sudo /opt/mssql/bin/mssql-conf set network.tcpport <new_tcp_port>
    
  2. Starten Sie den SQL Server-Dienst neu:Restart the SQL Server service:

    sudo systemctl restart mssql-server
    
  3. Wenn Sie nun eine Verbindung mit SQL Server herstellen, müssen Sie nach dem Hostnamen oder der IP-Adresse den benutzerdefinierten Port angeben und ihn mit einem Komma abtrennen.When connecting to SQL Server now, you must specify the custom port with a comma (,) after the hostname or IP address. Wenn Sie beispielsweise eine Verbindung mit sqlcmd herstellen möchten, müssen Sie den folgenden Befehl verwenden:For example, to connect with SQLCMD, you would use the following command:

    sqlcmd -S localhost,<new_tcp_port> -U test -P test
    

Festlegen von TLS-EinstellungenSpecify TLS settings

Mit den folgenden Optionen können Sie TLS für eine SQL Server-Instanz konfigurieren, die unter Linux ausgeführt wird.The following options configure TLS for an instance of SQL Server running on Linux.

OptionOption und BeschreibungDescription
network.forceencryptionnetwork.forceencryption Wenn für die Option der Wert 1 festgelegt ist, erzwingt SQL ServerSQL Server, dass alle Verbindungen verschlüsselt werden.If 1, then SQL ServerSQL Server forces all connections to be encrypted. Der Standardwert für diese Option ist 0.By default, this option is 0.
network.tlscertnetwork.tlscert Der absolute Pfad zur Zertifikatdatei, die SQL ServerSQL Server für TLS verwendet.The absolute path to the certificate file that SQL ServerSQL Server uses for TLS. Beispiel: /etc/ssl/certs/mssql.pem Das mssql-Konto muss auf die Zertifikatdatei zugreifen können.Example: /etc/ssl/certs/mssql.pem The certificate file must be accessible by the mssql account. Microsoft empfiehlt, den Zugriff auf die Datei mithilfe von chown mssql:mssql <file>; chmod 400 <file> einzuschränken.Microsoft recommends restricting access to the file using chown mssql:mssql <file>; chmod 400 <file>.
network.tlskeynetwork.tlskey Der absolute Pfad zur Datei mit dem privaten Schlüssel, die SQL ServerSQL Server für TLS verwendet.The absolute path to the private key file that SQL ServerSQL Server uses for TLS. Beispiel: /etc/ssl/private/mssql.key Das mssql-Konto muss auf die Zertifikatdatei zugreifen können.Example: /etc/ssl/private/mssql.key The certificate file must be accessible by the mssql account. Microsoft empfiehlt, den Zugriff auf die Datei mithilfe von chown mssql:mssql <file>; chmod 400 <file> einzuschränken.Microsoft recommends restricting access to the file using chown mssql:mssql <file>; chmod 400 <file>.
network.tlsprotocolsnetwork.tlsprotocols Eine durch Trennzeichen getrennte Liste mit TLS-Protokollen, die von SQL Server zugelassen werden.A comma-separated list of which TLS protocols are allowed by SQL Server. SQL ServerSQL Server versucht immer, das sicherste Protokoll zu verwenden.always attempts to negotiate the strongest allowed protocol. Wenn ein Client keines der zulässigen Protokolle unterstützt, lehnt SQL ServerSQL Server den Verbindungsversuch ab.If a client does not support any allowed protocol, SQL ServerSQL Server rejects the connection attempt. Aus Kompatibilitätsgründen sind alle unterstützten Protokollversionen (1.2, 1.1, 1.0) standardmäßig zulässig.For compatibility, all supported protocols are allowed by default (1.2, 1.1, 1.0). Wenn die Clients TLS 1.2 unterstützen, empfiehlt Microsoft, nur diese Version zuzulassen.If your clients support TLS 1.2, Microsoft recommends allowing only TLS 1.2.
network.tlsciphersnetwork.tlsciphers Mit dieser Einstellung können Sie festlegen, welche Verschlüsselungsverfahren von SQL ServerSQL Server für TLS zugelassen werden.Specifies which ciphers are allowed by SQL ServerSQL Server for TLS. Das Format für diese Zeichenfolge muss dem der Liste der Verschlüsselungsverfahren für OpenSSL entsprechen.This string must be formatted per OpenSSL's cipher list format. In der Regel müssen Sie diese Option nicht ändern.In general, you should not need to change this option.
Die folgenden Verschlüsselungsverfahren sind standardmäßig zulässig:By default, the following ciphers are allowed:
ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-SHA:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-SHA256:AES128-SHA256:AES256-SHA:AES128-SHA
network.kerberoskeytabfilenetwork.kerberoskeytabfile Pfad zur Kerberos-SchlüsseltabellendateiPath to the Kerberos keytab file

Ein Beispiel für die Verwendung der TLS-Einstellungen finden Sie unter Verschlüsseln von SQL Server für Linux-Verbindungen.For an example of using the TLS settings, see Encrypting Connections to SQL Server on Linux.

Aktivieren oder Deaktivieren von AblaufverfolgungsflagsEnable/Disable traceflags

Mit der Option traceflag können Sie Ablaufverfolgungsflags für den Start des SQL Server-Diensts aktivieren oder deaktivieren.This traceflag option enables or disables traceflags for the startup of the SQL Server service. Verwenden Sie die folgenden Befehle, um ein Ablaufverfolgungsflag zu aktivieren oder zu deaktivieren:To enable/disable a traceflag use the following commands:

  1. Aktivieren Sie mithilfe des folgenden Befehls ein Ablaufverfolgungsflag.Enable a traceflag using the following command. Für das Ablaufverfolgungsflag 1234 können Sie beispielsweise wie folgt vorgehen:For example, for Traceflag 1234:

    sudo /opt/mssql/bin/mssql-conf traceflag 1234 on
    
  2. Sie können mehrere Ablaufverfolgungsflags aktivieren, indem Sie sie separat angeben:You can enable multiple traceflags by specifying them separately:

    sudo /opt/mssql/bin/mssql-conf traceflag 2345 3456 on
    
  3. Auf ähnliche Weise können Sie ein oder mehrere aktivierte Ablaufverfolgungsflags deaktivieren, indem Sie sie angeben und den off-Parameter ergänzen:In a similar way, you can disable one or more enabled traceflags by specifying them and adding the off parameter:

    sudo /opt/mssql/bin/mssql-conf traceflag 1234 2345 3456 off
    
  4. Starten Sie den SQL Server-Dienst neu, damit die Änderungen übernommen werden:Restart the SQL Server service to apply the changes:

    sudo systemctl restart mssql-server
    

Löschen einer EinstellungRemove a setting

Sie können eine Einstellung löschen, die Sie mit mssql-conf set vorgenommen haben. Rufen Sie dazu mssql-conf mit der unset-Option und dem Namen der Einstellung auf.To unset any setting made with mssql-conf set, call mssql-conf with the unset option and the name of the setting. Dadurch wird die Einstellung auf den Standardwert zurückgesetzt.This clears the setting, effectively returning it to its default value.

  1. Im folgenden Beispiel wird der Wert der Option network.tcpport gelöscht.The following example clears the network.tcpport option.

    sudo /opt/mssql/bin/mssql-conf unset network.tcpport
    
  2. Starten Sie den SQL Server-Dienst neu.Restart the SQL Server service.

    sudo systemctl restart mssql-server
    

Anzeigen der aktuellen EinstellungenView current settings

Sie können sich alle vorgenommen Einstellungen anzeigen lassen. Führen Sie dazu den folgenden Befehl aus, um die Inhalte der Datei mssql.conf auszugeben:To view any configured settings, run the following command to output the contents of the mssql.conf file:

sudo cat /var/opt/mssql/mssql.conf

Wenn in der Datei bestimmte Einstellungen nicht aufgeführt sind, werden für diese die Standardwerte verwendet.Note that any settings not shown in this file are using their default values. Der nächste Abschnitt enthält eine mssql.conf-Beispieldatei.The next section provides a sample mssql.conf file.

mssql.conf-Formatmssql.conf format

Die Datei /var/opt/mssql/mssql.conf, deren Inhalt weiter unten aufgeführt ist, enthält für jede Einstellung ein Beispiel.The following /var/opt/mssql/mssql.conf file provides an example for each setting. Sie können dieses Format verwenden, um bei Bedarf Änderungen an der Datei mssql.conf manuell vorzunehmen.You can use this format to manually make changes to the mssql.conf file as needed. Wenn Sie so vorgehen, müssen Sie SQL Server neu starten, damit die Änderungen übernommen werden.If you do manually change the file, you must restart SQL Server before the changes are applied. Wenn Sie die Datei mssql.conf mit Docker verwenden möchten, muss Docker die Daten dauerhaft speichern.To use the mssql.conf file with Docker, you must have Docker persist your data. Fügen Sie dazu zuerst Ihrem Hostverzeichnis eine vollständige mssql.conf-Datei hinzu, und führen Sie dann den Container aus.First add a complete mssql.conf file to your host directory and then run the container. Ein Beispiel hierfür finden Sie unter Kundenfeedback.There is an example of this in Customer Feedback.

[EULA]
accepteula = Y

[coredump]
captureminiandfull = true
coredumptype = full

[filelocation]
defaultbackupdir = /var/opt/mssql/data/
defaultdatadir = /var/opt/mssql/data/
defaultdumpdir = /var/opt/mssql/data/
defaultlogdir = /var/opt/mssql/data/

[hadr]
hadrenabled = 0

[language]
lcid = 1033

[memory]
memorylimitmb = 4096

[network]
forceencryption = 0
ipaddress = 10.192.0.0
kerberoskeytabfile = /var/opt/mssql/secrets/mssql.keytab
tcpport = 1401
tlscert = /etc/ssl/certs/mssql.pem
tlsciphers = ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-SHA:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-SHA256:AES128-SHA256:AES256-SHA:AES128-SHA
tlskey = /etc/ssl/private/mssql.key
tlsprotocols = 1.2,1.1,1.0

[sqlagent]
databasemailprofile = default
errorlogfile = /var/opt/mssql/log/sqlagentlog.log
errorlogginglevel = 7

[telemetry]
customerfeedback = true
userrequestedlocalauditdirectory = /tmp/audit

[traceflag]
traceflag0 = 1204
traceflag1 = 2345
traceflag = 3456
[EULA]
accepteula = Y
accepteulaml = Y

[coredump]
captureminiandfull = true
coredumptype = full

[distributedtransaction]
servertcpport = 51999

[filelocation]
defaultbackupdir = /var/opt/mssql/data/
defaultdatadir = /var/opt/mssql/data/
defaultdumpdir = /var/opt/mssql/data/
defaultlogdir = /var/opt/mssql/data/

[hadr]
hadrenabled = 0

[language]
lcid = 1033

[memory]
memorylimitmb = 4096

[network]
forceencryption = 0
ipaddress = 10.192.0.0
kerberoskeytabfile = /var/opt/mssql/secrets/mssql.keytab
rpcport = 13500
tcpport = 1401
tlscert = /etc/ssl/certs/mssql.pem
tlsciphers = ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-SHA:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-SHA256:AES128-SHA256:AES256-SHA:AES128-SHA
tlskey = /etc/ssl/private/mssql.key
tlsprotocols = 1.2,1.1,1.0

[sqlagent]
databasemailprofile = default
errorlogfile = /var/opt/mssql/log/sqlagentlog.log
errorlogginglevel = 7

[telemetry]
customerfeedback = true
userrequestedlocalauditdirectory = /tmp/audit

[traceflag]
traceflag0 = 1204
traceflag1 = 2345
traceflag = 3456

Nächste SchritteNext steps

Wenn Sie einige dieser Konfigurationsänderungen mit Umgebungsvariablen vornehmen möchten, finden Sie unter Konfigurieren von SQL Server-Einstellungen mit Umgebungsvariablen weitere Informationen.To instead use environment variables to make some of these configuration changes, see Configure SQL Server settings with environment variables.

Weitere Verwaltungstools und Szenarios finden Sie unter Verwalten von SQL Server für Linux.For other management tools and scenarios, see Manage SQL Server on Linux.