sp_configure (Transact-SQL)sp_configure (Transact-SQL)

Область применения: ДаSQL Server ДаБаза данных SQL Azure (только управляемый экземпляр)НетХранилище данных SQL AzureДаParallel Data WarehouseAPPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse yesParallel Data Warehouse

Отображает или изменяет глобальные параметры конфигурации текущего сервера.Displays or changes global configuration settings for the current server.

Примечание

Сведения о параметрах конфигурации уровня базы данных см. в разделе ALTER (Database scoped)Configuration Transact-SQL.For database-level configuration options, see ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL). Сведения о настройке программной архитектуры NUMA см. в разделе Soft-numa ()SQL Server.To configure Soft-NUMA, see Soft-NUMA (SQL Server).

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

-- 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  
[;]  

АргументыArguments

[ @configname = ] 'option_name' — имя параметра конфигурации.[ @configname = ] 'option_name' Is the name of a configuration option. Аргументoption_name имеет тип varchar(35) , значение по умолчанию — NULL.option_name is varchar(35), with a default of NULL. Компонент Компонент SQL Server Database EngineSQL Server Database Engine распознает любую уникальную строку, являющуюся частью имени конфигурации.The Компонент SQL Server Database EngineSQL Server Database Engine recognizes any unique string that is part of the configuration name. Если этот параметр отсутствует, возвращается список всех параметров.If not specified, the complete list of options is returned.

Сведения о доступных параметрах конфигурации и их параметрах см. в разделе Параметры (конфигурации)сервера SQL Server.For information about the available configuration options and their settings, see Server Configuration Options (SQL Server).

[ @configvalue = ] 'value' — это новый параметр конфигурации.[ @configvalue = ] 'value' Is the new configuration setting. Аргументvalue имеет тип intи значение по умолчанию NULL.value is int, with a default of NULL. Максимальное значение зависит от конкретного параметра.The maximum value depends on the individual option.

Чтобы увидеть максимальное значение для каждого параметра, см. столбец Максимальное в представлении каталога sys. Configurations .To see the maximum value for each option, see the maximum column of the sys.configurations catalog view.

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

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

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

При выполнении без параметров хранимая процедура sp_configure возвращает результирующий набор с пятью столбцами и упорядочивает параметры в алфавитном порядке по возрастанию, как показано в следующей таблице.When executed with no parameters, sp_configure returns a result set with five columns and orders the options alphabetically in ascending order, as shown in the following table.

Значения для config_value и run_value не эквивалентны автоматически.The values for config_value and run_value are not automatically equivalent. После обновления параметра конфигурации с помощью хранимой процедуры sp_configureсистемный администратор должен обновить выполняемое значение конфигурации, используя перенастройку или ПЕРЕнастроить с помощью переопределения.After updating a configuration setting by using sp_configure, the system administrator must update the running configuration value by using either RECONFIGURE or RECONFIGURE WITH OVERRIDE. Дополнительные сведения см. в разделе "Примечания".For more information, see the Remarks section.

Имя столбцаColumn name Тип данныхData type ОписаниеDescription
namename nvarchar(35)nvarchar(35) Имя параметра конфигурации.Name of the configuration option.
minimumminimum intint Минимальное значение параметра конфигурации.Minimum value of the configuration option.
maximummaximum intint Максимальное значение параметра конфигурации.Maximum value of the configuration option.
config_valueconfig_value intint Значение, для которого параметр конфигурации был задан с помощью хранимой процедуры sp_configure (значение в sys. Configurations. Value).Value to which the configuration option was set using sp_configure (value in sys.configurations.value). Дополнительные сведения об этих параметрах см. в разделе Параметры (конфигурации) сервера SQL Server и sys (. Configurations)Transact-SQL.For more information about these options, see Server Configuration Options (SQL Server) and sys.configurations (Transact-SQL).
run_valuerun_value intint Текущее значение параметра конфигурации (значение в sys. Configurations. value_in_use).Currently running value of the configuration option (value in sys.configurations.value_in_use).

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

ПримечанияRemarks

