Настройка SQL Server на Linux с помощью средства mssql-con

Область применения: SQL Server — Linux

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

• В случае с группами доступности Always On и кластерами общих дисков во всех узлах необходимо вносить одинаковые изменения в конфигурацию.

• Для сценария кластера общего диска не пытайтесь перезапустить mssql-server службу, чтобы применить изменения. SQL Server работает как приложение. Вместо этого переведите ресурс в режим "вне сети", а затем снова в режим "в сети".

• В этих примерах запускается mssql-conf с указанием полного пути: /opt/mssql/bin/mssql-conf. Если вместо этого вы решите перейти по этому пути, запустите mssql-conf в контексте текущего каталога: ./mssql-conf.

• Если вы хотите изменить mssql.conf файл внутри контейнера, создайте mssql.conf файл на узле, где у вас есть контейнер с нужными параметрами, а затем повторно разверните контейнер. Например, следующее дополнение к файлу mssql.conf включает агент SQL Server.

  [sqlagent]
  enabled = true
  

  Контейнер можно развернуть с помощью следующих команд:

  docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<YourStrong@Passw0rd>" \
  -p 5433:1433 --name sql1 \
  -v /container/sql1:/var/opt/mssql \
  -d mcr.microsoft.com/mssql/server:2019-latest
  

  Дополнительные сведения см. в разделе "Создание файлов конфигурации для использования контейнером SQL Server".

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

Параметр sqlagent.enabled включает агент SQL Server. По умолчанию агент SQL Server отключен. Если sqlagent.enabled в файле параметров mssql.conf отсутствует, SQL Server внутренне предполагает, что агент SQL Server отключен.

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

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

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

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

   sudo systemctl restart mssql-server
   

Настройка профиля компонента Database Mail по умолчанию для SQL Server на Linux

Позволяет sqlagent.databasemailprofile задать профиль почты базы данных по умолчанию для оповещений электронной почты.

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

Журналы ошибок агента SQL

Параметры sqlagent.errorlogfile и sqlagent.errorlogginglevel параметры позволяют задать путь к файлу журнала агента SQL и уровень ведения журнала соответственно.

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

Уровни ведения журнала Агента SQL — это значения битовой маски, которые равны:

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

Если вы хотите захватить все уровни, используйте в качестве значения 7.

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

Настройка проверки подлинности Microsoft Entra

Начиная с SQL Server 2022 (16.x), можно настроить идентификатор Microsoft Entra для SQL Server. Чтобы настроить идентификатор Microsoft Entra, необходимо установить расширение Azure для SQL Server после установки SQL Server. Сведения о настройке идентификатора Microsoft Entra см. в руководстве по настройке проверки подлинности Microsoft Entra для SQL Server.

Изменение пути сертификата идентификатора Microsoft Entra id по умолчанию

По умолчанию файл сертификата Microsoft Entra хранится в /var/opt/mssql/aadsecrets/. Этот путь можно изменить, если используется хранилище сертификатов или зашифрованный диск. Чтобы изменить путь, можно использовать следующую команду:

sudo /opt/mssql/bin/mssql-conf set network.aadcertificatefilepath /path/to/new/location.pfx

В предыдущем примере /path/to/new/location.pfx — ваш предпочтительный путь, включая имя сертификата.

Сертификат для проверки подлинности Microsoft Entra, скачанный расширением Azure для SQL Server, хранится в этом расположении. Вы не можете изменить его на /var/opt/mssql/secrets.

Параметры конфигурации идентификатора Microsoft Entra

Следующие параметры используются проверкой подлинности Microsoft Entra для экземпляра SQL Server, работающего в Linux.

Настройка проверки подлинности Windows Active Directory

Этот setup-ad-keytab параметр можно использовать для создания ключа, но имена пользователей и субъектов-служб (SPN) должны быть созданы для использования этого параметра. Для создания пользователей, имен субъектов-служб и файлов keytab можно использовать служебную программу adutil Active Directory.

Для использования setup-ad-keytabпараметров выполните следующую команду:

sudo /opt/mssql/bin/mssql-conf setup-ad-keytab --help

Параметр validate-ad-config проверяет конфигурацию для проверки подлинности Active Directory.

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

Параметр set-collation изменяет значение сортировки на любой из поддерживаемых параметров сортировки. Чтобы внести это изменение, необходимо остановить службу SQL Server.

