sp_configure (Transact-SQL)

ОБЛАСТЬ ПРИМЕНЕНИЯ: SQL Server Управляемый экземпляр SQL Azure Azure Synapse Analytics Parallel Data Warehouse

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

Примечание

сведения о параметрах конфигурации уровня базы данных см. в разделе ALTER database scoped configuration (Transact-SQL). сведения о настройке программной архитектуры 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 Database Engine распознает любую уникальную строку, являющуюся частью имени конфигурации. Если этот параметр отсутствует, возвращается список всех параметров.

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

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

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

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

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

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

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

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

Имя столбца Тип данных Описание
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 отклоняет значение параметра, выходящее за разумный диапазон или способное вызвать конфликт параметров. Например, ПОВТОРная настройка выдает ошибку, если значение интервала восстановления превышает 60 минут или если значение маски сходства пересекается со значением сходства ввода-вывода . В противоположность этому, инструкция RECONFIGURE WITH OVERRIDE принимает любое значение параметра с правильным типом данных и инициирует повторную конфигурацию с заданным значением.

Внимание!

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

Инструкция RECONFIGURE выполняет динамическое обновление некоторых параметров; для обновления других параметров необходимо остановить и перезапустить сервер. Например, параметры min server memory и max server memory Server динамически обновляются в, Компонент Database Engine поэтому их можно изменить без перезапуска сервера. В отличие от этого, для повторной настройки значения, выполняемого для параметра Коэффициент заполнения , необходимо перезапустить Компонент Database Engine .

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

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

Примечание

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

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

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

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

Внимание!

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

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

Разрешения

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

Примеры

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

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

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

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

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

RECONFIGURE;  
EXEC sp_configure;  

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

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

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

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

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

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

EXEC sp_configure;  

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

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

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)