sp_configure(Transact-SQL)

적용 대상: SQL Server Azure SQL Managed Instance Azure Synapse Analytics 병렬 데이터 웨어하우스

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

참고

데이터베이스 수준 구성 옵션은 ALTER DATABASE 범위 구성 (transact-sql)를 참조 하세요. 소프트 NUMA를 구성 하려면 소프트 numa (SQL Server)를 참조 하세요.

항목 링크 아이콘 Transact-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 를 사용 하 여 구성 설정을 업데이트 한 후에는 다시 구성 또는 다시 설정 재정의를 사용 하 여 시스템 관리자가 실행 중인 구성 값을 업데이트 해야 합니다. 자세한 내용은 주의 섹션을 참조하세요.

열 이름 데이터 형식 Description
name nvarchar(35) 구성 옵션의 이름입니다.
minimum int 구성 옵션의 최소값입니다.
maximum int 구성 옵션의 최대값입니다.
config_value int Sp_configure ( sys.configurations 값)를 사용 하 여 구성 옵션이 설정 된 값입니다. 이러한 옵션에 대 한 자세한 내용은 서버 구성 옵션 (SQL Server)sys.configurations (transact-sql)을 참조 하세요.
run_value int 현재 실행 중인 구성 옵션 값 ( sys.configurations.value_in_use 의 값)입니다.

자세한 내용은 sys.configurations (transact-sql)를 참조 하세요.

설명

Sp_configure 를 사용 하 여 서버 수준 설정을 표시 하거나 변경할 수 있습니다. 데이터베이스 수준의 설정을 변경하려면 ALTER DATABASE를 사용합니다. 현재 사용자 세션에만 적용되는 설정을 변경하려면 SET 문을 사용합니다.

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

주의

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

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

구성 옵션에서 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 option1로 설정하면 고급 구성 옵션이 표시됩니다. 이 옵션을 변경한 다음 매개 변수 없이 sp_configure를 실행하면 모든 구성 옵션이 표시됩니다.

USE master;  
GO  
EXEC sp_configure 'show advanced option', '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)를 참조 하세요.

참고 항목

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)