1. Сначала выполните резервное копирование всех пользовательских баз данных на сервере.

2. Затем используйте хранимую процедуру sp_detach_db для отключения пользовательских баз данных.

3. set-collation Запустите параметр и следуйте инструкциям:

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

4. Программа mssql-conf пытается изменить указанное значение сортировки и перезапустить службу. Если возникнут ошибки, будет произведен откат к прежним параметрам сортировки.

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

Чтобы получить список поддерживаемых параметров сортировки, выполните функцию sys.fn_helpcollations: SELECT Name from sys.fn_helpcollations().

Настройка отзывов клиентов

Параметр telemetry.customerfeedback изменяет, отправляет ли SQL Server отзыв корпорации Майкрософт или нет. По умолчанию это значение имеет true значение для всех выпусков. Чтобы изменить значение, выполните следующие команды:

1. Запустите скрипт mssql-conf в качестве корневого set каталога с помощью команды.telemetry.customerfeedback В следующем примере отключается отзыв клиентов, указывая false.

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

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

   sudo systemctl restart mssql-server
   

Дополнительные сведения см. в разделе "Настройка сбора данных об использовании и диагностике" для SQL Server на Linux и дополнения к конфиденциальности SQL Server.

Изменение расположения данных или каталога журнала по умолчанию

filelocation.defaultlogdir Параметры filelocation.defaultdatadir изменяют расположение, в котором создаются новые файлы базы данных и журналов. По умолчанию, это расположение /var/opt/mssql/data. Чтобы изменить эти параметры, выполните указанные ниже действия.

1. Создайте целевой каталог для новых файлов данных и журналов базы данных. В следующем примере создается новый /tmp/data каталог:

   sudo mkdir /tmp/data
   

2. Измените владельца и группу каталога mssql пользователю:

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

3. Используйте mssql-conf , чтобы изменить каталог данных по умолчанию с set помощью команды:

   sudo /opt/mssql/bin/mssql-conf set filelocation.defaultdatadir /tmp/data
   

4. Перезапустите службу SQL Server:

   sudo systemctl restart mssql-server
   

5. Теперь все файлы базы данных для новых баз данных хранятся в этом новом расположении. Если вы хотите изменить расположение файлов журнала (LDF) новых баз данных, можно использовать следующую set команду:

   sudo /opt/mssql/bin/mssql-conf set filelocation.defaultlogdir /tmp/log
   

6. Эта команда также предполагает, что каталог /tmp/log существует, и что он находится под пользователем и группой mssql.

Изменение расположения каталога файлов базы данных master по умолчанию

filelocation.masterlogfile И filelocation.masterdatafile параметр изменяет расположение, в котором sql Server ядро СУБД ищет master файлы базы данных. По умолчанию, это расположение /var/opt/mssql/data.

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

1. Создайте целевой каталог для новых файлов с журналами ошибок. В следующем примере создается новый /tmp/masterdatabasedir каталог:

   sudo mkdir /tmp/masterdatabasedir
   

2. Измените владельца и группу каталога mssql пользователю:

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

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

   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
   

   Примечание.

   Помимо перемещения файлов основных данных и журналов, при этом также изменяется расположение для всех остальных системных баз данных.

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

   sudo systemctl stop mssql-server
   

5. master.mdf Перемещение и mastlog.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:

   sudo systemctl start mssql-server
   

   Примечание.

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

Изменение имени для файлов базы данных master

filelocation.masterlogfile И filelocation.masterdatafile параметр изменяет расположение, в котором sql Server ядро СУБД ищет master файлы базы данных. С их помощью можно также изменить имена файлов базы данных master и ее журналов.

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

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

   sudo systemctl stop mssql-server
   

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

   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. Перед начальным запуском SQL Server ожидает, что файлы будут именованы master.mdf и mastlog.ldf.

3. Измените имя данных базы данных и файлов журналов master :

   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:

   sudo systemctl start mssql-server
   

Изменение расположения каталога дампа по умолчанию

Параметр filelocation.defaultdumpdir изменяет расположение по умолчанию, в котором создаются дампы памяти и SQL при сбое. По умолчанию эти файлы создаются в /var/opt/mssql/log.

Чтобы задать новое расположение, используйте приведенные ниже команды.

1. Создайте целевой каталог для новых файлов дампа. В следующем примере создается новый /tmp/dump каталог:

   sudo mkdir /tmp/dump
   

