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

이 항목은 다음에 적용됩니다. 예SQL Server(2008부터)아니요Azure SQL Database아니요Azure SQL Data Warehouse 예병렬 데이터 웨어하우스 THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure 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를 구성 하려면 참조 소프트 NUMA ( SQL Server ) .To configure Soft-NUMA, see Soft-NUMA (SQL Server).

항목 링크 아이콘 Transact-SQL 구문 규칙Topic 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_namevarchar(35)이며 기본값은 NULL입니다.option_name is varchar(35), with a default of NULL. SQL Server 데이터베이스 엔진SQL Server Database Engine에서는 구성 이름의 일부인 고유 문자열을 모두 인식합니다.The SQL Server 데이터베이스 엔진SQL 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. valueint이며 기본값은 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 5 개의 열이 있는 결과 집합을 반환 하 고 다음 표와 같이 옵션이 알파벳 오름차순으로 정렬 합니다.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_valuerun_value 자동으로 같지 않습니다.The values for config_value and run_value are not automatically equivalent. 사용 하 여 구성 설정을 업데이트 한 후 sp_configure, 시스템 관리자가 reconfigure 또는 RECONFIGURE WITH OVERRIDE를 사용 하 여 실행 중인 구성 값을 업데이트 해야 합니다.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 DescriptionDescription
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 열 reconfigure 또는 RECONFIGURE WITH OVERRIDE 시스템 관리자를 실행 해야 합니다.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. 경우 RECONFIGURE 오류를 생성 하는 예를 들어는 복구 간격 값이 60 분 보다 클 경우는 선호도 마스크 값과 겹치는 선호도 I/O 마스크값입니다.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. 예를 들어는 최소 서버 메모리최대 서버 메모리 서버 메모리 옵션에서 동적으로 업데이트 되는 데이터베이스 엔진Database Engine; 따라서 서버를 다시 시작 하지 않고 변경할 수 있습니다.For example, the min server memory and max server memory server memory options are updated dynamically in the 데이터베이스 엔진Database Engine; therefore, you can change them without restarting the server. 반면, 실행 중인 값을 다시 구성는 채우기 비율 옵션을 사용 하려면 다시 시작은 데이터베이스 엔진Database Engine합니다.By contrast, reconfiguring the running value of the fill factor option requires restarting the 데이터베이스 엔진Database Engine.

구성 옵션에서 RECONFIGURE를 실행 한 후 확인할 수 있습니다는 옵션을 실행 하 여 동적으로 업데이트 되었습니다 여부 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_valueconfig_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.

참고

지정 된 경우 는 옵션에 대해 너무 높기는 run_value 열 사실을 반영 하는 데이터베이스 엔진Database Engine 유효 하지 않은 설정을 사용 하지 않고 하지 못했습니다. 동적 메모리 합니다.If a specified value is too high for an option, the run_value column reflects the fact that the 데이터베이스 엔진Database Engine has defaulted to dynamic memory rather than use a setting that is not valid.

자세한 내용은 참조 reconfigure( 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. 설정에서 사용할 수 있게,는 ShowAdvancedOptions 옵션을 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).

PermissionsPermissions

매개 변수 없이 또는 첫 번째 매개 변수만 사용하여 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. sysadminserveradmin 고정 서버 역할은 ALTER SETTINGS 권한을 암시적으로 보유하고 있습니다.The ALTER SETTINGS permission is implicitly held by the sysadmin and serveradmin fixed server roles.

Examples

1.A. 고급 구성 옵션 나열Listing the advanced configuration options

다음 예에서는 모든 구성 옵션을 설정하고 나열하는 방법을 보여 줍니다.The following example shows how to set and list all configuration options. 먼저 show advanced option1로 설정하면 고급 구성 옵션이 표시됩니다.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';  

메시지는 다음과 같습니다: "구성 옵션을 1로 0에서 변경 'show advanced options'입니다.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;  

2.B. 구성 옵션 변경Changing a configuration option

다음 예에서는 시스템 recovery interval3분으로 설정합니다.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

3.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 값인는 SQL 데이터 웨어하우스SQL Data Warehouse 재구성이 완료 되 면 사용 됩니다.The config_value is the value that SQL 데이터 웨어하우스SQL Data Warehouse will use when reconfiguration is complete. run_value 는 현재 사용되는 값입니다.The run_value is the value that is currently being used. config_valuerun_value 는 값이 변경 중이 아니라면 일반적으로 동일합니다.The config_value and run_value are usually the same unless the value is in the process of being changed.

4.D. 특정 구성 이름에 대한 구성 설정 나열List the configuration settings for one configuration name

EXEC sp_configure @configname='hadoop connectivity';  

5.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)