다음을 통해 공유


ALTER WORKLOAD GROUP(Transact-SQL)

제품 선택

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

* SQL Server *  

 

SQL Server 및 SQL Managed Instance

기존 리소스 관리자 작업 그룹 구성을 변경하고 선택적으로 리소스 관리자 리소스 풀에 할당합니다.

참고 항목

Azure SQL Managed Instance의 경우 Resource Governor 구성을 변경하려면 데이터베이스 컨텍스트 master 에 있어야 합니다.

Transact-SQL 구문 표기 규칙.

구문

ALTER WORKLOAD GROUP { group_name | "default" }
[ 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" } ]
[ ; ]

인수

group_name | "default"

기존의 사용자 정의 작업 그룹 또는 Resource Governor 기본 작업 그룹의 이름입니다. SQL Server가 설치되면 리소스 관리자가 "default" 그룹과 내부 그룹을 만듭니다.

“default” 옵션은 시스템 예약어인 DEFAULT와의 충돌을 피하기 위해 ALTER WORKLOAD GROUP과 함께 사용될 경우 따옴표("") 또는 대괄호([])로 묶어야 합니다. 자세한 내용은 Database Identifiers을 참조하세요.

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

IMPORTANCE = { LOW | MEDIUM | HIGH }

작업 그룹에 있는 요청의 상대적 중요도를 지정합니다. 중요도는 다음 값 중 하나입니다.

  • LOW
  • MEDIUM(기본값)
  • HIGH

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

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

REQUEST_MAX_MEMORY_GRANT_PERCENT = value

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

값은 SQL Server 2017(14.x)까지의 int이며 허용되는 범위는 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는 양의 정수여야 합니다. value의 기본 설정인 0은 쿼리 비용에 따른 내부 계산을 사용하여 최대 시간을 결정합니다.

MAX_DOP = value

병렬 요청의 최대 DOP(병렬 처리 수준)를 지정합니다. value는 0 또는 1~255 범위의 양의 정수여야 합니다. value가 0이면 서버는 최대 병렬 처리 수준을 선택합니다. 이 값은 기본값이며 권장 설정입니다.

데이터베이스 엔진에서 MAX_DOP에 설정하는 실제 값은 지정된 값보다 작을 수 있습니다. 최종 값은 min(255, CPU 수) 수식에 의해 결정됩니다 .

주의

MAX_DOP를 변경하면 서버 성능이 저하될 수 있습니다. MAX_DOP를 변경해야 할 경우에는 단일 NUMA 노드에 있는 하드웨어 스케줄러의 최대 수보다 작거나 같은 값으로 설정하는 것이 좋습니다. MAX_DOP를 8보다 큰 값으로 설정하면 성능에 영향을 줄 수 있습니다.

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

GROUP_MAX_REQUESTS = value

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

USING { pool_name | "default" }

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

“default” 옵션은 대/소문자를 구분하며, 시스템 예약어인 DEFAULT와의 충돌을 피하기 위해 ALTER WORKLOAD GROUP과 함께 사용될 경우 따옴표("") 또는 대괄호([])로 묶어야 합니다. 자세한 내용은 Database Identifiers을 참조하세요.

설명

ALTER WORKLOAD GROUP이 기본 그룹에서 허용됩니다.

작업 그룹 구성의 변경 내용은 ALTER RESOURCE GOVERNOR RECONFIGURE가 실행된 후에 적용됩니다. 설정에 영향을 주는 계획을 변경할 경우 새 설정은 DBCC FREEPROCCACHE (*pool_name*) 실행 후 이전에 캐시된 계획에서 적용됩니다. 여기서 pool_name은 작업 그룹이 연결된 Resource Governor 리소스 풀의 이름입니다.

  • MAX_DOP를 1로 변경하면, 병렬 계획이 직렬 모드에서 실행될 수 있으므로 DBCC FREEPROCCACHE를 실행하지 않아도 됩니다. 그러나 직렬 계획으로 컴파일된 계획만큼 효율적이지 않을 수 있습니다.

  • MAX_DOP를 1에서 0 또는 1보다 큰 값으로 변경하는 경우 DBCC FREEPROCCACHE를 실행하지 않아도 됩니다. 그러나 직렬 계획이 병렬로 실행될 수 없으므로 해당 캐시의 제거로 새 계획이 잠재적으로 병렬 처리를 사용하여 컴파일될 수 있습니다.

주의

하나 이상의 작업 그룹에 연결된 리소스 풀에서 캐시된 계획을 삭제하면 pool_name에 의해 식별된 사용자 정의 리소스 풀과 함께 모든 작업 그룹에 영향을 미칩니다.

DDL 문을 실행할 경우 Resource Governor 상태에 대해 잘 알고 있어야 합니다. 자세한 내용은 Resource Governor를 참조하세요.

REQUEST_MEMORY_GRANT_PERCENT: SQL Server 2005(9.x)에서는 인덱스를 만들 때 향상된 성능을 위해 처음에 부여된 메모리보다 많은 작업 영역 메모리를 사용할 수 있습니다. 이 특수 처리는 이후 버전의 리소스 관리자에서 지원되지만 초기 부여 및 추가 메모리 부여는 리소스 풀 및 작업 그룹 설정에 따라 제한됩니다.

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

정렬되지 않은 분할된 테이블에서 인덱스 생성에 사용되는 메모리는 관련된 파티션 수에 비례합니다. 필요한 총 메모리가 Resource Governor 작업 그룹 설정에서 지정한 쿼리당 제한(REQUEST_MAX_MEMORY_GRANT_PERCENT)을 초과하면 이 인덱스 생성이 실행되지 않을 수 있습니다. “기본” 워크로드 그룹에서는 쿼리가 SQL Server 2005(9.x) 호환성을 유지하며 시작하는 데 필요한 최소 메모리에 대한 쿼리당 제한을 초과할 수 있으므로 “기본” 리소스 풀에 이러한 쿼리를 실행할 수 있는 총 메모리가 충분히 구성되어 있는 경우 사용자가 “기본” 워크로드 그룹에서 동일한 인덱스 생성을 실행할 수 있습니다.

사용 권한

CONTROL SERVER 권한이 필요합니다.

다음 예에서는 기본 그룹에 있는 요청의 중요도를 MEDIUM에서 LOW로 변경하는 방법을 보여 줍니다.

ALTER WORKLOAD GROUP "default"
WITH (IMPORTANCE = LOW);
GO
ALTER RESOURCE GOVERNOR RECONFIGURE;
GO

다음 예에서는 작업 그룹을 현재 속해 있는 풀에서 기본 풀로 이동하는 방법을 보여 줍니다.

ALTER WORKLOAD GROUP adHoc
USING [default];
GO
ALTER RESOURCE GOVERNOR RECONFIGURE;
GO

참고 항목

* SQL Managed Instance *  

 

SQL Server 및 SQL Managed Instance

기존 리소스 관리자 작업 그룹 구성을 변경하고 선택적으로 리소스 관리자 리소스 풀에 할당합니다.

참고 항목

Azure SQL Managed Instance의 경우 Resource Governor 구성을 변경하려면 데이터베이스 컨텍스트 master 에 있어야 합니다.

Transact-SQL 구문 표기 규칙.

구문

ALTER WORKLOAD GROUP { group_name | "default" }
[ 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" } ]
[ ; ]

인수

group_name | "default"

기존의 사용자 정의 작업 그룹 또는 Resource Governor 기본 작업 그룹의 이름입니다. SQL Server가 설치되면 리소스 관리자가 "default" 그룹과 내부 그룹을 만듭니다.

“default” 옵션은 시스템 예약어인 DEFAULT와의 충돌을 피하기 위해 ALTER WORKLOAD GROUP과 함께 사용될 경우 따옴표("") 또는 대괄호([])로 묶어야 합니다. 자세한 내용은 Database Identifiers을 참조하세요.

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

IMPORTANCE = { LOW | MEDIUM | HIGH }

작업 그룹에 있는 요청의 상대적 중요도를 지정합니다. 중요도는 다음 값 중 하나입니다.

  • LOW
  • MEDIUM(기본값)
  • HIGH

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

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

REQUEST_MAX_MEMORY_GRANT_PERCENT = value

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

값은 SQL Server 2017(14.x)까지의 int이며 허용되는 범위는 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는 양의 정수여야 합니다. value의 기본 설정인 0은 쿼리 비용에 따른 내부 계산을 사용하여 최대 시간을 결정합니다.

MAX_DOP = value

병렬 요청의 최대 DOP(병렬 처리 수준)를 지정합니다. value는 0 또는 1~255 범위의 양의 정수여야 합니다. value가 0이면 서버는 최대 병렬 처리 수준을 선택합니다. 이 값은 기본값이며 권장 설정입니다.

데이터베이스 엔진에서 MAX_DOP에 설정하는 실제 값은 지정된 값보다 작을 수 있습니다. 최종 값은 min(255, CPU 수) 수식에 의해 결정됩니다 .

주의

MAX_DOP를 변경하면 서버 성능이 저하될 수 있습니다. MAX_DOP를 변경해야 할 경우에는 단일 NUMA 노드에 있는 하드웨어 스케줄러의 최대 수보다 작거나 같은 값으로 설정하는 것이 좋습니다. MAX_DOP를 8보다 큰 값으로 설정하면 성능에 영향을 줄 수 있습니다.

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

GROUP_MAX_REQUESTS = value

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

USING { pool_name | "default" }

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

“default” 옵션은 대/소문자를 구분하며, 시스템 예약어인 DEFAULT와의 충돌을 피하기 위해 ALTER WORKLOAD GROUP과 함께 사용될 경우 따옴표("") 또는 대괄호([])로 묶어야 합니다. 자세한 내용은 Database Identifiers을 참조하세요.

설명

ALTER WORKLOAD GROUP이 기본 그룹에서 허용됩니다.

작업 그룹 구성의 변경 내용은 ALTER RESOURCE GOVERNOR RECONFIGURE가 실행된 후에 적용됩니다. 설정에 영향을 주는 계획을 변경할 경우 새 설정은 DBCC FREEPROCCACHE (*pool_name*) 실행 후 이전에 캐시된 계획에서 적용됩니다. 여기서 pool_name은 작업 그룹이 연결된 Resource Governor 리소스 풀의 이름입니다.

  • MAX_DOP를 1로 변경하면, 병렬 계획이 직렬 모드에서 실행될 수 있으므로 DBCC FREEPROCCACHE를 실행하지 않아도 됩니다. 그러나 직렬 계획으로 컴파일된 계획만큼 효율적이지 않을 수 있습니다.

  • MAX_DOP를 1에서 0 또는 1보다 큰 값으로 변경하는 경우 DBCC FREEPROCCACHE를 실행하지 않아도 됩니다. 그러나 직렬 계획이 병렬로 실행될 수 없으므로 해당 캐시의 제거로 새 계획이 잠재적으로 병렬 처리를 사용하여 컴파일될 수 있습니다.

주의

하나 이상의 작업 그룹에 연결된 리소스 풀에서 캐시된 계획을 삭제하면 pool_name에 의해 식별된 사용자 정의 리소스 풀과 함께 모든 작업 그룹에 영향을 미칩니다.

DDL 문을 실행할 경우 Resource Governor 상태에 대해 잘 알고 있어야 합니다. 자세한 내용은 Resource Governor를 참조하세요.

REQUEST_MEMORY_GRANT_PERCENT: SQL Server 2005(9.x)에서는 인덱스를 만들 때 향상된 성능을 위해 처음에 부여된 메모리보다 많은 작업 영역 메모리를 사용할 수 있습니다. 이 특수 처리는 이후 버전의 리소스 관리자에서 지원되지만 초기 부여 및 추가 메모리 부여는 리소스 풀 및 작업 그룹 설정에 따라 제한됩니다.

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

정렬되지 않은 분할된 테이블에서 인덱스 생성에 사용되는 메모리는 관련된 파티션 수에 비례합니다. 필요한 총 메모리가 Resource Governor 작업 그룹 설정에서 지정한 쿼리당 제한(REQUEST_MAX_MEMORY_GRANT_PERCENT)을 초과하면 이 인덱스 생성이 실행되지 않을 수 있습니다. “기본” 워크로드 그룹에서는 쿼리가 SQL Server 2005(9.x) 호환성을 유지하며 시작하는 데 필요한 최소 메모리에 대한 쿼리당 제한을 초과할 수 있으므로 “기본” 리소스 풀에 이러한 쿼리를 실행할 수 있는 총 메모리가 충분히 구성되어 있는 경우 사용자가 “기본” 워크로드 그룹에서 동일한 인덱스 생성을 실행할 수 있습니다.

사용 권한

CONTROL SERVER 권한이 필요합니다.

다음 예에서는 기본 그룹에 있는 요청의 중요도를 MEDIUM에서 LOW로 변경하는 방법을 보여 줍니다.

ALTER WORKLOAD GROUP "default"
WITH (IMPORTANCE = LOW);
GO
ALTER RESOURCE GOVERNOR RECONFIGURE;
GO

다음 예에서는 작업 그룹을 현재 속해 있는 풀에서 기본 풀로 이동하는 방법을 보여 줍니다.

ALTER WORKLOAD GROUP adHoc
USING [default];
GO
ALTER RESOURCE GOVERNOR RECONFIGURE;
GO

참고 항목

* Azure Synapse
Analytics *
 

 

Azure Synapse Analytics

기존 작업 그룹을 변경합니다.

실행 중이거나 대기 중인 요청이 있는 시스템에서 ALTER WORKLOAD GROUP이 동작하는 방법에 대한 자세한 내용은 아래의 ALTER WORKLOAD GROUP 동작 섹션을 참조하세요.

작업 그룹 만들기에 대한 제한 사항은 ALTER WORKLOAD GROUP에도 적용됩니다. 매개 변수를 수정하기 전에 workload_management_workload_groups를 쿼리하여 값이 허용 범위 내에 있는지 확인합니다.

구문

ALTER WORKLOAD GROUP group_name
WITH
([ MIN_PERCENTAGE_RESOURCE = value ]
  [ [ , ] CAP_PERCENTAGE_RESOURCE = value ]
  [ [ , ] REQUEST_MIN_RESOURCE_GRANT_PERCENT = value ]
  [ [ , ] REQUEST_MAX_RESOURCE_GRANT_PERCENT = value ]
  [ [ , ] IMPORTANCE = { LOW | BELOW_NORMAL | NORMAL | ABOVE_NORMAL | HIGH }]
  [ [ , ] QUERY_EXECUTION_TIMEOUT_SEC = value ] )
  [ ; ]

인수

group_name

변경되는 기존 사용자 정의 작업 그룹의 이름입니다. group_name은 변경할 수 없습니다.

MIN_PERCENTAGE_RESOURCE = value

value는 0에서 100 사이의 정수 범위입니다. MIN_PERCENTAGE_RESOURCE를 변경하는 경우 모든 작업 그룹의 MIN_PERCENTAGE_RESOURCE 합계는 100을 초과할 수 없습니다. MIN_PERCENTAGE_RESOURCE를 변경하려면 명령이 완료되기 전에 실행 중인 모든 쿼리가 작업 그룹에서 완료되어야 합니다. 자세한 내용은 이 문서의 ALTER WORKLOAD GROUP 동작 섹션을 참조하세요.

CAP_PERCENTAGE_RESOURCE = value

value는 1에서 100 사이의 정수 범위입니다. CAP_PERCENTAGE_RESOURCE 값은 MIN_PERCENTAGE_RESOURCE보다 커야 합니다. CAP_PERCENTAGE_RESOURCE를 변경하려면 명령이 완료되기 전에 실행 중인 모든 쿼리가 작업 그룹에서 완료되어야 합니다. 자세한 내용은 이 문서의 ALTER WORKLOAD GROUP 동작 섹션을 참조하세요.

REQUEST_MIN_RESOURCE_GRANT_PERCENT = value

value는 0.75에서 100.00 사이의 범위에 해당하는 10진수입니다. REQUEST_MIN_RESOURCE_GRANT_PERCENT 값은 MIN_PERCENTAGE_RESOURCE의 요소여야 하며, CAP_PERCENTAGE_RESOURCE보다 작아야 합니다.

REQUEST_MAX_RESOURCE_GRANT_PERCENT = value

value는 10진수이며 REQUEST_MIN_RESOURCE_GRANT_PERCENT보다 커야 합니다.

IMPORTANCE = { LOW | BELOW_NORMAL | NORMAL | ABOVE_NORMAL | HIGH }

워크로드 그룹에 대한 요청의 기본 중요도를 변경합니다.

QUERY_EXECUTION_TIMEOUT_SEC = value

쿼리가 취소되기 전에 실행될 수 있는 최대 시간(초)을 변경합니다. value는 0 또는 양의 정수여야 합니다. value의 기본 설정인 0은 무제한을 의미합니다.

사용 권한

CONTROL DATABASE 권한이 필요합니다.

예제

아래 예제에서는 wgDataLoads라는 작업 그룹에 대한 카탈로그 뷰의 값을 확인하고, 값을 변경합니다.

SELECT *
FROM sys.workload_management_workload_groups
WHERE [name] = 'wgDataLoads'

ALTER WORKLOAD GROUP wgDataLoads WITH
( MIN_PERCENTAGE_RESOURCE            = 40
, CAP_PERCENTAGE_RESOURCE            = 80
, REQUEST_MIN_RESOURCE_GRANT_PERCENT = 10 )

ALTER WORKLOAD GROUP 동작

어느 시점에나 시스템에는 다음 세 가지 형식의 요청이 있습니다.

  • 아직 분류되지 않은 요청
  • 개체 잠금이나 시스템 리소스에 대해 분류되고 대기 중인 요청
  • 분류되고 실행 중인 요청

변경 중인 작업 그룹의 속성을 기반으로 설정이 적용되는 타이밍은 다릅니다.

중요도 또는 query_execution_timeout

중요도 및 query_execution_timeout 속성의 경우 분류되지 않은 요청은 새 구성 값을 선택합니다. 대기 및 실행 중인 요청은 이전 구성으로 실행됩니다. 작업 그룹에서 실행 중인 쿼리가 있는지에 관계없이 ALTER WORKLOAD GROUP 요청이 즉시 실행됩니다.

REQUEST_MIN_RESOURCE_GRANT_PERCENT 또는 REQUEST_MAX_RESOURCE_GRANT_PERCENT

REQUEST_MIN_RESOURCE_GRANT_PERCENT 및 REQUEST_MAX_RESOURCE_GRANT_PERCENT의 경우 실행 중인 요청은 이전 구성으로 실행됩니다. 대기 중인 요청 및 분류되지 않은 요청은 새 구성 값을 선택합니다. 작업 그룹에서 실행 중인 쿼리가 있는지에 관계없이 ALTER WORKLOAD GROUP 요청이 즉시 실행됩니다.

MIN_PERCENTAGE_RESOURCE 또는 CAP_PERCENTAGE_RESOURCE

MIN_PERCENTAGE_RESOURCE 및 CAP_PERCENTAGE_RESOURCE의 경우 실행 중인 요청은 이전 구성으로 실행됩니다. 대기 중인 요청 및 분류되지 않은 요청은 새 구성 값을 선택합니다.

MIN_PERCENTAGE_RESOURCE 및 CAP_PERCENTAGE_RESOURCE를 변경하려면 변경 중인 작업 그룹에서 실행 중인 요청을 드레이닝해야 합니다. MIN_PERCENTAGE_RESOURCE를 줄이면 다른 작업 그룹의 요청에서 활용할 수 있도록 해제된 리소스가 공유 풀로 반환됩니다. 반대로 MIN_PERCENTAGE_RESOURCE를 늘리면 공유 풀에서 필요한 리소스만 활용하여 요청이 완료될 때까지 대기합니다. ALTER WORKLOAD GROUP 작업은 공유 풀에서 실행 대기 중인 다른 요청보다 공유 리소스에 대한 액세스에 우선 순위를 지정합니다. MIN_PERCENTAGE_RESOURCE 합계가 100%를 초과하면 ALTER WORKLOAD GROUP 요청이 즉시 실패합니다.

잠금 동작

작업 그룹을 변경하려면 모든 작업 그룹에 대해 전역 잠금이 필요합니다. 작업 그룹 변경 요청은 큐에서 이미 제출된 작업 그룹 요청 만들기 또는 삭제 요청 뒤에 위치합니다. 변경 문의 일괄 처리가 한 번에 제출되는 경우 전송된 순서대로 처리됩니다.

참고 항목