2. Измените владельца и группу каталога mssql пользователю:

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

3. Используйте mssql-conf , чтобы изменить каталог данных по умолчанию с set помощью команды:

   sudo /opt/mssql/bin/mssql-conf set filelocation.defaultdumpdir /tmp/dump
   

4. Перезапустите службу SQL Server:

   sudo systemctl restart mssql-server
   

Изменение расположения каталога файла журнала ошибок по умолчанию

Этот filelocation.errorlogfile параметр изменяет расположение, в котором создаются файлы XE нового журнала ошибок, трассировки профилировщика по умолчанию, сеанса работоспособности системы и XE сеанса Hekaton. По умолчанию, это расположение /var/opt/mssql/log. Каталог, в котором задан файл журнала ошибок SQL Server, становится каталогом журналов по умолчанию для других журналов.

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

1. Создайте целевой каталог для новых файлов с журналами ошибок. В следующем примере создается новый /tmp/logs каталог:

   sudo mkdir /tmp/logs
   

2. Измените владельца и группу каталога mssql пользователю:

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

3. Используйте mssql-conf , чтобы изменить имя файла журнала ошибок по умолчанию с помощью set команды:

   sudo /opt/mssql/bin/mssql-conf set filelocation.errorlogfile /tmp/logs/errorlog
   

4. Перезапустите службу SQL Server:

   sudo systemctl restart mssql-server
   

Этот errorlog.numerrorlogs параметр позволяет указать количество журналов ошибок, которые сохраняются перед циклом журнала.

Изменение расположения каталога резервного копирования по умолчанию

Параметр filelocation.defaultbackupdir изменяет расположение по умолчанию, в котором создаются файлы резервной копии. По умолчанию эти файлы создаются в /var/opt/mssql/data.

Чтобы задать новое расположение, используйте приведенные ниже команды.

1. Создайте целевой каталог для новых файлов резервных копий. В следующем примере создается новый /tmp/backup каталог:

   sudo mkdir /tmp/backup
   

2. Измените владельца и группу каталога mssql пользователю:

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

3. Используйте mssql-conf , чтобы изменить каталог резервного копирования по умолчанию с set помощью команды:

   sudo /opt/mssql/bin/mssql-conf set filelocation.defaultbackupdir /tmp/backup
   

4. Перезапустите службу SQL Server:

   sudo systemctl restart mssql-server
   

Указание параметров основного дампа

Если в одном из процессов SQL Server возникает исключение или сбой, SQL Server создает дамп памяти. Запись дампа памяти может занять много времени и занять значительное пространство. Чтобы сохранить ресурсы и избежать повторяющихся дампов памяти, можно отключить автоматическую coredump.disablecoredump запись дампа с помощью параметра.

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

Пользователи по-прежнему могут создавать дампы памяти вручную при отключении автоматического дампа ядра (coredump.disablecoredump задано значение true).

Существует два способа управления типом дампов памяти, собираемых SQL Server: coredump.coredumptype и coredump.captureminiandfull. Каждый из них связан с одним из двух этапов записи дампа ядра.

Первый этап отслеживания управляется coredump.coredumptype параметром, который определяет тип файла дампа, созданного во время исключения. Второй этап включен при настройке coredump.captureminiandfull . Если coredump.captureminiandfull задано значение true, создается файл дампа, указанный в coredump.coredumptype файле, а второй мини-дампа также создается. Значение coredump.captureminiandfull false отключает вторую попытку захвата.

1. Определите, следует ли записывать мини-и полные дампы с coredump.captureminiandfull помощью параметра.

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

   По умолчанию: false

2. Укажите тип файла дампа с параметром coredump.coredumptype .

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

   По умолчанию: miniplus

   В следующей таблице перечислены возможные coredump.coredumptype значения.

   Тип	Описание
   mini	Mini — это тип файла дампа наименьшего размера. Он предполагает использование системных сведений Linux для определения потоков и модулей процесса. Дамп содержит только стеки и модули среды размещения. Он не содержит косвенных ссылок на память или глобальных переменных.
   miniplus	Тип MiniPlus похож на mini, но в него включаются дополнительные области памяти. Он поддерживает внутренние процессы SQLPAL и среды размещения, благодаря чему в дамп добавляются следующие области памяти: — различные глобальные переменные; — все память выше 64 ТБ — Все именованные регионы, найденные в /proc/$pid/maps — косвенная память из потоков и стеков; — Сведения о потоках, включая связанные блоки среды потоков (TEBS) и блоки среды обработки (PEBS) — Сведения о модуле — VMM и дерево VAD.
   filtered	Тип filtered основан на механизме исключения: в дамп включается вся память процесса, кроме явно исключенной. Он поддерживает внутренние процессы SQLPAL и среды размещения, причем из дампа исключаются определенные области.
   full	Full — это полный дамп процесса, включающий все регионы, расположенные в /proc/$pid/maps. Это не контролируется параметром coredump.captureminiandfull .

