sp_configure (Transact-SQL)

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

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

Примечание.

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

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

Синтаксис

Синтаксис для SQL Server.

sp_configure
    [ [ @configname = ] 'configname' ]
    [ , [ @configvalue = ] configvalue ]
[ ; ]

Синтаксис для системы платформы аналитики (PDW).

sp_configure
[ ; ]

Аргументы

[ @configname = ] 'configname'

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

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

[ @configvalue = ] configvalue

Новый параметр конфигурации. @configvalue имеет значение int с значением по умолчаниюNULL.

Максимальное значение зависит от конкретного параметра. Чтобы просмотреть максимальное значение каждого параметра, см maximum . столбец 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). Дополнительные сведения об этих параметрах см. в разделе "Параметры конфигурации сервера" и sys.configurations.
run_value	int	В настоящее время выполняется значение параметра конфигурации (значение в sys.configurations.value_in_use). Дополнительные сведения см. в разделе sys.configurations.

Замечания

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

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

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

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

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

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

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

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

Внимание

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

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

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

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

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

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

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

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

Внимание

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

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

Разрешения

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';

Вот результирующий набор.

Configuration option 'show advanced options' changed from 0 to 1. Run the `RECONFIGURE` statement to install.

Выполните инструкцию 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.

sp_configure [ @configname = ] 'hadoop connectivity',
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }
[ ; ]
RECONFIGURE;
[ ; ]

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

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