CREATE WORKLOAD GROUP(Transact-SQL)

제품 선택

다음 행에서 관심 있는 제품 이름을 선택하면 해당 제품의 정보만 표시됩니다.

* SQL Server *  

SQL Managed Instance

Azure Synapse
분석

 

SQL Server 및 SQL Managed Instance

리소스 관리자 작업 그룹을 만든 후 이 작업 그룹을 리소스 관리자 리소스 풀에 연결합니다. 일부 SQL Server 버전에서는 리소스 관리자를 사용할 수 없습니다. SQL Server 버전에서 지원되는 기능 목록은 SQL Server 2022의 버전과 지원하는 기능을 참조하세요.

Transact-SQL 구문 표기 규칙.

구문

CREATE WORKLOAD GROUP group_name
[ WITH
    ( [ IMPORTANCE = { LOW | MEDIUM | HIGH } ]
      [ [ , ] REQUEST_MAX_MEMORY_GRANT_PERCENT = value ]
      [ [ , ] REQUEST_MAX_CPU_TIME_SEC = value ]
      [ [ , ] REQUEST_MEMORY_GRANT_TIMEOUT_SEC = value ]
      [ [ , ] MAX_DOP = value ]
      [ [ , ] GROUP_MAX_REQUESTS = value ] )
 ]
[ USING {
    [ pool_name | "default" ]
    [ [ , ] EXTERNAL external_pool_name | "default" ] ]
    } ]
[ ; ]

인수

group_name

작업 그룹에 대한 사용자 정의 이름입니다. group_name은 영숫자로 최대 128자를 사용할 수 있으며, SQL Server의 인스턴스 내에서 중복되지 않아야 하고 데이터베이스 식별자에 대한 규칙을 따라야 합니다.

IMPORTANCE = { LOW | MEDIUM | HIGH }

작업 그룹에 있는 요청의 상대적 중요도를 지정합니다. 중요도는 다음 중 하나이며 MEDIUM이 기본값이 됩니다.

• LOW
• MEDIUM(기본값)
• HIGH

참고

내부적으로 각 중요도 설정은 계산에 사용된 숫자로 저장됩니다.

IMPORTANCE는 리소스 풀에 대해 로컬입니다. 같은 리소스 풀 내에 있는 다른 중요도의 작업 그룹은 서로 영향을 주지만 다른 리소스 풀의 작업 그룹에는 영향을 주지 않습니다.

REQUEST_MAX_MEMORY_GRANT_PERCENT = value

단일 요청이 풀에서 사용할 수 있는 최대 메모리 양을 지정합니다. 값은 MAX_MEMORY_PERCENT에서 지정한 리소스 풀 크기와 관련된 백분율입니다. 기본값은 25입니다.

값은 SQL Server 2017(14.x)까지의 정수이며 허용되는 범위는 1에서 100까지입니다. SQL Server 2019(15.x)부터 시작하는 값은 float 데이터 유형이고 허용 범위는 0에서 100까지입니다.

중요

지정된 양은 쿼리 실행 부여 메모리만 참조합니다.

value를 0으로 설정하면 사용자 정의 작업 그룹에 SORT 및 HASH JOIN 작업이 있는 쿼리가 실행되지 않습니다.

다른 동시 쿼리를 실행 중인 경우 서버가 사용 가능한 메모리를 충분히 따로 설정해 놓지 못할 수 있으므로 ‘값’을 70을 초과하는 값으로 설정하지 않는 것이 좋습니다. 71 이상의 값으로 설정하면 쿼리 시간 초과 오류 8645가 발생할 수 있습니다.

쿼리 메모리 요구 사항이 이 매개 변수에 지정된 제한을 초과하는 경우 서버는 다음을 수행합니다.

• 사용자 정의 작업 그룹의 경우 서버는 메모리 요구 사항이 제한 수준 아래로 낮아지거나 병렬 처리 수준이 1이 될 때까지 쿼리 병렬 처리 수준을 줄이려고 합니다. 그래도 쿼리 메모리 요구 사항이 제한보다 클 경우 오류 8657이 발생합니다.

• 내부 및 기본 작업 그룹의 경우 서버는 쿼리가 필요한 메모리를 가져오도록 허용합니다.

두 경우 모두 서버에 실제 메모리가 부족하면 시간 초과 오류 8645가 발생할 수 있습니다.