Выпуск

Выпуск SQL Server можно изменить с помощью set-edition параметра. Чтобы изменить выпуск SQL Server, сначала необходимо остановить службу SQL Server. Дополнительные сведения о доступных выпусках SQL Server на Linux см. в выпусках SQL Server.

Высокая доступность

Этот hadr.hadrenabled параметр включает группы доступности в экземпляре SQL Server. Следующая команда включает группы доступности, установив hadr.hadrenabled значение 1. Чтобы этот параметр вступил в силу, необходимо перезапустить SQL Server.

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

Сведения об использовании этого параметра с группами доступности см. в следующих двух статьях.

• Настройка группы доступности AlwaysOn SQL Server для обеспечения высокой доступности в Linux
• Настройка группы доступности SQL Server для масштабирования на уровне чтения в Linux

Настройка локального каталога аудита

Этот telemetry.userrequestedlocalauditdirectory параметр включает локальный аудит и позволяет задать каталог, в котором создаются журналы локального аудита.

1. Создайте целевой каталог для новых журналов локального аудита. В следующем примере создается новый /tmp/audit каталог:

   sudo mkdir /tmp/audit
   

2. Измените владельца и группу каталога mssql пользователю:

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

3. Запустите скрипт mssql-conf в качестве корневого set файла с помощью команды:telemetry.userrequestedlocalauditdirectory

   sudo /opt/mssql/bin/mssql-conf set telemetry.userrequestedlocalauditdirectory /tmp/audit
   

4. Перезапустите службу SQL Server:

   sudo systemctl restart mssql-server
   

Дополнительные сведения см. в разделе "Настройка сбора данных об использовании и диагностике" для SQL Server на Linux.

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

Параметр language.lcid изменяет языковой стандарт SQL Server на любой поддерживаемый идентификатор языка (LCID).

1. В следующем примере языковой стандарт изменяется на французский (1036):

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

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

   sudo systemctl restart mssql-server
   

Установка ограничения памяти

Параметр memory.memorylimitmb управляет объемом физической памяти (в МБ), доступной для SQL Server. Значение по умолчанию составляет 80 % физической памяти, чтобы предотвратить отсутствие памяти (OOM).

1. Запустите скрипт mssql-conf в качестве корневого set каталога с помощью команды.memory.memorylimitmb В следующем примере память, доступная для SQL Server, изменяется на 3,25 ГБ (3328 МБ).

   sudo /opt/mssql/bin/mssql-conf set memory.memorylimitmb 3328
   

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

   sudo systemctl restart mssql-server
   

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

В параметрах памяти доступны следующие пункты.

Настройка MSDTC

Параметры network.rpcport используются distributedtransaction.servertcpport для настройки координатора распределенных транзакций (MSDTC). Чтобы изменить эти параметры, выполните приведенные ниже команды.

1. Запустите скрипт mssql-conf в качестве корневого set файла с помощью команды:network.rpcport

   sudo /opt/mssql/bin/mssql-conf set network.rpcport <rcp_port>
   

2. Затем задайте distributedtransaction.servertcpport параметр:

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

Помимо задания этих значений, необходимо также настроить маршрутизацию и обновить настройки брандмауэра для порта 135. Дополнительные сведения о том, как это сделать, см. в разделе "Настройка координатора распределенных транзакций Майкрософт" (MSDTC) в Linux.

Существует несколько других параметров для mssql-conf, которые можно использовать для мониторинга и устранения неполадок MSDTC. Они вкратце описываются в приведенной ниже таблице. Дополнительные сведения об их использовании см. в статье о поддержке Windows, чтобы включить трассировку диагностики для MS DTC на компьютере с Windows 10.

# 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

Изменение уровня ведения журнала для соединителя SQL Server для Azure Key Vault

