Настройка SQL Server на Linux с помощью средства mssql-confConfigure SQL Server on Linux with the mssql-conf tool

• 08/12/2020
• Чтение занимает 18 мин
• • 
  • 
  • 

Применимо к:Applies to: SQL ServerSQL Server (все поддерживаемые версии) SQL ServerSQL Server (all supported versions)  — LinuxПрименимо к:Applies to: SQL ServerSQL Server (все поддерживаемые версии) SQL ServerSQL Server (all supported versions) - Linux

Советы по использованиюUsage tips

• В случае с группами доступности Always On и кластерами общих дисков во всех узлах необходимо вносить одинаковые изменения в конфигурацию.For Always On Availability Groups and shared disk clusters, always make the same configuration changes on each node.

• В случае с кластером общих дисков не пытайтесь перезапустить службу mssql-server, чтобы применить изменения.For the shared disk cluster scenario, do not attempt to restart the mssql-server service to apply changes. SQL Server работает как приложение.SQL Server is running as an application. Вместо этого переведите ресурс в режим "вне сети", а затем снова в режим "в сети".Instead, take the resource offline and then back online.

• В этих примерах средство mssql-conf запускается с указанием полного пути: /opt/mssql/bin/mssql-conf.These examples run mssql-conf by specifying the full path: /opt/mssql/bin/mssql-conf. Если вы уже перешли по этому пути, запускайте mssql-conf в контексте текущего каталога: ./mssql-conf.If you choose to navigate to that path instead, run mssql-conf in the context of the current directory: ./mssql-conf.

Включение агента SQL ServerEnable SQL Server Agent

Параметр sqlagent.enabled включает агент SQL Server.The sqlagent.enabled setting enables SQL Server Agent. По умолчанию агент SQL Server отключен.By default, SQL Server Agent is disabled. Если параметр sqlagent.enabled отсутствует в файле параметров mssql.conf, предполагается, что агент SQL Server отключен.If sqlagent.enabled is not present in the mssql.conf settings file, then SQL Server internally assumes that SQL Server Agent is disabled.

Чтобы изменить этот параметр, выполните указанные ниже действия.To change this setting, use the following steps:

1. Включите агент SQL Server:Enable the SQL Server Agent:

   sudo /opt/mssql/bin/mssql-conf set sqlagent.enabled true 
   

2. Перезапустите службу SQL Server:Restart the SQL Server service:

   sudo systemctl restart mssql-server
   

Настройка профиля Database Mail по умолчанию для SQL Server на LinuxSet the default database mail profile for SQL Server on Linux

Параметр sqlpagent.databasemailprofile позволяет задать профиль DB Mail по умолчанию для оповещений по электронной почте.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>

Журналы ошибок Агента SQLSQL Agent error logs

Параметры sqlpagent.errorlog file и sqlpagent.errorlogginglevel позволяют задать путь к файлу журнала Агента SQL и соответственно уровень ведения журнала.The sqlpagent.errorlogfile and sqlpagent.errorlogginglevel settings allows you to set the SQL Agent log file path and logging level respectively.

sudo /opt/mssql/bin/mssql-conf set sqlagent.errorfile <path>

Уровни ведения журнала Агента SQL — это значения битовой маски, которые равны:SQL Agent logging levels are bitmask values that equal:

• 1 = ошибки;1 = Errors
• 2 = предупреждения;2 = Warnings
• 4 = сведения.4 = Info

Если вы хотите захватить все уровни, используйте в качестве значения 7.If you want to capture all levels, use 7 as the value.

sudo /opt/mssql/bin/mssql-conf set sqlagent.errorlogginglevel <level>

Изменение параметров сортировки SQL ServerChange the SQL Server collation

Параметр set-collation позволяет выбрать любые из поддерживаемых параметров сортировки.The set-collation option changes the collation value to any of the supported collations.

1. Сначала выполните резервное копирование всех пользовательских баз данных на сервере.First backup any user databases on your server.

2. Затем используйте хранимую процедуру sp_detach_db для отключения пользовательских баз данных.Then use the sp_detach_db stored procedure to detach the user databases.

3. Запустите программу с параметром set-collation и следуйте указаниям:Run the set-collation option and follow the prompts:

   sudo /opt/mssql/bin/mssql-conf set-collation
   