REQUEST_MAX_CPU_TIME_SEC = value

요청이 사용할 수 있는 최대 CPU 시간(초)을 지정합니다. value는 0 또는 양의 정수여야 합니다. value의 기본 설정인 0은 무제한을 의미합니다.

참고

기본적으로 최대 시간이 초과하는 경우 Resource Governor가 요청을 종료하지는 않지만 이벤트가 생성됩니다. 자세한 내용은 CPU Threshold Exceeded 이벤트 클래스를 참조하세요.

중요

SQL Server 2016(13.x) SP2 및 SQL Server 2017(14.x) CU3부터 2422 추적 플래그를 사용하여 최대 시간이 초과되면 Resource Governor에서 요청을 중단합니다.

REQUEST_MEMORY_GRANT_TIMEOUT_SEC = value

메모리(작업 버퍼 메모리)가 부여될 때까지 쿼리가 대기할 수 있는 최대 시간(초)을 지정합니다. value는 0 또는 양의 정수여야 합니다. value의 기본 설정인 0은 쿼리 비용에 따른 내부 계산을 사용하여 최대 시간을 결정합니다.

참고

메모리 부여 제한 시간에 도달할 때마다 쿼리가 실패하지는 않습니다. 쿼리는 너무 많은 쿼리가 동시에 실행되는 경우에만 실패합니다. 그렇지 않을 경우 쿼리에 최소한의 메모리만 부여되어 쿼리 성능이 떨어질 수 있습니다.

MAX_DOP = value

병렬 쿼리 실행에 대한 MAXDOP(의 최대 병렬 처리 수준) 를 지정합니다. value는 0 또는 양의 정수여야 합니다. 허용되는 value의 범위는 0에서 64까지입니다. value의 기본 설정 0은 전역 설정을 사용합니다.

MAX_DOP는 다음과 같이 처리합니다.

• MAX_DOP는 작업 그룹 MAX_DOP를 초과하지 않는 한 쿼리 힌트 역할을 합니다.

• MAX_DOP는 쿼리 힌트로서 항상 sp_configure 'max degree of parallelism'을 무시합니다.

• 작업 그룹 MAX_DOP는 sp_configure 'max degree of parallelism'을 무시합니다.

• 컴파일할 때 쿼리가 직렬 (MAX_DOP = 1)로 표시되면 작업 그룹이나 sp_configure 설정에 관계없이 런타임에서 병렬로 다시 변경할 수 없습니다.

DOP가 구성된 후에는 부여 메모리가 부족할 때만 낮아질 수 있습니다. 작업 그룹 재구성은 부여 메모리 큐에서 대기하는 동안 표시되지 않습니다.

참고

워크로드 그룹 MAX_DOP 최대 병렬 처리 수준 및 데이터베이스 범위 구성에 대한 서버 구성을 MAXDOP 재정의합니다.

팁

쿼리 수준에서 이 작업을 수행하려면 쿼리 힌트를 MAXDOP 사용합니다. 쿼리 힌트로 설정된 최대 병렬 처리 수준은 작업 그룹 MAX_DOP를 초과하지 않는 한 유효합니다. MAXDOP 쿼리 힌트 값이 리소스 관리자를 사용하여 구성된 값을 초과하는 경우 SQL Server 데이터베이스 엔진은 리소스 관리자 MAX_DOP 값을 사용합니다. MAXDOP 쿼리 힌트는 항상 최대 병렬 처리 수준 서버 구성을 재정의합니다.

데이터베이스 수준에서 이 작업을 수행하려면 데이터베이스 범위 구성을 MAXDOP 사용합니다.

서버 수준에서 이 작업을 수행하려면 MAXDOP(최대 병렬 처리 수준) 서버 구성 옵션을 사용합니다.

GROUP_MAX_REQUESTS = value

작업 그룹에서 실행할 수 있는 최대 동시 요청 수를 지정합니다. value는 0이거나 양의 정수여야 합니다. 값의 기본 설정은 0이며, 무제한 요청을 허용합니다. 최대 동시 요청에 도달한 경우 해당 그룹의 사용자가 로그인할 수 있지만 지정된 값 아래로 동시 요청 수가 떨어질 때까지 사용자가 대기 상태에 배치됩니다.

USING { pool_name | "default" }

