sp_configure(Transact-SQL)
적용 대상: 
SQL Server Azure SQL Managed Instance 
Azure Synapse Analytics Analytics Platform System(PDW)
현재 서버에 대한 전역 구성 설정을 표시하거나 변경합니다.
참고 항목
데이터베이스 수준 구성 옵션은 ALTER DATABASE SCOPED CONFIGURATION을 참조 하세요. Soft-NUMA를 구성하려면 Soft-NUMA(SQL Server)를 참조 하세요.
구문
SQL Server에 대한 구문입니다.
sp_configure
[ [ @configname = ] 'configname' ]
[ , [ @configvalue = ] configvalue ]
[ ; ]
PDW(Analytics Platform System)에 대한 구문입니다.
sp_configure
[ ; ]
인수
[ @configname = ] 'configname'
구성 옵션의 이름입니다. @configname 기본값NULL인 varchar(35)입니다. SQL Server 데이터베이스 엔진 구성 이름의 일부인 고유한 문자열을 인식합니다. 이 인수를 지정하지 않으면 옵션의 전체 목록이 반환됩니다.
사용 가능한 구성 옵션 및 해당 설정에 대한 자세한 내용은 서버 구성 옵션을 참조 하세요.
[ @configvalue = ] configvalue
새 구성 설정입니다. @configvalue 기본값NULL인 int입니다.
최대값은 개별 옵션에 따라 달라집니다. 각 옵션의 최대값을 보려면 카탈로그 뷰의 sys.configurations 열을 참조 maximum 하세요.
반환 코드 값
0(성공) 또는 1(실패).
결과 집합
매개 변수 sp_configure 없이 실행하면 다음 표와 같이 5개의 열이 있는 결과 집합을 반환하고 옵션을 사전순으로 오름차순으로 정렬합니다.
config_value run_value 값은 자동으로 동일하지 않습니다. 구성 설정을 사용하여 sp_configure업데이트한 후에는 실행 중인 구성 값 RECONFIGURE RECONFIGURE WITH OVERRIDE도 업데이트해야 합니다. 자세한 내용은 설명 섹션을 참조하세요.
| 열 이름 | 데이터 형식 | 설명 |
|---|---|---|
name |
nvarchar(35) | 구성 옵션의 이름입니다. |
minimum |
int | 구성 옵션의 최소값입니다. |
maximum |
int | 구성 옵션의 최대값입니다. |
config_value |
int | 구성 옵션이 설정된 sp_configure 값입니다(값은 sys.configurations.value).이러한 옵션에 대한 자세한 내용은 서버 구성 옵션 및 sys.configurations를 참조하세요. |
run_value |
int | 현재 구성 옵션의 값(값)을 sys.configurations.value_in_use실행 중입니다.자세한 내용은 sys.configurations를 참조 하세요. |
설명
서버 수준 설정을 표시하거나 변경하는 데 사용합니다 sp_configure . 데이터베이스 수준 설정을 변경하려면 .를 사용합니다 ALTER DATABASE. 현재 사용자 세션에만 영향을 주는 설정을 변경하려면 문을 사용합니다 SET .
일부 서버 구성 옵션은 ALTER SERVER CONFIGURATION을 통해서만 사용할 수 있습니다.
SQL Server 빅 데이터 클러스터
서버(인스턴스 수준) 설정을 구성하거나 가용성 그룹에 데이터베이스를 수동으로 추가하는 등의 특정 작업에는 SQL Server 인스턴스에 대한 연결이 필요합니다. 가용성 그룹에 속한 데이터베이스에서 sp_configure, RESTORE DATABASE 또는 DDL 명령과 같은 작업을 수행하려면 SQL Server 인스턴스에 연결해야 합니다. 기본적으로 빅 데이터 클러스터에는 인스턴스에 연결할 수 있는 엔드포인트가 포함되어 있지 않습니다. 이 엔드포인트는 수동으로 노출해야 합니다.
자세한 내용은 주 복제본의 데이터베이스에 연결을 참조하세요.
실행 중인 구성 값 업데이트
@configname 대한 새 @configvalue 지정하면 결과 집합에 이 값이 열에 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 '<configname>'. 열의 run_value config_value 값은 동적으로 업데이트된 옵션에 대해 일치해야 합니다. 카탈로그 뷰의 sys.configurations 열을 확인 is_dynamic 하여 동적 옵션을 확인할 수도 있습니다.
변경 내용은 SQL Server 오류 로그에도 기록됩니다.
지정한 @configvalue 옵션 run_value 에 대해 너무 높으면 열은 데이터베이스 엔진 기본값이 유효하지 않은 설정을 사용하는 대신 동적 메모리로 설정된다는 사실을 반영합니다.
자세한 내용은 RECONFIGURE를 참조 하세요.
고급 옵션
선호도 마스크 및 복구 간격과 같은 일부 구성 옵션은 고급 옵션으로 지정됩니다. 기본적으로 이러한 옵션은 보고 변경할 수 없습니다. 사용할 수 있도록 하려면 고급 옵션 표시 구성 옵션을 .로 1설정합니다.
주의
옵션 표시 고급 옵션이 설정된 1경우 이 설정은 모든 사용자에게 적용됩니다. 이 상태를 일시적으로 사용하고 고급 옵션을 확인해야 하는 작업을 완료할 0 때만 다시 전환하는 것이 좋습니다.
구성 옵션 및 해당 설정에 대한 자세한 내용은 서버 구성 옵션을 참조 하세요.
사용 권한
매개 변수 없이 또는 첫 번째 매개 변수만 사용하여 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';
결과 집합은 다음과 같습니다.
Configuration option 'show advanced options' changed from 0 to 1. Run the `RECONFIGURE` statement to install.
모든 구성 옵션을 실행하고 RECONFIGURE 표시합니다.
RECONFIGURE;
EXEC sp_configure;
B. 구성 옵션 변경
다음 예제에서는 시스템 recovery interval 구성 옵션을 분으로 3 설정합니다.
USE master;
GO
EXEC sp_configure 'recovery interval', '3';
RECONFIGURE WITH OVERRIDE;
예제: 분석 플랫폼 시스템(PDW)
C. 모든 사용 가능한 구성 설정 나열
다음 예에서는 모든 구성 옵션을 나열하는 방법을 보여 줍니다.
EXEC sp_configure;
결과로 옵션 이름과 그 뒤에 해당 옵션에 대한 최소 및 최대값이 반환됩니다. 재구성 config_value 이 완료될 때 Azure Synapse Analytics에서 사용하는 값입니다. run_value 현재 사용 중인 값입니다. config_value run_value 값이 변경되는 중이 아니면 일반적으로 동일합니다.
D. 특정 구성 이름에 대한 구성 설정 나열
EXEC sp_configure @configname = 'hadoop connectivity';
E. Hadoop 연결 설정
Hadoop 연결을 설정하려면 실행 sp_configure외에도 몇 가지 단계가 더 필요합니다. 전체 절차는 CREATE EXTERNAL DATA SOURCE를 참조 하세요.
sp_configure [ @configname = ] 'hadoop connectivity',
[ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }
[ ; ]
RECONFIGURE;
[ ; ]