4. Программа mssql-conf попытается изменить параметры сортировки на указанные и перезапустить службу.The mssql-conf utility will attempt to change to the specified collation value and restart the service. Если возникнут ошибки, будет произведен откат к прежним параметрам сортировки.If there are any errors, it rolls back the collation to the previous value.

5. Восстановите пользовательские базы данных из резервных копий.Restore your user database backups.

Чтобы получить список поддерживаемых параметров сортировки, выполните функцию sys.fn_helpcollations: SELECT Name from sys.fn_helpcollations().For a list of supported collations, run the sys.fn_helpcollations function: SELECT Name from sys.fn_helpcollations().

Настройка отзывов пользователейConfigure customer feedback

Параметр telemetry.customerfeedback определяет, отправляются ли отзывы из SQL Server в корпорацию Майкрософт.The telemetry.customerfeedback setting changes whether SQL Server sends feedback to Microsoft or not. По умолчанию он имеет значение true для всех выпусков.By default, this value is set to true for all editions. Чтобы изменить значение, выполните следующие команды:To change the value, run the following commands:

1. Запустите скрипт mssql-conf от имени привилегированного пользователя с помощью команды set для telemetry.customerfeedback.Run the mssql-conf script as root with the set command for telemetry.customerfeedback. В приведенном ниже примере отправка отзывов отключается путем указания значения false.The following example turns off customer feedback by specifying false.

   sudo /opt/mssql/bin/mssql-conf set telemetry.customerfeedback false
   

2. Перезапустите службу SQL Server:Restart the SQL Server service:

   sudo systemctl restart mssql-server
   

Дополнительные сведения см. в статье Отзывы пользователей об SQL Server на Linux и в Заявлении о конфиденциальности SQL Server.For more information, see Customer Feedback for SQL Server on Linux and the SQL Server Privacy Statement.

Изменение каталога по умолчанию для данных или журналовChange the default data or log directory location

Параметры filelocation.defaultdatadir и filelocation.defaultlogdir позволяют изменить расположение, в котором создаются файлы баз данных и журналов.The filelocation.defaultdatadir and filelocation.defaultlogdir settings change the location where the new database and log files are created. Расположение по умолчанию — /var/opt/mssql/data.By default, this location is /var/opt/mssql/data. Чтобы изменить эти параметры, выполните указанные ниже действия.To change these settings, use the following steps:

1. Создайте целевой каталог для новых файлов данных и журналов базы данных.Create the target directory for new database data and log files. В следующем примере создается каталог /tmp/data:The following example creates a new /tmp/data directory:

   sudo mkdir /tmp/data
   

2. Задайте пользователя mssql в качестве владельца и группы каталога:Change the owner and group of the directory to the mssql user:

   sudo chown mssql /tmp/data
   sudo chgrp mssql /tmp/data
   

3. Используйте программу mssql-conf для изменения каталога данных по умолчанию с помощью команды set: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. Перезапустите службу SQL Server:Restart the SQL Server service:

   sudo systemctl restart mssql-server
   

5. Теперь все файлы баз данных для создаваемых баз данных будут сохраняться в этом новом расположении.Now all the database files for the new databases created will be stored in this new location. Чтобы изменить расположение файлов журналов (LDF) для новых баз данных, можно выполнить следующую команду set: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. Эта команда также предполагает, что существует каталог /tmp/log и что он принадлежит пользователю и группе mssql.This command also assumes that a /tmp/log directory exists, and that it is under the user and group mssql.

Изменение каталога по умолчанию для файлов базы данных masterChange the default master database file directory location

Параметры filelocation.masterdatafile и filelocation.masterlogfile позволяют изменить расположение, в котором ядро СУБД SQL Server ищет файлы базы данных master.The filelocation.masterdatafile and filelocation.masterlogfile setting changes the location where the SQL Server engine looks for the master database files. Расположение по умолчанию — /var/opt/mssql/data.By default, this location is /var/opt/mssql/data.

Чтобы изменить эти параметры, выполните указанные ниже действия.To change these settings, use the following steps:

1. Создайте целевой каталог для новых файлов с журналами ошибок.Create the target directory for new error log files. В следующем примере создается каталог /tmp/masterdatabasedir:The following example creates a new /tmp/masterdatabasedir directory:

   sudo mkdir /tmp/masterdatabasedir
   