pool_name으로 식별된 사용자 정의 리소스 풀에 작업 그룹을 연결합니다. 그러면 실제로 리소스 풀에 작업 그룹을 넣습니다. pool_name이 제공되지 않거나 USING 인수가 사용되지 않으면 작업 그룹은 미리 정의된 Resource Governor 기본 풀에 배치됩니다.

"default"는 예약어이며 USING과 함께 사용될 경우 따옴표("") 또는 대괄호([])로 묶여야 합니다.

참고

미리 정의된 작업 그룹과 리소스 풀은 모두 "default"와 같은 소문자 이름을 사용합니다. 대/소문자 구분 데이터 정렬을 사용하는 서버의 경우 이러한 사항을 고려해야 합니다. 대/소문자를 구분하지 않는 데이터 정렬이 포함된 서버(예: SQL_Latin1_General_CP1_CI_AS)는 "default"와 "Default"를 동일하게 취급합니다.

EXTERNAL external_pool_name | "default"

적용 대상: SQL Server 2016(13.x) 이상

작업 그룹은 외부 리소스 풀을 지정할 수 있습니다. 작업 그룹을 정의하고 다음 2개의 풀과 연결할 수 있습니다.

• SQL Server 워크로드 및 쿼리에 대한 리소스 풀
• 외부 프로세스에 대한 외부 리소스 풀. 자세한 내용은 sp_execute_external_script (Transact-SQL)를 참조하세요.

설명

REQUEST_MEMORY_GRANT_PERCENT를 사용할 경우 인덱스 생성은 성능 향상을 위해 초기에 부여된 메모리보다 많은 작업 영역 메모리를 사용할 수 있습니다. 이러한 특별 처리는 SQL Server의 리소스 관리자에서 지원됩니다. 그러나 초기 부여 및 추가 메모리 부여는 리소스 풀 및 작업 그룹 설정으로 제한됩니다.

MAX_DOP 제한은 작업별로 설정됩니다. 요청별 또는 쿼리 제한별로 수행되지 않습니다. 즉, 병렬 쿼리 실행 중에 단일 요청은 스케줄러에 할당되는 여러 작업을 생성할 수 있습니다. 자세한 내용은 스레드 및 태스크 아키텍처 가이드를 참조하세요.

MAX_DOP가 사용되고 컴파일할 때 쿼리가 직렬로 표시되면 작업 그룹이나 서버 구성 설정에 관계없이 런타임에서 병렬로 다시 변경할 수 없습니다. MAX_DOP가 구성된 후에는 메모리 압력으로 인해서만 낮아질 수 있습니다. 작업 그룹 재구성은 부여 메모리 큐에서 대기하는 동안 표시되지 않습니다.

분할된 테이블에서 인덱스 생성

정렬되지 않은 분할된 테이블에서 인덱스 생성에 사용되는 메모리는 관련된 파티션 수에 비례합니다. 필요한 총 메모리가 Resource Governor 작업 그룹 설정에서 지정한 쿼리당 제한 REQUEST_MAX_MEMORY_GRANT_PERCENT를 초과하면 이 인덱스 생성이 실행되지 않을 수 있습니다. "default" 작업 그룹에서는 쿼리가 필요한 최소 메모리를 포함하는 쿼리당 제한을 초과하게 되므로 "default" 리소스 풀에 이러한 쿼리를 실행할 수 있는 총 메모리가 구성되어 있는 경우 사용자가 "default" 작업 그룹에서 같은 인덱스 생성을 실행할 수 있습니다.

사용 권한

CONTROL SERVER 권한이 필요합니다.

예제

Resource Governor 기본 설정을 사용하고 리소스 관리자 기본 풀에 있는 newReports라는 작업 그룹을 만듭니다. 예에서는 default 풀을 지정하지만 이 작업을 반드시 수행할 필요는 없습니다.

CREATE WORKLOAD GROUP newReports
WITH
    (REQUEST_MAX_MEMORY_GRANT_PERCENT = 2.5
      , REQUEST_MAX_CPU_TIME_SEC = 100
      , MAX_DOP = 4)
USING "default" ;
GO

참고 항목

• ALTER WORKLOAD GROUP(Transact-SQL)
• DROP WORKLOAD GROUP(Transact-SQL)
• CREATE RESOURCE POOL(Transact-SQL)
• ALTER RESOURCE POOL(Transact-SQL)
• DROP RESOURCE POOL(Transact-SQL)
• ALTER RESOURCE GOVERNOR(Transact-SQL)