sp_configure (Transact-SQL)

  • Статья

Область применения: SQL Server Управляемый экземпляр SQL Azure Not supported. Azure Synapse Analytics Analytics Platform System (PDW)

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

Примечание.

Параметры конфигурации уровня базы данных см. в разделе ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL). Сведения о настройке Soft-NUMA см. в статье Soft-NUMA (SQL Server).

Соглашения о синтаксисе Transact-SQL

Синтаксис

-- Syntax for SQL Server  
  
sp_configure [ [ @configname = ] 'option_name'   
    [ , [ @configvalue = ] 'value' ] ]  

-- Syntax for Parallel Data Warehouse  
  
-- List all of the configuration options  
sp_configure  
[;]  
  
-- Configure Hadoop connectivity  
sp_configure [ @configname= ] 'hadoop connectivity',  
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }  
[;]  
RECONFIGURE  
[;]

Аргументы

[ @configname = ] 'option_name' Имя параметра конфигурации. Аргументoption_name имеет тип varchar(35), значение по умолчанию — NULL. Ядро СУБД SQL Server распознает любую уникальную строку, которая является частью имени конфигурации. Если этот параметр отсутствует, возвращается список всех параметров.

Сведения о доступных параметрах конфигурации и их параметрах см. в разделе "Параметры конфигурации сервера" (SQL Server).

[ @configvalue = ] 'value' Является новым параметром конфигурации. Аргументvalue имеет тип intи значение по умолчанию NULL. Максимальное значение зависит от конкретного параметра.

Чтобы просмотреть максимальное значение каждого параметра, см . максимальный столбец представления каталога sys.configurations .

Значения кода возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

При выполнении без параметров sp_configure возвращает результирующий набор с пятью столбцами и упорядочивает параметры в алфавитном порядке по возрастанию, как показано в следующей таблице.

Значения config_value и run_value не эквивалентны автоматически. После обновления параметра конфигурации с помощью sp_configure системный администратор должен обновить выполняемое значение конфигурации с помощью RECONFIGURE или RECONFIGURE WITH OVERRIDE. Дополнительные сведения см. в разделе с примечаниями.

Имя столбца Тип данных Description
name nvarchar(35) Имя параметра конфигурации.
minimum int Минимальное значение параметра конфигурации.
maximum int Максимальное значение параметра конфигурации.
config_value int Значение, для которого был задан параметр конфигурации с помощью sp_configure (значение в sys.configurations.value). Дополнительные сведения об этих параметрах см. в разделе "Параметры конфигурации сервера" (SQL Server) и sys.configurations (Transact-SQL).
run_value int В настоящее время выполняется значение параметра конфигурации (значение в sys.configurations.value_in_use).

Дополнительные сведения см. в разделе sys.configurations (Transact-SQL).

Замечания

Используйте sp_configure для отображения или изменения параметров уровня сервера. Чтобы изменить параметры уровня базы данных, используйте ALTER DATABASE. Чтобы изменить параметры, влияющие только на текущий сеанс пользователя, используйте инструкцию SET .

Некоторые параметры конфигурации сервера доступны только с помощью ALTER SERVER CONFIGURATION (Transact-SQL).

Кластеры больших данных SQL Server

Для некоторых операций, в том числе настройки сервера (на уровне экземпляра) или добавления базы данных в группу доступности вручную, требуется подключение к экземпляру SQL Server. Для таких операций, как sp_configure, RESTORE DATABASE или любая команда DDL в базе данных, принадлежащей группе доступности, требуется соединение с экземпляром SQL Server. По умолчанию кластер больших данных не включает конечную точку, которая позволяет подключиться к этому экземпляру. Эту конечную точку необходимо предоставить вручную.

Инструкции см. в разделе Подключение к базам данных в первичной реплике.

Обновление активного значения конфигурации

При указании нового значения параметра результирующий набор отображает это значение в столбце config_value. Изначально это значение отличается от значения в столбце run_value , в котором отображается текущее значение конфигурации. Чтобы обновить запущенное значение конфигурации в столбце run_value , системный администратор должен запустить RECONFIGURE или RECONFIGURE WITH OVERRIDE.

Обе инструкции — и RECONFIGURE, и RECONFIGURE WITH OVERRIDE — работают с любым параметром конфигурации. Однако базовая инструкция RECONFIGURE отклоняет значение параметра, выходящее за разумный диапазон или способное вызвать конфликт параметров. Например, RECONFIGURE создает ошибку, если значение интервала восстановления больше 60 минут или если значение маски сходства перекрывается значением маски сходства. В противоположность этому, инструкция RECONFIGURE WITH OVERRIDE принимает любое значение параметра с правильным типом данных и инициирует повторную конфигурацию с заданным значением.