В SQL Server 2022 (16.x) с накопительным пакетом обновления 14 и более поздних версий SQL Server на Linux поддерживает управление расширяемыми ключами TDE с помощью Azure Key Vault. Для уровня ведения журнала можно задать одно из следующих значений:

Чтобы изменить уровень ведения журнала для соединителя SQL Server, используйте следующий пример:

sudo /opt/mssql/bin/mssql-conf set sqlconnector.logginglevel 1

Дополнительные сведения см. в разделе "Использование соединителя SQL Server с функциями шифрования SQL".

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

Параметр network.tcpport изменяет TCP-порт, в котором SQL Server прослушивает подключения. По умолчанию используется порт 1433. Чтобы изменить порт, выполните приведенные ниже команды.

1. Запустите скрипт mssql-conf в качестве корневого set файла с помощью команды:network.tcpport

   sudo /opt/mssql/bin/mssql-conf set network.tcpport <new_tcp_port>
   

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

   sudo systemctl restart mssql-server
   

3. Теперь при подключении к SQL Server нужно указывать пользовательский порт с запятой (,) после имени узла или IP-адреса. Например, чтобы подключиться к sqlcmd, используйте следующую команду:

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

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

Ниже приведены параметры, которые служат для настройки протокола TLS для экземпляра SQL Server, работающего на платформе Linux.

Пример использования параметров TLS см. в разделе "Шифрование подключений к SQL Server на Linux".

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

См. руководство по использованию проверки подлинности Active Directory с SQL Server на Linux для получения исчерпывающей информации об использовании проверки подлинности Active Directory с SQL Server на Linux.

Ниже приведены дополнительные параметры сети, настраиваемые с помощью mssql-conf.

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

Параметр traceflag включает или отключает флаги трассировки для запуска службы SQL Server. Чтобы включить или отключить флаг трассировки, выполните приведенные ниже команды:

1. Для включения флага трассировки используйте приведенную ниже команду. Например, для флага трассировки 1234:

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

2. Вы можете включить несколько флагов трассировки, указав их отдельно:

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

3. Аналогичным образом можно отключить один или несколько флагов трассировки, указав их и добавив off параметр:

   sudo /opt/mssql/bin/mssql-conf traceflag 1234 2345 3456 off
   

4. Перезапустите службу SQL Server, чтобы применить изменения:

   sudo systemctl restart mssql-server
   

Удаление параметра

Чтобы удалить любой параметр, заданный с помощью mssql-conf set, вызовите программу mssql-conf с параметром unset и именем удаляемого параметра. В результате будет восстановлено значение параметра по умолчанию.

1. Следующий пример очищает network.tcpport параметр.

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

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

   sudo systemctl restart mssql-server
   

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

Чтобы просмотреть все настроенные параметры, выполните следующую команду, чтобы вывести содержимое mssql.conf файла:

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

Некоторые параметры, отсутствующие в этом файле, имеют значения по умолчанию. В следующем разделе представлен пример mssql.conf файла.

Просмотр различных параметров

Чтобы просмотреть различные параметры, которые можно настроить с помощью служебной программы mssql-conf, выполните командуhelp:

sudo /opt/mssql/bin/mssql-conf --help

Результаты предоставляют различные параметры конфигурации и краткое описание для каждого из параметров.

Формат mssql.conf

В приведенном ниже файле /var/opt/mssql/mssql.conf представлен пример каждого параметра. Этот формат можно использовать для ручного внесения изменений в mssql.conf файл по мере необходимости. Чтобы внесенные вручную изменения вступили в силу, необходимо перезапустить SQL Server. Чтобы использовать mssql.conf файл с Docker, необходимо сохранить данные Docker. Сначала добавьте полный mssql.conf файл в каталог узла, а затем запустите контейнер. Ниже приведен пример настройки сбора данных об использовании и диагностике для SQL Server на Linux.

[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

Связанный контент

• Настройка параметров SQL Server с переменными среды в Linux
• Выберите подходящее средство для управления SQL Server на Linux
• Настройка и настройка контейнеров SQL Server Linux

Примите участие в разработке документации по SQL

Знаете ли вы, что содержимое SQL можно изменить самостоятельно? Это не только улучшит нашу документацию, но и даст вам статус участника в создании этой страницы.

Дополнительные сведения см. в разделе Участие в работе над документацией по SQL Server.