2. Задайте пользователя mssql в качестве владельца и группы каталога:Change the owner and group of the directory to the mssql user:

   sudo chown mssql /tmp/masterdatabasedir
   sudo chgrp mssql /tmp/masterdatabasedir
   

3. Используйте программу mssql-conf, чтобы изменить каталог для файлов основных данных и журналов базы данных master с помощью команды set: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
   

   Примечание

   Помимо перемещения файлов основных данных и журналов, при этом также изменяется расположение для всех остальных системных баз данных.In addition to moving the master data and log files, this also moves the default location for all other system databases.

4. Остановите службу SQL Server:Stop the SQL Server service:

   sudo systemctl stop mssql-server
   

5. Переместите файлы master.mdf и 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. Запустите службу SQL Server:Start the SQL Server service:

   sudo systemctl start mssql-server
   

   Примечание

   Если серверу SQL Server не удается найти файлы master.mdf и mastlog.ldf в указанном каталоге, в нем автоматически создается шаблонная копия системных баз данных и SQL Server успешно запускается.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. Однако метаданные, такие как пользовательские базы данных, имена входа на сервер, сертификаты сервера, ключи шифрования, задания агента SQL или старый пароль для имени входа SA, не обновляются в новой базе данных master.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. Чтобы продолжить использовать существующие метаданные, потребуется остановить SQL Server, переместить старые файлы master.mdf и mastlog.ldf в новое расположение, а затем снова запустить SQL Server.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.

Изменение имени для файлов базы данных masterChange the name of master database files

Параметры filelocation.masterdatafile и filelocation.masterlogfile позволяют изменить расположение, в котором ядро СУБД SQL Server ищет файлы базы данных master.The filelocation.masterdatafile and filelocation.masterlogfile setting changes the location where the SQL Server engine looks for the master database files. С их помощью можно также изменить имена файлов базы данных master и ее журналов.You can also use this to change the name of the master database and log files.

Чтобы изменить эти параметры, выполните указанные ниже действия.To change these settings, use the following steps:

1. Остановите службу SQL Server:Stop the SQL Server service:

   sudo systemctl stop mssql-server
   

2. Используйте программу mssql-conf, чтобы изменить требуемые имена файлов основных данных и журналов для базы данных master с помощью команды set: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
   

   Важно!

   Имена файлов базы данных master и ее журналов можно изменить только после успешного запуска SQL Server.You can only change the name of the master database and log files after SQL Server has started successfully. При первом запуске SQL Server эти файлы должны называться master.mdf и mastlog.ldf.Before the initial run, SQL Server expects the files to be named master.mdf and mastlog.ldf.

3. Изменение имен файлов данных и журналов для базы данных masterChange 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. Запустите службу SQL Server:Start the SQL Server service:

   sudo systemctl start mssql-server
   

Изменение каталога дампа по умолчаниюChange the default dump directory location

Параметр filelocation.defaultdumpdir позволяет изменить расположение по умолчанию, в котором создаются дампы памяти и SQL в случае аварийного завершения работы.The filelocation.defaultdumpdir setting changes the default location where the memory and SQL dumps are generated whenever there is a crash. По умолчанию эти файлы создаются в каталоге /var/opt/mssql/log.By default, these files are generated in /var/opt/mssql/log.

Чтобы задать новое расположение, используйте приведенные ниже команды.To set up this new location, use the following commands:

1. Создайте целевой каталог для новых файлов дампа.Create the target directory for new dump files. В следующем примере создается каталог /tmp/dump:The following example creates a new /tmp/dump directory:

   sudo mkdir /tmp/dump
   

2. Задайте пользователя mssql в качестве владельца и группы каталога:Change the owner and group of the directory to the mssql user:

   sudo chown mssql /tmp/dump
   sudo chgrp mssql /tmp/dump
   

3. Используйте программу mssql-conf для изменения каталога данных по умолчанию с помощью команды set: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. Перезапустите службу SQL Server:Restart the SQL Server service:

   sudo systemctl restart mssql-server
   

Изменение каталога по умолчанию для файла журнала ошибокChange the default error log file directory location