Внимание

Недопустимое значение параметра может отрицательно сказаться на конфигурации экземпляра сервера. Поэтому использовать инструкцию RECONFIGURE WITH OVERRIDE следует с осторожностью.

Инструкция RECONFIGURE выполняет динамическое обновление некоторых параметров; для обновления других параметров необходимо остановить и перезапустить сервер. Например, параметры минимальной памяти сервера и максимальной памяти сервера обновляются динамически в ядро СУБД, поэтому их можно изменить без перезапуска сервера. В отличие от этого, перенастройка выполняемого значения параметра коэффициента заполнения требует перезапуска ядро СУБД.

После запуска RECONFIGURE в параметре конфигурации можно увидеть, был ли параметр обновлен динамически, выполняя sp_configure'option_name". Значения в столбцах run_value и config_value должны совпадать с динамически обновленным параметром. Вы также можете проверка, чтобы узнать, какие параметры являются динамическими, просмотрев столбец is_dynamic представления каталога sys.configurations.

Изменение также записывается в журнал ошибок SQL Server.

Примечание.

Если указанное значение слишком велико для параметра, столбец run_value отражает тот факт, что ядро СУБД по умолчанию использует динамическую память, а не использовать недопустимый параметр.

Дополнительные сведения см. в разделе RECONFIGURE (Transact-SQL).

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

Некоторые параметры конфигурации, такие как маска сходства и интервал восстановления, назначаются в качестве дополнительных параметров. По умолчанию эти параметры недоступны для просмотра и изменения. Чтобы сделать их доступными, задайте для параметра "Показать дополнительные параметры " значение 1.

Внимание

Если параметр Show Advanced Options имеет значение 1, этот параметр применяется ко всем пользователям. Рекомендуется временно использовать это состояние и вернуться к 0 при выполнении задачи, необходимой для просмотра дополнительных параметров.

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

Разрешения

Разрешения на выполнение хранимой процедуры sp_configure без параметров или только с первым параметром по умолчанию предоставляются всем пользователям. Чтобы выполнить sp_configure с обоими параметрами, чтобы изменить параметр конфигурации или запустить инструкцию RECONFIGURE, необходимо предоставить разрешение ALTER SETTINGS на уровне сервера. Разрешение ALTER SETTINGS неявным образом предоставлено предопределенным ролям сервера sysadmin и serveradmin .

Примеры

А. Вывод списка дополнительных параметров конфигурации

В следующем примере демонстрируется, как установить и отобразить все параметры конфигурации. Дополнительные параметры конфигурации отображаются, если предварительно параметру show advanced options присвоить значение 1. После изменения этого параметра выполнение хранимой процедуры sp_configure без аргументов выводит все параметры конфигурации.

USE master;  
GO  
EXEC sp_configure 'show advanced options', '1';

Ниже приведено сообщение": "Параметр конфигурации "показать расширенные параметры" изменился с 0 до 1. Выполните инструкцию RECONFIGURE для установки.

Выполните инструкцию RECONFIGURE и отобразите все параметры конфигурации:

RECONFIGURE;  
EXEC sp_configure;

B. Изменение параметра конфигурации

В следующем примере системный параметр recovery interval устанавливается в 3 минуты.

USE master;  
GO  
EXEC sp_configure 'recovery interval', '3';  
RECONFIGURE WITH OVERRIDE;

Примеры: система платформы аналитики (PDW)

C. Список всех доступных параметров конфигурации.

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

EXEC sp_configure;

В результате возвращается имя параметра, за которым следуют его минимальное и максимальное значения. Config_value — это значение, которое Azure Synapse Analytics будет использовать при завершении настройки. run_value — это значение, которое используется в настоящий момент. Значения config_value и run_value , как правило, совпадают, если не находятся в процессе изменения.

D. Список параметров конфигурации для одного имени конфигурации.

EXEC sp_configure @configname='hadoop connectivity';

Д. Установка подключения к Hadoop.

Для настройки подключения Hadoop требуется несколько дополнительных шагов в дополнение к выполнению sp_configure. Полная процедура см. в разделе CREATE EXTERNAL DATA SOURCE (Transact-SQL).

См. также

ALTER SERVER CONFIGURATION (Transact-SQL)
RECONFIGURE (Transact-SQL)
Инструкции SET (Transact-SQL)
Параметры конфигурации сервера (SQL Server)
ALTER DATABASE (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)
sys.configurations (Transact-SQL)
ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL)
Архитектура Soft-NUMA (SQL Server)