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

적용 대상:  예 SQL Server  azure sql Managed Instance  No AZURE Synapse Analytics (SQL DW)  예 병렬 데이터 웨어하우스APPLIES TO: YesSQL Server YesAzure SQL Managed Instance NoAzure Synapse Analytics (SQL DW) YesParallel Data Warehouse

현재 서버에 대한 전역 구성 설정을 표시하거나 변경합니다.Displays or changes global configuration settings for the current server.

참고

데이터베이스 수준 구성 옵션은 ALTER DATABASE 범위 구성 (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를 사용 하 여 구성 설정을 업데이트 한 후에는 다시 구성 또는 다시 설정 재정의를 사용 하 여 시스템 관리자가 실행 중인 구성 값을 업데이트 해야 합니다.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 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.

SQL Server 빅 데이터 클러스터SQL Server Big Data Clusters

서버(인스턴스 수준) 설정을 구성하거나 가용성 그룹에 데이터베이스를 수동으로 추가하는 등의 특정 작업을 수행하려면 SQL Server 인스턴스에 연결해야 합니다.Certain operations, including configuring server (instance level) settings, or manually adding a database to an availability group, require a connection to the SQL Server Instance. 가용성 그룹에 속한 데이터베이스에서 sp_configure, RESTORE DATABASE 또는 DDL 명령과 같은 작업을 수행하려면 SQL Server 인스턴스에 연결해야 합니다.Operations like sp_configure, RESTORE DATABASE, or any DDL command in a database belonging to an availability group require a connection to the SQL Server instance. 기본적으로 빅 데이터 클러스터에는 인스턴스에 연결할 수 있는 엔드포인트가 포함되어 있지 않습니다.By default, a big data cluster does not include an endpoint that enables a connection to the instance. 이 엔드포인트는 수동으로 노출해야 합니다.You must expose this endpoint manually.

자세한 내용은 주 복제본의 데이터베이스에 연결을 참조하세요.For instructions, see Connect to databases on the primary replica.

실행 중인 구성 값 업데이트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. 예를 들어 recovery interval 값이 60 분 보다 크거나 선호도 마스크 값이 affinity I/O MASK 값과 겹치면 다시 구성에서 오류를 생성 합니다.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 memorymax server memory 서버 메모리 옵션은에서 동적으로 업데이트 데이터베이스 엔진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. sys.configurations 카탈로그 뷰의 is_dynamic 열을 살펴보면 동적 옵션을 확인할 수도 있습니다.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 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. 사용할 수 있도록 하려면 고급 옵션 표시 구성 옵션을 1로 설정 합니다.To make them available, set the Show Advanced Options configuration option to 1.

주의

고급 옵션 표시 옵션이 1로 설정 된 경우이 설정은 모든 사용자에 게 적용 됩니다.When the option Show Advanced Options is set to 1, this setting applies to all users. 이 상태를 일시적으로 사용 하 고 고급 옵션을 확인 해야 하는 작업이 완료 되 면 0으로 다시 전환 하는 것이 좋습니다.It is recommended to only use this state temporarily and switch back to 0 when done with the task that required viewing the advanced options.

구성 옵션 및 해당 설정에 대 한 자세한 내용은 서버 구성 옵션 (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. 구성 옵션을 변경 하거나 RECONFIGURE 문을 실행 하는 두 매개 변수를 사용 하 여 sp_configure 를 실행 하려면 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

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

"구성 옵션 ' 고급 옵션 표시 '가 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.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

C.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_valueMicrosoft Azure Synapse Analytics(이전의 SQL Data Warehouse)Microsoft Azure Synapse Analytics (formerly SQL Data Warehouse) 재구성이 완료 될 때 사용할 값입니다.The config_value is the value that Microsoft Azure Synapse Analytics(이전의 SQL Data Warehouse)Microsoft Azure Synapse Analytics (formerly 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.

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

EXEC sp_configure @configname='hadoop connectivity';  

E.E. Hadoop 연결 설정Set Hadoop connectivity

Hadoop 연결을 설정 하려면 sp_configure를 실행 하는 것 외에 몇 가지 추가 단계가 필요 합니다.Setting Hadoop connectivity requires a few more steps in addition to running sp_configure. 전체 절차는 CREATE EXTERNAL DATA SOURCE (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)