Параметр filelocation.errorlogfile позволяет изменить расположение, в котором создаются файлы журнала ошибок, трассировки профилировщика по умолчанию, сеанса XE работоспособности системы и сеанса XE Hekaton.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. Расположение по умолчанию — /var/opt/mssql/log.By default, this location is /var/opt/mssql/log. Каталог, в котором создается файл журнала ошибок SQL, становится каталогом по умолчанию и для остальных журналов.The directory in which SQL errorlog file is set becomes the default log directory for other logs.

Чтобы изменить этот параметр, выполните указанные ниже действия.To change these settings:

1. Создайте целевой каталог для новых файлов с журналами ошибок.Create the target directory for new error log files. В следующем примере создается каталог /tmp/logs:The following example creates a new /tmp/logs directory:

   sudo mkdir /tmp/logs
   

2. Задайте пользователя mssql в качестве владельца и группы каталога:Change the owner and group of the directory to the mssql user:

   sudo chown mssql /tmp/logs
   sudo chgrp mssql /tmp/logs
   

3. Используйте программу mssql-conf, чтобы изменить имя файла журнала ошибок по умолчанию с помощью команды set: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. Перезапустите службу SQL Server:Restart the SQL Server service:

   sudo systemctl restart mssql-server
   

Параметр errorlog.numerrorlogs позволяет указать число журналов ошибок, которые будут сохраняться перед запуском журнала в цикличном режиме.The errorlog.numerrorlogs setting will allow you to specify the number of error logs maintained before cycling the log.

Изменение каталога резервного копирования по умолчаниюChange the default backup directory location

Параметр filelocation.defaultdumpdir позволяет изменить расположение по умолчанию, в котором создаются файлы резервных копий.The filelocation.defaultbackupdir setting changes the default location where the backup files are generated. По умолчанию эти файлы создаются в каталоге /var/opt/mssql/data.By default, these files are generated in /var/opt/mssql/data.

Чтобы задать новое расположение, используйте приведенные ниже команды.To set up this new location, use the following commands:

1. Создайте целевой каталог для новых файлов резервных копий.Create the target directory for new backup files. В следующем примере создается каталог /tmp/backup:The following example creates a new /tmp/backup directory:

   sudo mkdir /tmp/backup
   

2. Задайте пользователя mssql в качестве владельца и группы каталога:Change the owner and group of the directory to the mssql user:

   sudo chown mssql /tmp/backup
   sudo chgrp mssql /tmp/backup
   

3. Используйте программу mssql-conf для изменения каталога резервного копирования по умолчанию с помощью команды set: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. Перезапустите службу SQL Server:Restart the SQL Server service:

   sudo systemctl restart mssql-server
   

Указание параметров дампа ядраSpecify core dump settings

Если в одном из процессов SQL Server возникает исключение, SQL Server создает дамп памяти.If an exception occurs in one of the SQL Server processes, SQL Server creates a memory dump.

Есть два параметра для управления типом дампов памяти, собираемых сервером SQL Server: coredump.coredumptype и coredump.captureminiandfull.There are two options for controlling the type of memory dumps that SQL Server collects: coredump.coredumptype and coredump.captureminiandfull. Каждый из них связан с одним из двух этапов записи дампа ядра.These relate to the two phases of core dump capture.

Первый этап записи управляется параметром coredump.coredumptype, который определяет тип файла дампа, создаваемого в случае исключения.The first phase capture is controlled by the coredump.coredumptype setting, which determines the type of dump file generated during an exception. Второй этап активируется параметром coredump.captureminiandfull.The second phase is enabled when the coredump.captureminiandfull setting. Если параметр coredump.captureminiandfull имеет значение true, создается файл дампа, определяемый параметром coredump.coredumptype, а также еще один файл — файл мини-дампа.If coredump.captureminiandfull is set to true, the dump file specified by coredump.coredumptype is generated and a second mini dump is also generated. Если присвоить параметру coredump.captureminiandfull значение false, второй этап регистрации выполняться не будет.Setting coredump.captureminiandfull to false disables the second capture attempt.

1. Укажите, следует ли записывать как полный дамп, так и мини-дамп, с помощью параметра coredump.captureminiandfull.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>
   

   Значение по умолчанию: falseDefault: false

