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 OVERRIDE
RECONFIGURE
.
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)