ALTER SERVER CONFIGURATION (Transact-SQL)

Изменяет глобальные параметры конфигурации текущего сервера в SQL Server.

Синтаксические обозначения в Transact-SQL

Синтаксис

ALTER SERVER CONFIGURATION
SET <optionspec> 
[;]

<optionspec> ::=
{
     <process_affinity>
   | <diagnostic_log>
   | <failover_cluster_property>
   | <hadr_cluster_context>
   | <buffer_pool_extension>
}

<process_affinity> ::= 
   PROCESS AFFINITY 
   {
     CPU = { AUTO | <CPU_range_spec> } 
   | NUMANODE = <NUMA_node_range_spec> 
   }
   <CPU_range_spec> ::= 
      { CPU_ID | CPU_ID  TO CPU_ID } [ ,...n ] 

   <NUMA_node_range_spec> ::= 
      { NUMA_node_ID | NUMA_node_ID TO NUMA_node_ID } [ ,...n ]

<diagnostic_log> ::= 
   DIAGNOSTICS LOG 
   { 
     ON  
   | OFF  
   | PATH = { 'os_file_path' | DEFAULT }  
   | MAX_SIZE = { 'log_max_size' MB | DEFAULT }  
   | MAX_FILES = { 'max_file_count' | DEFAULT }  
   }

<failover_cluster_property> ::= 
   FAILOVER CLUSTER PROPERTY <resource_property>
   <resource_property> ::=
      {
        VerboseLogging = { 'logging_detail' | DEFAULT }  
      | SqlDumperDumpFlags = { 'dump_file_type' | DEFAULT }
      | SqlDumperDumpPath = { 'os_file_path'| DEFAULT }
      | SqlDumperDumpTimeOut = { 'dump_time-out' | DEFAULT }
      | FailureConditionLevel = { 'failure_condition_level' | DEFAULT }
      | HealthCheckTimeout = { 'health_check_time-out' | DEFAULT }
      }

<hadr_cluster_context> ::=
   HADR CLUSTER CONTEXT = { 'remote_windows_cluster' | LOCAL }

<buffer_pool_extension>::=
    BUFFER POOL EXTENSION 
    { ON ( FILENAME = 'os_file_path_and_name' , SIZE = <size_spec> ) 
    | OFF }

    <size_spec> ::=
        { size [ KB | MB | GB ] }

Аргументы

<process_affinity> ::=

• PROCESS AFFINITY
  Включает связывание потоков оборудования с процессорами.

• CPU = { AUTO | <CPU_range_spec> }
  Распределяет рабочие потоки SQL Server на каждый ЦП в заданном диапазоне. Для процессоров вне заданного диапазона не назначены потоки.

  • AUTO
    Указывает, что для потока не назначен ЦП. Разрешено свободное перемещение потоков операционной системой между процессорами в зависимости от рабочей нагрузки сервера. Это значение по умолчанию, которое рекомендуется использовать.

  • <CPU_range_spec> ::=
    Указывает ЦП или диапазон процессоров, которым будут назначаться потоки.

  • { CPU_ID | CPU_ID TO CPU_ID } [ ,...n ]
    Список из одного или нескольких процессоров. Идентификаторы ЦП начинаются с 0 и имеют тип integer.

• NUMANODE = <NUMA_node_range_spec>
  Назначает потоки всем процессорам, принадлежащим заданному узлу NUMA или диапазону узлов.

  • <NUMA_node_range_spec> ::=
    Указывает номер узла NUMA или диапазон узлов NUMA.

  • { NUMA_node_ID | NUMA_node_ID TO NUMA_node_ID } [ ,...n ]
    Это список из одного или нескольких узлов NUMA. Идентификаторы узлов NUMA начинаются с 0 и имеют тип integer.

<diagnostic_log> ::=

• DIAGNOSTICS LOG
  Запускает или останавливает запись в журнал диагностических данных, полученных с помощью хранимой процедуры sp_server_diagnostics, а также задает такие параметры конфигурации журналов SQLDIAG, как количество переключений файлов журнала, размер файлов журнала и расположение файлов. Дополнительные сведения см. в разделе Просмотр и чтение журнала диагностики экземпляра отказоустойчивого кластера.