2. Укажите тип файла дампа с помощью параметра coredump.coredumptype.Specify the type of dump file with the coredump.coredumptype setting.

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

   Значение по умолчанию: miniplusDefault: miniplus

   В таблице ниже перечислены возможные значения параметра coredump.coredumptype.The following table lists the possible coredump.coredumptype values.

   ТипType	ОписаниеDescription
   minimini	Mini — это тип файла дампа наименьшего размера.Mini is the smallest dump file type. Он предполагает использование системных сведений Linux для определения потоков и модулей процесса.It uses the Linux system information to determine threads and modules in the process. Дамп содержит только стеки и модули среды размещения.The dump contains only the host environment thread stacks and modules. Косвенные ссылки на память и глобальные переменные в него не включаются.It does not contain indirect memory references or globals.
   miniplusminiplus	Тип MiniPlus похож на mini, но в него включаются дополнительные области памяти.MiniPlus is similar to mini, but it includes additional memory. Он поддерживает внутренние процессы SQLPAL и среды размещения, благодаря чему в дамп добавляются следующие области памяти:It understands the internals of SQLPAL and the host environment, adding the following memory regions to the dump: — различные глобальные переменные;- Various globals — вся память выше 64 ТБ;- All memory above 64TB — все именованные области, имеющиеся в /proc/$pid/maps;- All named regions found in /proc/$pid/maps — косвенная память из потоков и стеков;- Indirect memory from threads and stacks — сведения о потоках;- Thread information — связанные структуры Teb и Peb;- Associated Teb's and Peb's — сведения о модулях;- Module Information — VMM и дерево VAD.- VMM and VAD tree
   filteredfiltered	Тип filtered основан на механизме исключения: в дамп включается вся память процесса, кроме явно исключенной.Filtered uses a subtraction-based design where all memory in the process is included unless specifically excluded. Он поддерживает внутренние процессы SQLPAL и среды размещения, причем из дампа исключаются определенные области.The design understands the internals of SQLPAL and the host environment, excluding certain regions from the dump.
   fullfull	Full — это полный дамп процесса, который содержит все области, имеющиеся в /proc/$pid/maps.Full is a complete process dump that includes all regions located in /proc/$pid/maps. Параметр coredump.captureminiandfull в этом случае не действует.This is not controlled by coredump.captureminiandfull setting.

Высокий уровень доступностиHigh Availability

Параметр hadr.hadrenabled включает группы доступности в экземпляре SQL Server.The hadr.hadrenabled option enables availability groups on your SQL Server instance. Приведенная ниже команда включает группы доступности путем присвоения параметру hadr.hadrenabled значения 1.The following command enables availability groups by setting hadr.hadrenabled to 1. Чтобы этот параметр вступил в силу, необходимо перезапустить SQL Server.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

Сведения об использовании этого параметра с группами доступности см. в следующих двух статьях:For information on how this is used with availability groups, see the following two topics.

• Настройка группы доступности Always On для SQL Server на LinuxConfigure Always On Availability Group for SQL Server on Linux
• Настройка группы доступности для чтения и масштабирования в SQL Server на LinuxConfigure read-scale availability group for SQL Server on Linux

Задание каталога локального аудитаSet local audit directory

Параметр telemetry.userrequestedlocalauditdirectory позволяет включить локальный аудит и указать каталог, в котором создаются журналы локального аудита.The telemetry.userrequestedlocalauditdirectory setting enables Local Audit and lets you set the directory where the Local Audit logs are created.

1. Создайте целевой каталог для новых журналов локального аудита.Create a target directory for new Local Audit logs. В следующем примере создается каталог /tmp/audit:The following example creates a new /tmp/audit directory:

   sudo mkdir /tmp/audit
   

2. Задайте пользователя mssql в качестве владельца и группы каталога:Change the owner and group of the directory to the mssql user:

   sudo chown mssql /tmp/audit
   sudo chgrp mssql /tmp/audit
   

3. Запустите скрипт mssql-conf от имени привилегированного пользователя с командой set для telemetry.userrequestedlocalauditdirectory.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. Перезапустите службу SQL Server:Restart the SQL Server service:

   sudo systemctl restart mssql-server
   

Дополнительные сведения см. в статье Отзывы пользователей об SQL Server на Linux.For more information, see Customer Feedback for SQL Server on Linux.

