sp_configure(Transact-SQL)

적용 대상: SQL Server Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

현재 서버에 대한 전역 구성 설정을 표시하거나 변경합니다.

참고

데이터베이스 수준 구성 옵션은 ALTER DATABASE SCOPED CONFIGURATION(Transact-SQL)을 참조하세요. Soft-NUMA를 구성하려면 SQL Server(Soft-NUMA)를 참조하세요.

Topic link iconTransact-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_namevarchar(35) 이며 기본값은 NULL입니다. SQL Server 데이터베이스 엔진 구성 이름의 일부인 고유한 문자열을 인식합니다. 이 인수를 지정하지 않으면 옵션의 전체 목록이 반환됩니다.

사용 가능한 구성 옵션 및 해당 설정에 대한 자세한 내용은 서버 구성 옵션(SQL Server)을 참조하세요.

[ @configvalue = ] 'value' 새 구성 설정입니다. valueint이며 기본값은 NULL입니다. 최대값은 개별 옵션에 따라 달라집니다.

각 옵션의 최대값을 보려면 sys.configurations 카탈로그 뷰의 최대 열을 참조하세요.

반환 코드 값

0(성공) 또는 1(실패)

결과 집합

매개 변수 없이 실행되는 경우 sp_configure 5개의 열이 있는 결과 집합을 반환하고 다음 표와 같이 옵션을 사전순으로 오름차순으로 정렬합니다.

config_valuerun_value 값은 자동으로 동일하지 않습니다. sp_configure 사용하여 구성 설정을 업데이트한 후 시스템 관리자는 RECONFIGURE 또는 RECONFIGURE WITH OVERRIDE를 사용하여 실행 중인 구성 값을 업데이트해야 합니다. 자세한 내용은 주의 섹션을 참조하세요.

열 이름 데이터 형식 설명
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와 RECONFIGURE WITH OVERRIDE는 둘 다 모든 구성 옵션에 사용할 수 있습니다. 그러나 기본 RECONFIGURE 문은 적당한 범위 밖에 있는 옵션 값이나 옵션 간에 충돌을 일으킬 수 있는 옵션 값을 거부합니다. 예를 들어 RECONFIGURE는 복구 간격 값이 60분보다 크거나 선호도 마스크 값이 선호도I/O 마스크 값과 겹치는 경우 오류를 생성합니다. 이와 달리 RECONFIGURE WITH OVERRIDE는 데이터 형식만 맞으면 모든 옵션 값을 허용하며 지정된 값으로 다시 구성합니다.

주의

옵션 값을 잘못 설정하면 역으로 서버 인스턴스 구성에 영향을 줄 수 있습니다. RECONFIGURE WITH OVERRIDE는 매우 주의를 기울여 사용해야 합니다.

RECONFIGURE 문은 일부 옵션을 동적으로 업데이트합니다. 그 외의 옵션을 업데이트하려면 서버를 중지하고 다시 시작해야 합니다. 예를 들어 최소 서버 메모리최대 서버 메모리 서버 메모리 옵션은 데이터베이스 엔진 동적으로 업데이트되므로 서버를 다시 시작하지 않고 변경할 수 있습니다. 반면 채우기 비율 옵션의 실행 값을 다시 구성하려면 데이터베이스 엔진 다시 시작해야 합니다.

구성 옵션에서 RECONFIGURE를 실행한 후 sp_configure'option_name'를 실행하여 옵션이 동적으로 업데이트되었는지 확인할 수 있습니다. run_valueconfig_value 열의 값은 동적으로 업데이트된 옵션과 일치해야 합니다. sys.configurations 카탈로그 뷰의 is_dynamic 열을 확인하여 동적 옵션을 확인할 수도 있습니다.

변경 내용은 SQL Server 오류 로그에도 기록됩니다.

참고

지정된 이 옵션에 대해 너무 높으면 run_value 열은 데이터베이스 엔진 유효하지 않은 설정을 사용하는 대신 동적 메모리로 기본값이 지정되었다는 사실을 반영합니다.

자세한 내용은 RECONFIGURE(Transact-SQL)를 참조하세요.

고급 옵션

선호도 마스크복구 간격과 같은 일부 구성 옵션은 고급 옵션으로 지정됩니다. 기본적으로 이 옵션은 보거나 변경할 수 없습니다. 사용할 수 있도록 하려면 고급 옵션 표시 구성 옵션을 1로 설정합니다.

주의

고급 옵션 표시 옵션이 1로 설정된 경우 이 설정은 모든 사용자에게 적용됩니다. 이 상태를 일시적으로만 사용하고 고급 옵션을 확인해야 하는 작업을 완료하면 다시 0으로 전환하는 것이 좋습니다.

구성 옵션 및 해당 설정에 대한 자세한 내용은 서버 구성 옵션(SQL Server)을 참조하세요.

사용 권한

매개 변수 없이 또는 첫 번째 매개 변수만 사용하여 sp_configure 를 실행할 수 있는 권한은 기본적으로 모든 사용자에게 부여됩니다. 구성 옵션을 변경하거나 RECONFIGURE 문을 실행하기 위해 두 매개 변수로 sp_configure 실행하려면 ALTER SETTINGS 서버 수준 권한이 부여되어야 합니다. sysadminserveradmin 고정 서버 역할은 ALTER SETTINGS 권한을 암시적으로 보유하고 있습니다.

예제

A. 고급 구성 옵션 나열

다음 예에서는 모든 구성 옵션을 설정하고 나열하는 방법을 보여 줍니다. 먼저 show advanced options1로 설정하면 고급 구성 옵션이 표시됩니다. 이 옵션을 변경한 다음 매개 변수 없이 sp_configure를 실행하면 모든 구성 옵션이 표시됩니다.

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

"구성 옵션 '고급 옵션 표시'가 0에서 1로 변경되었습니다. RECONFIGURE 문을 실행하여 설치하십시오."

RECONFIGURE를 실행하여 모든 구성 옵션을 표시합니다.

RECONFIGURE;  
EXEC sp_configure;  

B. 구성 옵션 변경

다음 예에서는 시스템 recovery interval3분으로 설정합니다.

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

예제: 분석 플랫폼 시스템(PDW)

C. 모든 사용 가능한 구성 설정 나열

다음 예에서는 모든 구성 옵션을 나열하는 방법을 보여 줍니다.

EXEC sp_configure;  

결과로 옵션 이름과 그 뒤에 해당 옵션에 대한 최소 및 최대값이 반환됩니다. config_value 재구성이 완료될 때 Microsoft Azure Synapse Analytics에서 사용할 값입니다. run_value 는 현재 사용되는 값입니다. config_valuerun_value 는 값이 변경 중이 아니라면 일반적으로 동일합니다.

D. 특정 구성 이름에 대한 구성 설정 나열

EXEC sp_configure @configname='hadoop connectivity';  

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