• ON
  Запускает запись диагностических данных SQL Server в расположении, указанном в параметре файла PATH. Этот режим установлен по умолчанию.

• OFF
  Прекращает запись в журнал диагностических данных.

• PATH = { 'os_file_path' | DEFAULT }
  Путь, определяющий расположение журналов диагностики. Расположение по умолчанию — <\MSSQL\Log> в папке установки экземпляра отказоустойчивого кластера SQL Server.

• MAX_SIZE = { 'log_max_size' MB | DEFAULT }
  Максимальный размер каждого из журналов диагностики в мегабайтах. Значение по умолчанию равно 100 МБ.

• MAX_FILES = { 'max_file_count' | DEFAULT }
  Максимальное число файлов журналов диагностики, которое может храниться на компьютере, прежде чем существующие файлы будут очищены и использованы для новых журналов диагностики.

<failover_cluster_property> ::=

• FAILOVER CLUSTER PROPERTY
  Изменяет свойства закрытого ресурса отказоустойчивого кластера SQL Server.

• VERBOSE LOGGING = { 'logging_detail' | DEFAULT }
  Задает уровень ведения журнала для отказоустойчивого кластера SQL Server. Параметр можно включить для записи дополнительных сведений в журналы ошибок в целях устранения неполадок.

  • 0 — ведение журнала отключено (по умолчанию)

  • 1 — только ошибки

  • 2 — ошибки и предупреждения

• SQLDUMPEREDUMPFLAGS
  Определяет тип файлов дампа, создаваемых служебной программой SQLDumper в SQL Server. Значение по умолчанию — 0. Для получения дополнительных сведений см. статью базы знаний о служебной программе Dumper сервера SQL Server.

• SQLDUMPERDUMPPATH = { 'os_file_path' | DEFAULT }
  Место, где служебная программа SQLDumper сохраняет файлы дампов. Для получения дополнительных сведений см. статью базы знаний о служебной программе Dumper сервера SQL Server.

• SQLDUMPERDUMPTIMEOUT = { 'dump_time-out' | DEFAULT }
  Максимальное время создания дампа программой SQLDumper в случае сбоя SQL Server (в миллисекундах). Значение по умолчанию равно 0, то есть время создания дампа неограниченно. Для получения дополнительных сведений см. статью базы знаний о служебной программе Dumper сервера SQL Server.

• FAILURECONDITIONLEVEL = { 'failure_condition_level' | DEFAULT }
  Условия, при которых должно произойти переключение при сбое или перезапуск экземпляра отказоустойчивого кластера SQL Server. Значение по умолчанию, равное 3, означает, что ресурс SQL Server будет переключаться на резервный ресурс или перезапускаться в случае критической ошибки сервера. Дополнительные сведения об этом и других уровнях условий ошибки см. в разделе Настройка параметров свойства FailureConditionLevel.

• HEALTHCHECKTIMEOUT = { 'health_check_time-out' | DEFAULT }
  Время, в течение которого библиотека ресурсов компонента SQL Server Database Engine будет ждать сведений о состоянии сервера, прежде чем сервер переводится в категорию неотвечающих. Время ожидания указывается в миллисекундах. Значение по умолчанию равно 60 000 миллисекунд (60 секунд).

<hadr_cluster_context> ::=