Изменение языкового стандарта SQL ServerChange the SQL Server locale

Параметр language.lcid позволяет изменить языковой стандарт SQL Server, выбрав любой поддерживаемый код языка.The language.lcid setting changes the SQL Server locale to any supported language identifier (LCID).

1. В следующем примере языковой стандарт изменяется на французский (1036):The following example changes the locale to French (1036):

   sudo /opt/mssql/bin/mssql-conf set language.lcid 1036
   

2. Перезапустите службу SQL Server, чтобы применить изменения:Restart the SQL Server service to apply the changes:

   sudo systemctl restart mssql-server
   

Задание предела памятиSet the memory limit

Параметр memory.memorylimitmb позволяет определять объем физической памяти (в МБ), доступный серверу SQL Server.The memory.memorylimitmb setting controls the amount physical memory (in MB) available to SQL Server. Значение по умолчанию — 80 % физической памяти.The default is 80% of the physical memory.

1. Запустите скрипт mssql-conf от имени привилегированного пользователя с командой set для memory.memorylimitmb.Run the mssql-conf script as root with the set command for memory.memorylimitmb. В приведенном ниже примере объем памяти, доступный серверу SQL Server, изменяется на 3,25 ГБ (3328 МБ).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. Перезапустите службу SQL Server, чтобы применить изменения:Restart the SQL Server service to apply the changes:

   sudo systemctl restart mssql-server
   

Дополнительные параметры памятиAdditional memory settings

В параметрах памяти доступны следующие пункты.The following options are available to the memory settings.

Настройка координатора распределенных транзакций МайкрософтConfigure MSDTC

Параметры network.rpcport и distributedtransaction.servertcpport позволяют настраивать координатор распределенных транзакций Майкрософт.The network.rpcport and distributedtransaction.servertcpport settings are used to configure the Microsoft Distributed Transaction Coordinator (MSDTC). Чтобы изменить эти параметры, выполните приведенные ниже команды.To change these settings, run the following commands:

1. Запустите скрипт mssql-conf от имени привилегированного пользователя с командой set для network.rpcport.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. Затем задайте параметр distributedtransaction.servertcpport:Then set the "distributedtransaction.servertcpport" setting:

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

Помимо задания этих значений, необходимо также настроить маршрутизацию и обновить настройки брандмауэра для порта 135.In addition to setting these values, you must also configure routing and update the firewall for port 135. Дополнительные сведения о том, как это сделать, см. в статье Настройка MSDTC на платформе Linux.For more information on how to do this, see How to configure MSDTC on Linux.

Есть еще ряд параметров mssql-conf, с помощью которых можно отслеживать работу координатора распределенных транзакций Майкрософт и устранять его неполадки.There are several other settings for mssql-conf that you can use to monitor and troubleshoot MSDTC. Они вкратце описываются в приведенной ниже таблице.The following table briefly describes these settings. Дополнительные сведения об их использовании см. в статье службы поддержки Windows Включение диагностической трассировки для координатора распределенных транзакций Майкрософт.For more information on their use, see the details in the Windows support article, How to enable diagnostic tracing for MS DTC.

# 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

[EULA]
accepteula = Y
accepteulaml = Y

# 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

[extensibility]
outboundnetworkaccess = 1

Изменение TCP-портаChange the TCP port

Параметр network.tcpport позволяет изменить TCP-порт, через который SQL Server ожидает передачи данных.The network.tcpport setting changes the TCP port where SQL Server listens for connections. По умолчанию используется порт 1433.By default, this port is set to 1433. Чтобы изменить порт, выполните приведенные ниже команды.To change the port, run the following commands:

1. Запустите скрипт mssql-conf от имени привилегированного пользователя с командой set для network.tcpport.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. Перезапустите службу SQL Server:Restart the SQL Server service:

   sudo systemctl restart mssql-server
   

3. Теперь при подключении к SQL Server нужно указывать пользовательский порт с запятой (,) после имени узла или IP-адреса.When connecting to SQL Server now, you must specify the custom port with a comma (,) after the hostname or IP address. Например, для подключения sqlcmd будет использоваться следующая команда:For example, to connect with SQLCMD, you would use the following command:

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

Указание параметров TLSSpecify TLS settings