Используйте хранимую процедуру sp_configure для вывода или изменения параметров серверного уровня.Use sp_configure to display or change server-level settings. Для изменения параметров уровня базы данных используйте инструкцию ALTER DATABASE.To change database-level settings, use ALTER DATABASE. Для изменения параметров, влияющих только на сеанс текущего пользователя, используйте инструкцию SET.To change settings that affect only the current user session, use the SET statement.

Обновление активного значения конфигурацииUpdating the Running Configuration Value

При указании нового значения для параметрарезультирующий набор показывает это значение в столбце config_value .When you specify a new value for an option, the result set shows this value in the config_value column. Изначально это значение отличается от значения в столбце run_value , которое показывает текущее выполняемое значение конфигурации.This value initially differs from the value in the run_value column, which shows the currently running configuration value. Чтобы обновить значение выполняющейся конфигурации в столбце run_value , системный администратор должен выполнить перенастройку или ПЕРЕнастроить с переопределением.To update the running configuration value in the run_value column, the system administrator must run either RECONFIGURE or RECONFIGURE WITH OVERRIDE.

Обе инструкции — и RECONFIGURE, и RECONFIGURE WITH OVERRIDE — работают с любым параметром конфигурации.Both RECONFIGURE and RECONFIGURE WITH OVERRIDE work with every configuration option. Однако базовая инструкция RECONFIGURE отклоняет значение параметра, выходящее за разумный диапазон или способное вызвать конфликт параметров.However, the basic RECONFIGURE statement rejects any option value that is outside a reasonable range or that may cause conflicts among options. Например, ПОВТОРная настройка выдает ошибку, если значение интервала восстановления превышает 60 минут или если значение маски сходства пересекается со значением сходства ввода-вывода .For example, RECONFIGURE generates an error if the recovery interval value is larger than 60 minutes or if the affinity mask value overlaps with the affinity I/O mask value. В противоположность этому, инструкция RECONFIGURE WITH OVERRIDE принимает любое значение параметра с правильным типом данных и инициирует повторную конфигурацию с заданным значением.RECONFIGURE WITH OVERRIDE, in contrast, accepts any option value with the correct data type and forces reconfiguration with the specified value.

Внимание!

Недопустимое значение параметра может отрицательно сказаться на конфигурации экземпляра сервера.An inappropriate option value can adversely affect the configuration of the server instance. Поэтому использовать инструкцию RECONFIGURE WITH OVERRIDE следует с осторожностью.Use RECONFIGURE WITH OVERRIDE cautiously.

Инструкция RECONFIGURE выполняет динамическое обновление некоторых параметров; для обновления других параметров необходимо остановить и перезапустить сервер.The RECONFIGURE statement updates some options dynamically; other options require a server stop and restart. Например, параметры min server memory и max server memory Server динамически обновляются в Компонент Database EngineDatabase Engine; Поэтому их можно изменить без перезапуска сервера.For example, the min server memory and max server memory server memory options are updated dynamically in the Компонент Database EngineDatabase Engine; therefore, you can change them without restarting the server. В отличие от этого, для повторной настройки значения, выполняемого для параметра fill factor , необходимо перезапустить Компонент Database EngineDatabase Engine.By contrast, reconfiguring the running value of the fill factor option requires restarting the Компонент Database EngineDatabase Engine.

После выполнения команды "изменить конфигурацию" для параметра конфигурации можно определить, был ли обновлен параметр динамически, выполнив процедуру sp_configure "option_name" .After running RECONFIGURE on a configuration option, you can see whether the option has been updated dynamically by executing sp_configure'option_name'. Значения в столбцах run_value и config_value должны соответствовать динамически обновляемым параметрам.The values in the run_value and config_value columns should match for a dynamically updated option. Можно также проверить, какие параметры являются динамическими, просмотрев столбец is_dynamic представления каталога sys. Configurations .You can also check to see which options are dynamic by looking at the is_dynamic column of the sys.configurations catalog view.

Это изменение также записывается в SQL Server журнал ошибок.The change is also written to the SQL Server error log.

Примечание

Если указанное значение слишком велико для параметра, столбец run_value отражает тот факт, что Компонент Database EngineDatabase Engine по умолчанию имеет значение динамической памяти, а не использует недопустимый параметр.If a specified value is too high for an option, the run_value column reflects the fact that the Компонент Database EngineDatabase Engine has defaulted to dynamic memory rather than use a setting that is not valid.