• КОНТЕКСТ КЛАСТЕРА HADR = { 'remote_windows_cluster' | LOCAL}
  Переключает контекст кластера HADR экземпляра сервера (WSFC) на указанный кластер WSFC. Контекст кластера HADR определяет кластер Windows Server Failover Clustering (WSFC), который управляет метаданными для реплик доступности, размещенных в экземпляре сервера. Используйте параметр SET HADR CLUSTER CONTEXT только во время миграции с кластера Группы доступности AlwaysOn на экземпляр SQL Server 2012 SP1 или более новой версии в новом кластере WSFC.

  Переключать контекст кластера HADR можно только с локального кластера WSFC на удаленный и обратно с удаленного кластера на локальный. Контекст кластера HADR можно переключить на удаленный кластер, только если на экземпляре SQL Server не размещено ни одной реплики доступности.

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

  Для определения целевого кластера укажите одно из следующих значений:

  • windows_cluster
    Объект имени WSFC-кластера (CNO). Вы можете указать короткое имя или полное имя домена. Для поиска целевого IP-адреса короткого имени ALTER SERVER CONFIGURATION использует разрешение DNS. В некоторых ситуациях краткое имя может вызвать затруднения, и DNS может вернуть неправильный IP-адрес. Таким образом, рекомендуется указывать полное имя домена.

  • LOCAL
    Локальный кластер WSFC.

  Дополнительные сведения см. в разделе Смена контекста кластера HADR экземпляра сервера (SQL Server).

<buffer_pool_extension>::=

• ON
  Обеспечивает возможность расширения буферного пула. Этот параметр расширяет размер буферного пула с помощью энергонезависимого хранилища, например твердотельных накопителей (SSD), для сохранения чистых страниц данных в пуле. Дополнительные сведения об этой возможности см. в разделе Расширение буферного пула. Расширение буферного пула не поддерживается ни в одном из выпусков SQL Server. Дополнительные сведения см. в разделе Функции, поддерживаемые различными выпусками SQL Server 2014.

• FILENAME = 'os_file_path_and_name'
  Определяет путь к каталогу и имя файла кэша расширения буферного пула. Файл должен иметь расширение BPE. Необходимо отключить BUFFER POOL EXTENSION, чтобы изменить FILENAME.

• SIZE = size [ KB | MB | GB ]
  Определяет размер кэша. По умолчанию размер указывается в килобайтах (KB). Минимальный размер — значение параметра Max Server Memory. Максимальный размер в 32 раза больше значения параметра Max Server Memory. Дополнительные сведения о параметре Max Server Memory см. в разделе sp_configure (Transact-SQL).

  Необходимо отключить BUFFER POOL EXTENSION, чтобы изменить размер файла. Для указания размера меньше текущего нужно перезапустить экземпляр SQL Server для освобождения памяти. В противном случае заданный размер должен совпадать с текущим размером или превышать его.

• OFF
  Отключает параметр расширения буферного пула. Перед изменением любых связанных параметров, например размера или имени файла, необходимо отключить параметр расширения буферного пула. Если этот параметр отключен, все связанные данные конфигурации удаляются из реестра.

  Предупреждение

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

Общие замечания

Эта инструкция не требует перезапуска SQL Server. Для экземпляра отказоустойчивого кластера SQL Server перезапуск ресурса кластера SQL Server не требуется.

Ограничения

Эта инструкция не поддерживает триггеры DDL.

Разрешения

Необходимы разрешения ALTER SETTINGS для параметра PROCESS AFFINITY. Разрешения ALTER SETTINGS и VIEW SERVER STATE для параметров свойств журнала диагностики и отказоустойчивого кластера и разрешение CONTROL SERVER для параметра контекста кластера HADR.

Необходимо разрешение ALTER SERVER STATE для параметра расширения буферного пула.

Библиотека DLL ресурсов компонента SQL Server Компонент Database Engine запускается от имени учетной записи Local System. Таким образом, у учетной записи Local System должен быть доступ на чтение и запись к пути, указанному в параметре журнала диагностики.

Примеры

Установка соответствия процессов

В примерах этого раздела показано соответствие процессов центральным процессорам (ЦП) и узлам NUMA. Сервер в этих примерах состоит из 256 процессоров, организованных в четыре группы по 16 узлов NUMA в каждой. Потоки не назначаются какому-либо узлу NUMA или ЦП.

• Группа 0: узлы NUMA от 0 до 3, процессоры от 0 до 63

• Группа 1: узлы NUMA от 4 до 7, процессоры от 64 до 127

• Группа 2: узлы NUMA от 8 до 12, процессоры от 128 до 191

• Группа 3: узлы NUMA от 13 до 16, процессоры от 192 до 255

А.Задание привязки для всех процессоров в группах 0 и 2

В следующем примере задается соответствие для всех процессоров в группах 0 и 2.