Ниже приведены параметры, которые служат для настройки протокола TLS для экземпляра SQL Server, работающего на платформе Linux.The following options configure TLS for an instance of SQL Server running on Linux.

Пример использования параметров TLS см. в статье Шифрование подключений к SQL Server на Linux.For an example of using the TLS settings, see Encrypting Connections to SQL Server on Linux.

Параметры сетиNetwork settings

См. Учебник. Использование проверки подлинности Active Directory с SQL Server на Linux для получения дополнительных сведений.See Tutorial: Use Active Directory authentication with SQL Server on Linux for comprehensive information on using AD authentication with SQL Server on Linux.

Следующие пункты относятся к дополнительным параметрам сети, которые можно настроить с помощью mssql-conf.The following options are additional network settings configurable using mssql-conf.

Включение и отключение флагов трассировкиEnable/Disable traceflags

Параметр traceflag позволяет включить или отключить флаги трассировки при запуске службы SQL Server.This traceflag option enables or disables traceflags for the startup of the SQL Server service. Чтобы включить или отключить флаг трассировки, выполните приведенные ниже команды.To enable/disable a traceflag, use the following commands:

1. Для включения флага трассировки используйте приведенную ниже команду.Enable a traceflag using the following command. Например, для флага трассировки 1234:For example, for Traceflag 1234:

   sudo /opt/mssql/bin/mssql-conf traceflag 1234 on
   

2. Вы можете включить несколько флагов трассировки, указав их через пробел:You can enable multiple traceflags by specifying them separately:

   sudo /opt/mssql/bin/mssql-conf traceflag 2345 3456 on
   

3. Точно так же можно отключить один или несколько включенных флагов трассировки, указав их и добавив параметр off: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. Перезапустите службу SQL Server, чтобы применить изменения:Restart the SQL Server service to apply the changes:

   sudo systemctl restart mssql-server
   

Удаление параметраRemove a setting

Чтобы удалить любой параметр, заданный с помощью mssql-conf set, вызовите программу mssql-conf с параметром unset и именем удаляемого параметра.To unset any setting made with mssql-conf set, call mssql-conf with the unset option and the name of the setting. В результате будет восстановлено значение параметра по умолчанию.This clears the setting, effectively returning it to its default value.

1. В следующем примере удаляется параметр network.tcpport:The following example clears the network.tcpport option.

   sudo /opt/mssql/bin/mssql-conf unset network.tcpport
   

2. Перезапустите службу SQL Server.Restart the SQL Server service.

   sudo systemctl restart mssql-server
   

Просмотр текущих параметровView current settings

Чтобы просмотреть все настроенные параметры, выполните следующую команду, которая выводит содержимое файла mssql.conf: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

Некоторые параметры, отсутствующие в этом файле, имеют значения по умолчанию.Any settings not shown in this file are using their default values. В следующем разделе приводится пример файла mssql.conf.The next section provides a sample mssql.conf file.

Формат файла mssql.confmssql.conf format

В приведенном ниже файле /var/opt/mssql/mssql.conf представлен пример каждого параметра.The following /var/opt/mssql/mssql.conf file provides an example for each setting. Вы можете использовать этот формат, чтобы вносить изменения в файл mssql.conf вручную по мере необходимости.You can use this format to manually make changes to the mssql.conf file as needed. Чтобы внесенные вручную изменения вступили в силу, необходимо перезапустить SQL Server.If you do manually change the file, you must restart SQL Server before the changes are applied. Для использования файла mssql.conf с Docker необходимо настроить в Docker сохранение данных.To use the mssql.conf file with Docker, you must have Docker persist your data. Сначала добавьте полный файл mssql.conf в каталог узла, а затем запустите контейнер.First add a complete mssql.conf file to your host directory and then run the container. Пример см. в статье Отзывы пользователей.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

Дальнейшие действияNext steps

Сведения о том, как вносить некоторые из описанных изменений в конфигурацию с помощью переменных среды, см. в статье Настройка параметров SQL Server с помощью переменных среды .To instead use environment variables to make some of these configuration changes, see Configure SQL Server settings with environment variables.

Описание других средств управления и сценариев см. в статье, посвященной управлению SQL Server на Linux.For other management tools and scenarios, see Manage SQL Server on Linux.