Дополнительные сведения см. в разделе Повторная настройка (Transact)-SQL.For more information, see RECONFIGURE (Transact-SQL).

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

Некоторые параметры конфигурации, такие как маска сходства и интервал восстановления, обозначены как дополнительные параметры.Some configuration options, such as affinity mask and recovery interval, are designated as advanced options. По умолчанию эти параметры недоступны для просмотра и изменения.By default, these options are not available for viewing and changing. Чтобы сделать их доступными, установите для параметра конфигурации шовадванцедоптионс значение 1.To make them available, set the ShowAdvancedOptions configuration option to 1.

Дополнительные сведения о параметрах конфигурации и их параметрах см. в разделе Параметры (конфигурации)сервера SQL Server.For more information about the configuration options and their settings, see Server Configuration Options (SQL Server).

РазрешенияPermissions

Разрешения на выполнение хранимой процедуры sp_configure без параметров или только с первым параметром по умолчанию предоставляются всем пользователям.Execute permissions on sp_configure with no parameters or with only the first parameter are granted to all users by default. Чтобы выполнить хранимую процедуру sp_configure с обоими параметрами для изменения параметра конфигурации или выполнения инструкции RECONFIGURE, необходимо обладать разрешением ALTER SETTINGS на уровне сервера.To execute sp_configure with both parameters to change a configuration option or to run the RECONFIGURE statement, you must be granted the ALTER SETTINGS server-level permission. Разрешение ALTER SETTINGS неявным образом предоставлено предопределенным ролям сервера sysadmin и serveradmin .The ALTER SETTINGS permission is implicitly held by the sysadmin and serveradmin fixed server roles.

ПримерыExamples

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

В следующем примере демонстрируется, как установить и отобразить все параметры конфигурации.The following example shows how to set and list all configuration options. Дополнительные параметры конфигурации отображаются, если предварительно параметру show advanced option присвоить значение 1.Advanced configuration options are displayed by first setting show advanced option to 1. После изменения этого параметра выполнение хранимой процедуры sp_configure без аргументов выводит все параметры конфигурации.After this option has been changed, executing sp_configure with no parameters displays all configuration options.

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

Вот сообщение: "Параметр конфигурации" Показывать дополнительные параметры "изменен с 0 на 1.Here is the message: "Configuration option 'show advanced options' changed from 0 to 1. Выполните инструкцию RECONFIGURE для установки.Run the RECONFIGURE statement to install."

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

RECONFIGURE;  
EXEC sp_configure;  

Б.B. Изменение параметра конфигурацииChanging a configuration option

В следующем примере системный параметр recovery interval устанавливается в 3 минуты.The following example sets the system recovery interval to 3 minutes.

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

Примеры: Параллельное хранилище данныхParallel Data WarehouseExamples: Параллельное хранилище данныхParallel Data Warehouse

В.C. Список всех доступных параметров конфигурации.List all available configuration settings

В следующем примере демонстрируется, как создать список всех параметров конфигурации.The following example shows how to list all configuration options.

EXEC sp_configure;  

В результате возвращается имя параметра, за которым следуют его минимальное и максимальное значения.The result returns the option name followed by the minimum and maximum values for the option. Config_value — это значение, которое Хранилище данных SQLSQL Data Warehouse будет использоваться при завершении перенастройки.The config_value is the value that Хранилище данных SQLSQL Data Warehouse will use when reconfiguration is complete. run_value — это значение, которое используется в настоящий момент.The run_value is the value that is currently being used. Значения config_value и run_value , как правило, совпадают, если не находятся в процессе изменения.The config_value and run_value are usually the same unless the value is in the process of being changed.

Г.D. Список параметров конфигурации для одного имени конфигурации.List the configuration settings for one configuration name

EXEC sp_configure @configname='hadoop connectivity';  

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

Настройка подключения Hadoop требует выполнения еще нескольких действий в дополнение к запуску процедуры sp_configure.Setting Hadoop connectivity requires a few more steps in addition to running sp_configure. Полную процедуру см. в разделе Создание внешнего источника (данных Transact-SQL).For the full procedure, see CREATE EXTERNAL DATA SOURCE (Transact-SQL).

См. такжеSee Also

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