ALTER SERVER CONFIGURATION 
SET PROCESS AFFINITY CPU=0 TO 63, 128 TO 191;

Б.Задание привязки для всех процессоров в узлах NUMA 0 и 7

В следующем примере задается привязка процессоров только к узлам 0 и 7.

ALTER SERVER CONFIGURATION 
SET PROCESS AFFINITY NUMANODE=0, 7;

В.Задание привязки к процессорам с номерами от 60 до 200

В следующем примере задается соответствие для процессоров от 60 до 200.

ALTER SERVER CONFIGURATION 
SET PROCESS AFFINITY CPU=60 TO 200;

Г.Задание привязки к процессору 0 в системе с двумя процессорами

В следующем примере демонстрируется задание соответствия для CPU=0 на компьютере с двумя процессорами. Перед выполнением следующей инструкции использовалась внутренняя битовая маска соответствия 00.

ALTER SERVER CONFIGURATION SET PROCESS AFFINITY CPU=0;

Д.Задание привязки AUTO

В этом примере параметр соответствия устанавливается на AUTO.

ALTER SERVER CONFIGURATION
SET PROCESS AFFINITY CPU=AUTO;

Настройка параметров журнала диагностики

В примерах этого раздела показана установка значений параметра журнала диагностики.

А.Запуск регистрации диагностических данных в журнале

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

ALTER SERVER CONFIGURATION SET DIAGNOSTICS LOG ON;

Б.Останов регистрации диагностических данных в журнале

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

ALTER SERVER CONFIGURATION SET DIAGNOSTICS LOG OFF;

В.Задание расположения журналов диагностических данных

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

ALTER SERVER CONFIGURATION
SET DIAGNOSTICS LOG PATH = 'C:\logs';

Г.Задание максимального размера каждого из журналов диагностики

В следующем примере задан максимальный размер каждого из журналов диагностики, равный 10 мегабайтам.

ALTER SERVER CONFIGURATION 
SET DIAGNOSTICS LOG MAX_SIZE = 10 MB;

Установка свойств отказоустойчивого кластера

В следующем примере показана установка свойств ресурса отказоустойчивого кластера SQL Server.

А.Указание значения свойства HealthCheckTimeout

В следующем примере устанавливается параметр HealthCheckTimeout, равный 15 000 миллисекунд (15 секунд).

ALTER SERVER CONFIGURATION 
SET FAILOVER CLUSTER PROPERTY HealthCheckTimeout = 15000;

Б.Изменение контекста кластера для реплики доступности

В следующем примере выполняется смена контекста кластера HADR экземпляра SQL Server. Для задания целевого кластера WSFC clus01 в примере указывается полное имя объекта кластера — clus01.xyz.com.

ALTER SERVER CONFIGURATION SET HADR CLUSTER CONTEXT = 'clus01.xyz.com';

Задание параметров расширения буферного пула

А.Установка параметра расширения буферного пула

В следующем примере выполняется включение параметра расширения буферного пула и задается имя и размер файла.

ALTER SERVER CONFIGURATION 
SET BUFFER POOL EXTENSION ON
    (FILENAME = 'F:\SSDCACHE\Example.BPE', SIZE = 50 GB);

Б.Изменение параметров расширения буферного пула

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

ALTER SERVER CONFIGURATION 
SET BUFFER POOL EXTENSION OFF;
GO
EXEC sp_configure 'max server memory (MB)', 12000;
GO
RECONFIGURE;
GO
ALTER SERVER CONFIGURATION
SET BUFFER POOL EXTENSION ON
    (FILENAME = 'F:\SSDCACHE\Example.BPE', SIZE = 60 GB);
GO

См. также

Задания

Настройка использования программной архитектуры NUMA (SQL Server) в SQL Server

Справочник

sys.dm_os_schedulers (Transact-SQL)

sys.dm_os_memory_nodes (Transact-SQL)

sys.dm_os_buffer_pool_extension_configuration (Transact-SQL)

Основные понятия

Смена контекста кластера HADR экземпляра сервера (SQL Server)

Расширение буферного пула