쿼리 힌트(Transact-SQL)

아티클
06/12/2024

적용 대상:SQL Server Azure SQL Database Azure SQL Managed Instance

쿼리 힌트는 지정된 힌트가 쿼리 범위에서 사용되도록 지정합니다. 문의 모든 연산자에 영향을 줍니다. 주 쿼리에 포함된 경우 UNION 작업과 관련된 UNION 마지막 쿼리에만 절이 OPTION 있을 수 있습니다. 쿼리 힌트는 OPTION 절의 일부로 지정됩니다. 하나 이상의 쿼리 힌트로 인해 쿼리 최적화 프로그램에서 유효한 계획을 생성할 수 없는 경우 오류 8622가 발생합니다.

주의

SQL Server 쿼리 최적화 프로그램은 일반적으로 쿼리에 대해 최적의 실행 계획을 선택하므로 힌트는 숙련된 개발자나 데이터베이스 관리자가 최후의 수단으로만 사용하는 것이 좋습니다.

적용 대상:

Transact-SQL 구문 표기 규칙

Syntax

<query_hint> ::=
{ { HASH | ORDER } GROUP
  | { CONCAT | HASH | MERGE } UNION
  | { LOOP | MERGE | HASH } JOIN
  | DISABLE_OPTIMIZED_PLAN_FORCING
  | EXPAND VIEWS
  | FAST <integer_value>
  | FORCE ORDER
  | { FORCE | DISABLE } EXTERNALPUSHDOWN
  | { FORCE | DISABLE } SCALEOUTEXECUTION
  | IGNORE_NONCLUSTERED_COLUMNSTORE_INDEX
  | KEEP PLAN
  | KEEPFIXED PLAN
  | MAX_GRANT_PERCENT = <numeric_value>
  | MIN_GRANT_PERCENT = <numeric_value>
  | MAXDOP <integer_value>
  | MAXRECURSION <integer_value>
  | NO_PERFORMANCE_SPOOL
  | OPTIMIZE FOR ( @variable_name { UNKNOWN | = <literal_constant> } [ , ...n ] )
  | OPTIMIZE FOR UNKNOWN
  | PARAMETERIZATION { SIMPLE | FORCED }
  | QUERYTRACEON <integer_value>
  | RECOMPILE
  | ROBUST PLAN
  | USE HINT ( <use_hint_name> [ , ...n ] )
  | USE PLAN N'<xml_plan>'
  | TABLE HINT ( <exposed_object_name> [ , <table_hint> [ [ , ] ...n ] ] )
  | FOR TIMESTAMP AS OF '<point_in_time>'
}

<table_hint> ::=
{ NOEXPAND [ , INDEX ( <index_value> [ , ...n ] ) | INDEX = ( <index_value> ) ]
  | INDEX ( <index_value> [ , ...n ] ) | INDEX = ( <index_value> )
  | FORCESEEK [ ( <index_value> ( <index_column_name> [ , ... ] ) ) ]
  | FORCESCAN
  | HOLDLOCK
  | NOLOCK
  | NOWAIT
  | PAGLOCK
  | READCOMMITTED
  | READCOMMITTEDLOCK
  | READPAST
  | READUNCOMMITTED
  | REPEATABLEREAD
  | ROWLOCK
  | SERIALIZABLE
  | SNAPSHOT
  | SPATIAL_WINDOW_MAX_CELLS = <integer_value>
  | TABLOCK
  | TABLOCKX
  | UPDLOCK
  | XLOCK
}

<use_hint_name> ::=
{ 'ASSUME_JOIN_PREDICATE_DEPENDS_ON_FILTERS'
  | 'ASSUME_MIN_SELECTIVITY_FOR_FILTER_ESTIMATES'
  | 'ASSUME_FULL_INDEPENDENCE_FOR_FILTER_ESTIMATES'
  | 'ASSUME_PARTIAL_CORRELATION_FOR_FILTER_ESTIMATES'
  | 'DISABLE_BATCH_MODE_ADAPTIVE_JOINS'
  | 'DISABLE_BATCH_MODE_MEMORY_GRANT_FEEDBACK'
  | 'DISABLE_DEFERRED_COMPILATION_TV'
  | 'DISABLE_INTERLEAVED_EXECUTION_TVF'
  | 'DISABLE_OPTIMIZED_NESTED_LOOP'
  | 'DISABLE_OPTIMIZER_ROWGOAL'
  | 'DISABLE_PARAMETER_SNIFFING'
  | 'DISABLE_ROW_MODE_MEMORY_GRANT_FEEDBACK'
  | 'DISABLE_TSQL_SCALAR_UDF_INLINING'
  | 'DISALLOW_BATCH_MODE'
  | 'ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS'
  | 'ENABLE_QUERY_OPTIMIZER_HOTFIXES'
  | 'FORCE_DEFAULT_CARDINALITY_ESTIMATION'
  | 'FORCE_LEGACY_CARDINALITY_ESTIMATION'
  | 'QUERY_OPTIMIZER_COMPATIBILITY_LEVEL_n'
  | 'QUERY_PLAN_PROFILE'
}

참고 항목

SQL Server 2014(12.x) 이전 버전의 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조하세요.

인수

{ HASH | ORDER } GROUP

쿼리 GROUP BY 또는 절에서 설명하는 집계가 해시 또는 DISTINCT 순서 지정을 사용하도록 지정합니다.

{ MERGE | HASH | CONCAT } UNION

집합을 병합, 해시 또는 연결하여 모든 UNION 작업을 실행되도록 지정합니다 UNION . 둘 이상의 UNION 힌트를 지정하면 쿼리 최적화 프로그램은 지정된 힌트에서 가장 저렴한 전략을 선택합니다.

{ LOOP | MERGE | HASH } JOIN

모든 조인 MERGE JOINHASH JOIN 작업이 전체 쿼리에서 수행LOOP JOIN되도록 지정합니다. 조인 힌트를 둘 이상 지정한 경우 최적화 프로그램에서는 허용되는 힌트 중 가장 부담이 적은 조인 방법을 선택합니다.

특정 테이블 쌍에 대해 동일한 쿼리 FROM 절에 조인 힌트를 지정하면 이 조인 힌트가 두 테이블의 조인보다 우선합니다. 하지만 쿼리 힌트도 계속 적용되어야 합니다. 테이블 쌍에 대한 조인 힌트는 쿼리 힌트에서 허용되는 조인 방법의 선택만 제한하게 될 수 있습니다. 자세한 내용은 조인 힌트를 참조 하세요.

DISABLE_OPTIMIZED_PLAN_FORCING

적용 대상: SQL Server(SQL Server 2022(16.x)부터)

쿼리에 대해 최적화된 계획 강제 적용을 사용하지 않도록 설정합니다.

최적화된 계획 강제 실행은 강제 쿼리를 반복하기 위한 컴파일 오버헤드를 줄입니다. 쿼리 실행 계획이 생성되면 최적화 재생 스크립트로 다시 사용할 수 있는 특정 컴파일 단계가 저장됩니다. 최적화 재생 스크립트는 쿼리 저장소의 압축된 실행 계획 XML의 일부로 숨겨진 OptimizationReplay 특성에 저장됩니다.

EXPAND VIEWS

인덱싱된 뷰가 확장되도록 지정합니다. 또한 쿼리 최적화 프로그램이 인덱싱된 뷰가 쿼리 파트를 대체하는 것으로 간주하지 않도록 지정합니다. 뷰 정의가 쿼리 텍스트에 있는 뷰 이름을 대체하면 뷰가 확장됩니다.

이 쿼리 힌트는 쿼리 계획에서 인덱싱된 뷰와 인덱싱된 뷰의 인덱스를 직접 사용하도록 허용하지 않습니다.

참고 항목

쿼리 SELECT 부분에 뷰에 대한 직접 참조가 있는 경우 인덱싱된 뷰는 압축된 상태로 유지됩니다. WITH (NOEXPAND) 또는 WITH (NOEXPAND, INDEX( <index_value> [ , *...n* ] ) )를 지정하는 경우에도 뷰가 압축된 상태로 유지됩니다. 쿼리 힌트NOEXPAND에 대한 자세한 내용은 NOEXPAND 사용을 참조하세요.

힌트는 문 부분의 뷰에만 영향을 줍니다. SELECT 여기에는 , UPDATE및 MERGEDELETE 문의 뷰INSERT가 포함됩니다.

FAST integer_value

행의 첫 번째 integer_value 숫자를 빨리 검색하기 위해 쿼리를 최적화하도록 지정합니다. 이 결과는 음수가 아닌 정수입니다. 행의 첫 번째 integer_value 숫자를 반환한 후에 쿼리는 계속 실행하여 전체 결과 집합을 만듭니다.

FORCE ORDER

쿼리 구문에 지정된 조인 순서가 쿼리 최적화 시 유지되도록 지정합니다. 사용 FORCE ORDER 은 쿼리 최적화 프로그램의 가능한 역할 반전 동작에 영향을 주지 않습니다.

참고 항목

MERGE 문에서 원본 테이블은 절을 지정하지 않는 한 WHEN SOURCE NOT MATCHED 대상 테이블 앞에 기본 조인 순서로 액세스됩니다. 지정하면 FORCE ORDER 이 기본 동작이 유지됩니다.

{ FORCE | DISABLE } EXTERNALPUSHDOWN

Hadoop에서 조건에 맞는 식 계산을 강제로 밀어내거나 사용하지 않도록 설정합니다. PolyBase를 사용한 쿼리에만 적용됩니다. Azure Storage로 푸시다운하지 않습니다.

{ FORCE | DISABLE } SCALEOUTEXECUTION

SQL Server 2019 빅 데이터 클러스터에서 외부 테이블을 사용하는 PolyBase 쿼리의 스케일 아웃 실행을 강제 적용하거나 사용하지 않도록 설정합니다. 이 힌트는 SQL 빅 데이터 클러스터의 마스터 인스턴스를 사용하는 쿼리를 통해서만 사용됩니다. 스케일 아웃은 빅 데이터 클러스터의 컴퓨팅 풀에서 발생합니다.

KEEP PLAN

임시 테이블의 다시 컴파일 임계값을 변경하고 영구 테이블의 임계값과 동일하게 만듭니다. 예상 다시 컴파일 임계값은 다음 문 중 하나를 실행하여 테이블에 인덱싱된 열의 예상 변경 횟수가 변경될 때 쿼리에 대한 자동 다시 컴파일을 시작합니다.

UPDATE
DELETE
MERGE
INSERT

지정하면 KEEP PLAN 테이블에 여러 업데이트가 있을 때 쿼리가 자주 다시 컴파일되지 않습니다.

KEEPFIXED PLAN

통계 변경 시에 최적화 프로그램이 쿼리를 다시 컴파일하지 않도록 합니다. 지정하면 KEEPFIXED PLAN 기본 테이블의 스키마가 변경되거나 해당 테이블에 대해 실행되는 경우에만 sp_recompile 쿼리가 다시 컴파일됩니다.

IGNORE_NONCLUSTERED_COLUMNSTORE_INDEX

적용 대상: SQL Server (SQL Server 2012(11.x)부터)

쿼리에 비클러스터형 메모리 액세스에 최적화된 columnstore 인덱스가 사용되지 않도록 방지합니다. 쿼리에 columnstore 인덱스 사용을 방지하기 위한 쿼리 힌트와 columnstore 인덱스를 사용하기 위한 인덱스 힌트가 포함되어 있으면 힌트가 충돌하게 되고 오류가 반환됩니다.

MAX_GRANT_PERCENT = <numeric_value>

적용 대상: SQL Server (SQL Server 2012(11.x) Service Pack 3, SQL Server 2014(12.x) Service Pack 2, Azure SQL 데이터베이스부터 시작).

구성된 메모리 제한의 최대 메모리 부여 크기 PERCENT 입니다. 쿼리가 사용자 정의 리소스 풀에서 실행되는 경우 쿼리가 이 제한을 초과하지 않도록 보장됩니다. 이 경우 쿼리에 필요한 최소 메모리가 없으면 시스템에서 오류가 발생합니다. 쿼리가 시스템 풀에서 실행 중인 경우(기본값) 쿼리는 실행에 요구되는 최소 메모리를 가져옵니다. 리소스 관리자 설정이 이 힌트에 지정된 값보다 낮은 경우 실제 제한을 더 낮게 설정할 수 있습니다. 유효한 값은 0.0에서 100.0 사이의 값입니다.

인덱스 만들기 또는 인덱스 다시 빌드에는 메모리 부여 힌트를 사용할 수 없습니다.

MIN_GRANT_PERCENT = <numeric_value>

적용 대상: SQL Server (SQL Server 2012(11.x) Service Pack 3, SQL Server 2014(12.x) Service Pack 2, Azure SQL 데이터베이스부터 시작).

구성된 메모리 제한의 PERCENT 최소 메모리 부여 크기입니다. 쿼리를 시작하기 위해서는 최소한의 필수 메모리가 필요하기 때문에 이 쿼리는 MAX(required memory, min grant)를 가져오도록 보장됩니다. 유효한 값은 0.0에서 100.0 사이의 값입니다.

min_grant_percent 메모리 부여 옵션은 크기에 관계없이 sp_configure 옵션(쿼리당 최소 메모리(KB))을 재정의합니다. 인덱스 만들기 또는 인덱스 다시 빌드에는 메모리 부여 힌트를 사용할 수 없습니다.

MAXDOP <integer_value>

적용 대상: SQL Server(SQL Server 2008(10.0.x)부터) 및 Azure SQL Database.

sp_configure의 최대 병렬 처리 수준 구성 옵션을 재정의합니다. 또한 이 옵션을 지정하여 쿼리의 Resource Governor를 재정의합니다. 쿼리 힌트는 MAXDOP .으로 sp_configure구성된 값을 초과할 수 있습니다. 리소스 관리자로 구성된 값을 초과하면 MAXDOP 데이터베이스 엔진 ALTER WORKLOAD GROUP에 설명된 리소스 관리자 MAXDOP 값을 사용합니다. 쿼리 힌트를 사용하는 MAXDOP 경우 최대 병렬 처리 수준 구성 옵션과 함께 사용되는 모든 의미 체계 규칙이 적용됩니다. 자세한 내용은 max degree of parallelism 서버 구성 옵션 구성을 참조하세요.

경고

0으로 설정된 경우 MAXDOP 서버는 최대 병렬 처리 수준을 선택합니다.

MAXRECURSION <integer_value>

해당 쿼리에 대해 허용되는 최대 재귀 횟수를 지정합니다. number는 0에서 32,767 사이의 양의 정수 입니다. 0을 지정하면 제한이 적용되지 않습니다. 이 옵션을 지정하지 않은 경우 서버에 대한 기본 한도는 100입니다.

쿼리 실행 중에 제한에 대해 지정된 번호 또는 기본 번호에 MAXRECURSION 도달하면 쿼리가 종료되고 오류가 반환됩니다.

이 오류로 인해 문의 모든 결과가 롤백됩니다. 문이 문인 SELECT 경우 부분 결과 또는 결과가 반환되지 않을 수 있습니다. 반환된 일부 결과에는 지정한 최대 재귀 수준을 초과한 재귀 수준의 모든 행이 포함되지 않을 수 있습니다.

자세한 내용은 WITH common_table_expression 참조하세요.

NO_PERFORMANCE_SPOOL

적용 대상: SQL Server (SQL Server 2016(13.x)부터) 및 Azure SQL Database.

스풀 연산자가 쿼리 계획에 추가되지 않게 합니다(유효한 업데이트 의미 체계를 보증하기 위해 스풀이 필요한 계획 제외). 일부 시나리오에서는 스풀 연산자로 인해 성능이 저하될 수 있습니다. 예를 들어 스풀 연산과 함께 여러 쿼리가 동시에 실행되는 경우 스풀이 사용하는 tempdb 및 tempdb 경합이 발생할 수 있습니다.

OPTIMIZE FOR( @variable_name { UNKNOWN | = <literal_constant> } [ , ...n ] )

쿼리가 컴파일되고 최적화될 때 쿼리 최적화 프로그램이 지역 변수에 대해 특정 값을 사용하도록 지시합니다. 해당 값은 쿼리 최적화 중에만 사용되고 쿼리 실행 중에는 사용되지 않습니다.

@variable_name

쿼리 힌트와 함께 사용할 값을 할당할 수 있는 쿼리에 사용되는 지역 변수의 OPTIMIZE FOR 이름입니다.
UNKNOWN

쿼리 최적화 프로그램이 쿼리 최적화 동안 초기 값 대신 통계 데이터를 사용하여 지역 변수 값을 결정하도록 지정합니다.
literal_constant

쿼리 힌트와 함께 OPTIMIZE FOR 사용할 @variable_name 할당할 리터럴 상수 값입니다. literal_constant는 쿼리 최적화 중에만 사용되며 쿼리 실행 중에는 @variable_name의 값으로 사용되지 않습니다. literal_constant는 리터럴 상수로 표현할 수 있는 모든 SQL Server 시스템 데이터 형식이 될 수 있습니다. literal_constant의 데이터 형식은 쿼리에서 @variable_name이 참조하는 데이터 형식으로 암시적으로 변환될 수 있어야 합니다.

OPTIMIZE FOR는 최적화 프로그램의 기본 매개 변수 검색 동작을 무효로 만들 수 있습니다. 계획 지침을 만들 때도 사용합니다 OPTIMIZE FOR . 자세한 내용은 저장 프로시저 다시 컴파일을 참조하십시오.

OPTIMIZE FOR UNKNOWN

쿼리를 컴파일하고 최적화할 때 런타임 매개 변수 값을 사용하는 대신 모든 열 값에서 조건자의 평균 선택성을 사용하도록 쿼리 최적화 프로그램에서 지시합니다.

동일한 쿼리 힌트에서 OPTIMIZE FOR @variable_name = <literal_constant> 및 OPTIMIZE FOR UNKNOWN을 사용하면 쿼리 최적화 프로그램이 특정 값에 지정된 literal_constant를 사용합니다. 쿼리 최적화 프로그램은 나머지 변수 값에 UNKNOWN을 사용합니다. 해당 값은 쿼리 최적화 중에만 사용되고 쿼리 실행 중에는 사용되지 않습니다.

PARAMETERIZATION { SIMPLE | FORCED }

SQL Server 쿼리 최적화 프로그램이 컴파일할 때 쿼리에 적용되는 매개 변수화 규칙을 지정합니다.

Important

쿼리 힌트는 PARAMETERIZATION 계획 지침 내에서만 지정하여 데이터베이스 SET 옵션의 현재 설정을 재정의할 PARAMETERIZATION 수 있습니다. 쿼리 내에서 직접 지정할 수는 없습니다.

자세한 내용은 계획 지침을 사용하여 쿼리 매개 변수화 동작 지정을 참조하세요.

SIMPLE 는 쿼리 최적화 프로그램에서 간단한 매개 변수화를 시도하도록 지시합니다. FORCED 는 쿼리 최적화 프로그램에서 강제 매개 변수화를 시도하도록 지시합니다. 자세한 내용은 쿼리 처리 아키텍처 가이드에서 강제 매개 변수화 및 쿼리 처리 아키텍처 가이드에서 단순 매개 변수화를 참조하세요.

QUERYTRACEON <integer_value>

이 옵션을 사용하면 단일 쿼리를 컴파일하는 동안 계획에 영향을 주는 추적 플래그만 사용하도록 설정할 수 있습니다. 다른 쿼리 수준 옵션과 마찬가지로 이 옵션을 계획 지침과 함께 사용하여 세션에서 실행되는 쿼리의 텍스트를 대응시키고 이 쿼리가 컴파일되는 동안 계획에 영향을 주는 추적 플래그를 자동으로 적용할 수 있습니다. 이 QUERYTRACEON 옵션은 쿼리 최적화 프로그램 추적 플래그에 대해서만 지원됩니다. 자세한 내용은 추적 플래그를 참조하세요.

지원되지 않는 추적 플래그 번호를 사용하는 경우 이 옵션을 사용하면 오류 또는 경고가 반환되지 않습니다. 지정된 추적 플래그가 쿼리 실행 계획에 영향을 주지 않는 경우에는 이 옵션이 자동으로 무시됩니다.

쿼리에서 둘 이상의 추적 플래그를 사용하려면 각기 다른 추적 플래그 번호에 대해 하나의 QUERYTRACEON 힌트를 지정합니다.

RECOMPILE

새로운 임시 쿼리 계획을 생성하고 쿼리 실행이 완료된 후 해당 계획을 즉시 무시하도록 SQL Server 데이터베이스 엔진에 지시합니다. 생성된 쿼리 계획은 힌트 없이 RECOMPILE 동일한 쿼리가 실행될 때 캐시에 저장된 계획을 대체하지 않습니다. 지정RECOMPILE하지 않고 데이터베이스 엔진 쿼리 계획을 캐시하고 다시 사용합니다. 쿼리 계획이 컴파일되면 쿼리 힌트는 RECOMPILE 쿼리에 있는 모든 지역 변수의 현재 값을 사용합니다. 쿼리가 저장 프로시저 안에 있는 경우 매개 변수에 전달된 현재 값을 사용합니다.

RECOMPILE 는 저장 프로시저를 만드는 데 유용한 대안입니다. RECOMPILE 에서는 WITH RECOMPILE 저장 프로시저 내의 쿼리 하위 집합만 전체 저장 프로시저 대신 다시 컴파일해야 하는 경우 절을 사용합니다. 자세한 내용은 저장 프로시저 다시 컴파일을 참조하십시오. RECOMPILE 은 계획 지침을 만들 때도 유용합니다.

ROBUST PLAN

쿼리 최적화 프로그램에서 성능이 저하되더라도 잠재적 최대 행 크기를 정의할 수 있는 계획을 세우도록 합니다. 쿼리가 처리될 때 중간 테이블 및 연산자가 쿼리 처리 시 입력 행보다 큰 행을 저장하고 처리해야 할 수 있습니다. 행이 너무 커서 특정 연산자가 행을 처리하지 못하는 경우도 있습니다. 행이 큰 경우 데이터베이스 엔진에서는 쿼리 실행 중에 오류를 생성합니다. 이를 사용하여 ROBUST PLAN쿼리 최적화 프로그램에서 이 문제가 발생할 수 있는 쿼리 계획을 고려하지 않도록 지시합니다.

이 계획이 불가능할 경우 쿼리 최적화 프로그램은 쿼리 실행 시 오류를 검색하도록 지연시키지 않고 오류를 반환합니다. 행에는 가변 길이 열이 포함될 수 있으며 데이터베이스 엔진은 데이터베이스 엔진에서 처리할 수 있는 범위 이상의 잠재적 최대 크기를 가진 행을 정의하도록 허용합니다. 그러나 대개 애플리케이션은 데이터베이스 엔진이 처리할 수 있는 한도 내의 실제 크기를 가진 행을 저장합니다. 데이터베이스 엔진에 너무 긴 행이 있으면 실행 오류가 반환됩니다.

USE HINT( 'hint_name' )

적용 대상: SQL Server (SQL Server 2016(13.x) SP1부터) 및 Azure SQL Database.

쿼리 프로세서에 하나 이상의 추가 힌트를 제공합니다. 추가 힌트는 작은따옴표 안에 힌트 이름으로 지정됩니다.

팁

힌트 이름은 대/소문자를 구분하지 않습니다.

지원되는 힌트는 다음과 같습니다.

힌트	설명
`'ASSUME_JOIN_PREDICATE_DEPENDS_ON_FILTERS'`	SQL Server 2014(12.x) 이상 버전의 쿼리 최적화 프로그램 카디 널리티 추정 모델에서 조인에 대한 기본 기본 포함 가정 대신 단순 포함 가정을 사용하여 SQL Server에서 쿼리 계획을 생성합니다. 이 힌트 이름은 추적 플래그 9476과 동일합니다.
`'ASSUME_MIN_SELECTIVITY_FOR_FILTER_ESTIMATES'`	전체 상관 관계를 설명하기 위해 필터에 대한 AND 조건자를 추정할 때 SQL Server에서 최소 선택도를 사용하여 플랜을 생성하도록 합니다. 이 힌트 이름은 SQL Server 2012(11.x) 및 이전 버전의 카디널리티 추정 모델과 함께 사용되는 경우 추적 플래그 4137과 동일하며, 추적 플래그 9471을 SQL Server 2014(12.x) 이상 버전의 카디널리티 추정 모델과 함께 사용할 때도 비슷한 효과가 있습니다.
`'ASSUME_FULL_INDEPENDENCE_FOR_FILTER_ESTIMATES'`	전체 독립성을 설명하기 위해 필터에 대한 AND 조건자를 추정할 때 SQL Server에서 최대 선택도를 사용하여 플랜을 생성하도록 합니다. 이 힌트 이름은 SQL Server 2012(11.x) 및 이전 버전의 카디널리티 추정 모델의 기본 동작이며 SQL Server 2014(12.x) 이상 버전의 카디널리티 추정 모델과 함께 사용되는 경우 추적 플래그 9472와 동일합니다. 적용 대상: Azure SQL Database
`'ASSUME_PARTIAL_CORRELATION_FOR_FILTER_ESTIMATES'`	부분 상관 관계를 설명하기 위해 필터에 대한 AND 조건자를 추정할 때 SQL Server에서 최대부터 최소까지 선택도를 사용하여 플랜을 생성하도록 합니다. 이 힌트 이름은 SQL Server 2014(12.x) 이상 버전의 카디널리티 추정 모델의 기본 동작입니다. 적용 대상: Azure SQL Database
`'DISABLE_BATCH_MODE_ADAPTIVE_JOINS'`	일괄 처리 모드 적응 조인을 사용 하지 않습니다. 자세한 내용은 일괄 처리 모드 적응 조인을 참조하세요. 적용 대상: SQL Server 2017(14.x) 이상 버전 및 Azure SQL Database
`'DISABLE_BATCH_MODE_MEMORY_GRANT_FEEDBACK'`	일괄 처리 모드 메모리 부여 피드백을 사용하지 않습니다. 자세한 내용은 일괄 처리 모드 메모리 부여 피드백을 참조합니다. 적용 대상: SQL Server 2017(14.x) 이상 버전 및 Azure SQL Database
`'DISABLE_DEFERRED_COMPILATION_TV'`	테이블 변수 지연 컴파일을 사용하지 않도록 설정합니다. 자세한 내용은 테이블 변수 지연 컴파일을 참조하세요. 적용 대상: SQL Server 2019(15.x) 이상 버전 및 Azure SQL Database
`'DISABLE_INTERLEAVED_EXECUTION_TVF'`	다중 문 테이블 반환 함수에 대한 인터리브 실행을 사용하지 않도록 설정합니다. 자세한 내용은 다중 명령문 테이블 반환 함수에 대한 인터리브 실행을 참조하세요. 적용 대상: SQL Server 2017(14.x) 이상 버전 및 Azure SQL Database
`'DISABLE_OPTIMIZED_NESTED_LOOP'`	쿼리 프로세서가 쿼리 계획을 생성할 때 최적화된 중첩 루프 조인을 위해 정렬 연산(일괄 처리 정렬)을 사용하지 않도록 지시합니다 이 힌트 이름은 함께 플래그 2340 및 8751을 추적하는 것과 같습니다.
`'DISABLE_OPTIMIZER_ROWGOAL'`	SQL Server가 다음 키워드를 포함하는 쿼리에 행 목표 수정을 사용하지 않는 계획을 생성하게 합니다. - `TOP` - `OPTION (FAST N)` - `IN` - `EXISTS` 이 힌트 이름은 추적 플래그 4138과 동일합니다.
`'DISABLE_PARAMETER_SNIFFING'`	쿼리 최적화 프로그램이 하나 이상의 매개 변수가 있는 쿼리를 컴파일할 때 평균 데이터 분산을 사용하도록 지시합니다. 이 지시를 통해 쿼리 계획에서는 쿼리를 컴파일할 때 처음 사용된 매개 변수 값이 사용되지 않습니다. 이 힌트 이름은 추적 플래그 4136 또는 데이터베이스 범위 구성 설정`PARAMETER_SNIFFING = OFF`과 동일합니다.
`'DISABLE_ROW_MODE_MEMORY_GRANT_FEEDBACK'`	행 모드 메모리 부여 피드백을 비활성화합니다. 자세한 내용은 행 모드 메모리 부여 피드백을 참조하세요. 적용 대상: SQL Server 2019(15.x) 이상 버전 및 Azure SQL Database
`'DISABLE_TSQL_SCALAR_UDF_INLINING'`	스칼라 UDF 인라인을 비활성화합니다. 자세한 내용은 스칼라 UDF 인라인 처리를 참조하세요. 적용 대상: SQL Server 2019(15.x) 이상 버전 및 Azure SQL Database
`'DISALLOW_BATCH_MODE'`	일괄 처리 모드 실행을 사용하지 않도록 설정합니다. 자세한 내용은 실행 모드를 참조하세요. 적용 대상: SQL Server 2019(15.x) 이상 버전 및 Azure SQL Database
`'ENABLE_HIST_AMENDMENT_FOR_ASC_KEYS'`	카디널리티 추정이 필요한 모든 선행 인덱스 열에 대해 자동으로 생성된 빠른 통계(히스토그램 수정)를 사용합니다. 카디널리티를 예측하는 데 사용되는 히스토그램은 쿼리 컴파일 시간에 이 열의 실제 최대값 또는 최소값을 고려하여 조정됩니다. 이 힌트 이름은 추적 플래그 4139와 동일합니다.
`'ENABLE_QUERY_OPTIMIZER_HOTFIXES'`	쿼리 최적화 프로그램 핫픽스(SQL Server 누적 업데이트 및 Service Pack에서 릴리스된 변경 내용)를 사용하도록 설정합니다. 이 힌트 이름은 추적 플래그 4199 또는 데이터베이스 범위 구성 설정`QUERY_OPTIMIZER_HOTFIXES = ON`과 동일합니다.
`'FORCE_DEFAULT_CARDINALITY_ESTIMATION'`	쿼리 최적화 프로그램이 현재 데이터베이스 호환성 수준에 해당하는 카디널리티 추정 모델을 사용하도록 강제 적용합니다. 이 힌트를 사용하여 데이터베이스 범위 구성 설정 `LEGACY_CARDINALITY_ESTIMATION = ON` 또는 추적 플래그 9481을 재정의합니다.
`'FORCE_LEGACY_CARDINALITY_ESTIMATION'`	쿼리 최적화 프로그램이 SQL Server 2012(11.x) 및 이전 버전의 카디널리티 추정 모델을 사용하도록 강제 적용합니다. 이 힌트 이름은 추적 플래그 9481 또는 데이터베이스 범위 구성 설정`LEGACY_CARDINALITY_ESTIMATION = ON`과 동일합니다.
`'QUERY_OPTIMIZER_COMPATIBILITY_LEVEL_n'`¹	쿼리 수준에서 쿼리 최적화 프로그램 동작을 적용합니다. 이 동작은 쿼리가 데이터베이스 호환성 수준 n으로 컴파일된 것처럼 발생합니다. 여기서 n 은 지원되는 데이터베이스 호환성 수준입니다. n에 대해 현재 지원되는 값 목록은 sys.dm_exec_valid_use_hints 참조하세요. 적용 대상: SQL Server 2017 (14.x) CU 10 이상 버전 및 Azure SQL Database
`'QUERY_PLAN_PROFILE'`²	쿼리에 대해 간단한 프로파일링을 사용합니다. 이 새 힌트를 포함하는 쿼리가 완료되면 새 확장 이벤트가 `query_plan_profile`발생합니다. 이 확장 이벤트는 확장 이벤트와 유사 `query_post_execution_showplan` 하지만 새 힌트가 포함된 쿼리에 대해서만 실행 통계 및 실제 실행 계획 XML을 노출합니다. 적용 대상: SQL Server 2016 (13.x) SP 2 CU 3, SQL Server 2017 (14.x) CU 11 이상 버전

¹ 데이터베이스 범위 구성, 추적 플래그 또는 다른 쿼리 힌트(예: QUERYTRACEON)를 통해 강제 적용하는 경우 힌트는 QUERY_OPTIMIZER_COMPATIBILITY_LEVEL_n 기본 또는 레거시 카디널리티 예측 설정을 재정의하지 않습니다. 이 힌트는 쿼리 최적화 프로그램의 동작에만 영향을 줍니다. 특정 데이터베이스 기능의 사용 가능성과 같이, 데이터베이스 호환성 수준에 따라 달라질 수 있는 SQL Server의 다른 기능에는 영향을 주지 않습니다. 자세한 내용은 개발자의 선택: 쿼리 실행 모델 힌트를 참조 하세요.

² 확장 이벤트 수집을 query_post_execution_showplan 사용하도록 설정하면 표준 프로파일링 인프라가 서버에서 실행되는 모든 쿼리에 추가되므로 전체 서버 성능에 영향을 줄 수 있습니다. 확장 이벤트 컬렉션을 query_thread_profile 대신 경량 프로파일링 인프라를 사용하도록 설정하면 성능 오버헤드가 훨씬 줄어들지만 전체 서버 성능에도 영향을 줍니다. 확장 이벤트를 사용하도록 설정하면 서버에서 query_plan_profile 실행되는 query_plan_profile 쿼리에 대한 간단한 프로파일링 인프라만 사용할 수 있으므로 서버의 다른 워크로드에 영향을 주지 않습니다. 이 힌트를 사용하여 서버 워크로드의 다른 부분에 영향을 미치지 않고 특정 쿼리를 프로파일링하세요. 간단한 프로파일링에 대한 자세한 내용은 쿼리 프로파일링 인프라를 참조 하세요.

지원되는 USE HINT 모든 이름 목록은 동적 관리 뷰 sys.dm_exec_valid_use_hints 사용하여 쿼리할 수 있습니다.

Important

일부 USE HINT 힌트는 전역 또는 세션 수준에서 활성화된 추적 플래그 또는 데이터베이스 범위 구성 설정과 충돌할 수 있습니다. 이 경우 쿼리 수준 힌트()가USE HINT 항상 우선합니다. USE HINT 다른 쿼리 힌트와 충돌하거나 쿼리 수준에서 활성화된 추적 플래그(예: QUERYTRACEON)와 충돌하는 경우 SQL Server는 쿼리를 실행하려고 할 때 오류를 생성합니다.

USE PLAN N'xml_plan'

쿼리 최적화 프로그램에서 xml_plan 지정한 쿼리에 대해 기존 쿼리 계획을 사용하도록 합니다. USE PLAN은 , UPDATE, MERGE또는 DELETE 문으로 INSERT지정할 수 없습니다.

이 기능에 의해 강제 적용된 결과 실행 계획은 강제 적용되는 계획과 동일하거나 유사합니다. 결과 계획이 지정 USE PLAN한 계획과 동일하지 않을 수 있으므로 계획의 성능이 달라질 수 있습니다. 드문 경우지만 성능 차이가 상당하고 부정적일 수 있습니다. 이 경우 관리자는 강제 적용된 계획을 제거해야 합니다.

TABLE HINT ( exposed_object_name [ , <table_hint> [ [ , ] ... n ] ] )

지정된 테이블 힌트를 exposed_object_name에 해당하는 테이블 또는 뷰에 적용합니다. 테이블 힌트는 계획 지침의 컨텍스트에서 쿼리 힌트로만 사용하는 것이 좋습니다.

exposed_object_name은 다음 참조 중 하나일 수 있습니다.

쿼리의 FROM 절에서 테이블 또는 뷰에 별칭을 사용하는 경우 exposed_object_name은 해당 별칭입니다.
별칭을 사용하지 않는 경우 exposed_object_name 절에서 참조되는 테이블 또는 뷰와 정확히 일치합니다 FROM . 예를 들어 테이블 또는 뷰가 두 부분으로 된 이름을 사용하여 참조되는 경우 exposed_object_name도 똑같이 두 부분으로 된 이름입니다.

테이블 힌트를 지정하지 않고 exposed_object_name을 지정하면 개체에 대한 테이블 힌트의 일부로 쿼리에서 지정한 인덱스가 모두 무시됩니다. 쿼리 최적화 프로그램에서 인덱스 사용 여부를 결정합니다. 이 기술을 사용하여 원래 쿼리를 수정할 수 없는 경우 테이블 힌트의 INDEX 효과를 제거할 수 있습니다. 예제 J를 참조하세요.

<table_hint>

쿼리 힌트로 exposed_object_name 해당하는 테이블 또는 뷰에 적용할 테이블 힌트입니다. 이러한 힌트에 대한 설명은 테이블 힌트를 참조 하세요.

테이블 힌트가 아닌 INDEXFORCESCAN테이블 힌트이며 FORCESEEK 쿼리에 테이블 힌트를 지정하는 절이 없는 한 쿼리 힌트로 WITH 허용되지 않습니다. 자세한 내용은 주의 섹션을 참조하십시오.

주의

매개 변수를 사용하여 지정하면 FORCESEEK 매개 변수 없이 지정할 때보다 쿼리 최적화 프로그램에서 고려할 수 있는 계획 수가 제한됩니다 FORCESEEK . 이로 인해 "계획을 생성할 수 없음" 오류가 더 많이 발생할 수 있습니다.

FOR TIMESTAMP AS OF 'point_in_time'

적용 대상: Microsoft Fabric 내 Warehouse

Microsoft Fabric의 Synapse Data Warehouse에서 시간 이동 기능의 일부로서 과거에 존재했던 데이터를 쿼리하는 방법은 OPTION 절에서 TIMESTAMP 구문을 사용합니다.

해당 시간에 나타난 데이터를 반환하려면 yyyy-MM-ddTHH:mm:ss[.fff] 형식의 point_in_time을 지정합니다. 표준 시간대는 항상 UTC입니다. 필요한 날짜/시간 형식은 스타일 126으로 CONVERT 구문을 사용합니다.

TIMESTAMP AS OF 힌트는 OPTION 절을 사용하여 한 번만 지정할 수 있습니다. 자세한 내용 및 제한 사항은 과거에 존재했던 데이터 쿼리를 참조하세요.

설명

문 내에서 절을 사용하는 경우를 제외하고는 문에서 INSERT 쿼리 힌트를 SELECT 지정할 수 없습니다.

쿼리 힌트는 하위 쿼리가 아닌 최상위 쿼리에서만 지정할 수 있습니다. 테이블 힌트를 쿼리 힌트로 지정하면 해당 힌트를 최상위 쿼리나 하위 쿼리에 지정할 수 있습니다. 그러나 절의 exposed_object_nameTABLE HINT 대해 지정된 값은 쿼리 또는 하위 쿼리에서 노출된 이름과 정확히 일치해야 합니다.

테이블 힌트를 쿼리 힌트로 지정

계획 지침의 컨텍스트에서INDEX만 쿼리 힌트로 또는 FORCESCANFORCESEEK 테이블 힌트를 사용하는 것이 좋습니다. 계획 지침은 타사 애플리케이션인 경우와 같이 원래 쿼리를 수정할 수 없을 때 유용합니다. 계획 지침에 지정된 쿼리 힌트는 컴파일되고 최적화되기 전에 쿼리에 추가됩니다. 임시 쿼리의 경우 계획 가이드 문을 테스트할 TABLE HINT 때만 절을 사용합니다. 임시 쿼리 이외의 모든 경우 이러한 힌트를 테이블 힌트로만 지정하는 것이 좋습니다.

쿼리 힌트로 지정하면 다음 개체에 INDEX대해 , FORCESCAN및 FORCESEEK 테이블 힌트가 유효합니다.

테이블
보기
인덱싱된 뷰
공통 테이블 식(결과 집합이 공통 테이블 식을 채우는 문에 SELECT 힌트를 지정해야 합니다.)
동적 관리 뷰(DMV)
명명된 하위 쿼리

기존 테이블 힌트가 없는 쿼리에 대한 쿼리 힌트로 테이블 힌트를 지정할 INDEXFORCESCANFORCESEEK 수 있습니다. 쿼리의 기존 INDEX힌트 FORCESCAN또는 FORCESEEK 힌트를 각각 바꾸는 데 사용할 수도 있습니다.

테이블 힌트가 아닌 INDEXFORCESCAN테이블 힌트이며 FORCESEEK 쿼리에 테이블 힌트를 지정하는 절이 없는 한 쿼리 힌트로 WITH 허용되지 않습니다. 이 경우 일치하는 힌트를 쿼리 힌트로 지정해야 합니다. 절에서 사용하여 TABLE HINT 일치하는 힌트를 쿼리 힌트로 지정합니다 OPTION . 이렇게 지정하면 쿼리의 의미 체계가 유지됩니다. 예를 들어 쿼리에 테이블 힌트 NOLOCKOPTION가 포함된 경우 계획 지침의 @hints 매개 변수에 힌트도 포함되어 NOLOCK 야 합니다. 예제 K를 참조하세요.

쿼리 저장소 힌트를 사용하여 힌트 지정

쿼리 저장소 힌트 기능을 사용하여 코드를 변경하지 않고 쿼리 저장소를 통해 식별된 쿼리에서 힌트를 적용할 수 있습니다. sys.sp_query_store_set_hints 저장 프로시저를 사용하여 쿼리에 힌트를 적용합니다. 예제 N을 참조하세요.

예

A. MERGE JOIN 사용

다음 예제에서는 쿼리에서 JOIN 작업을 실행 하는 MERGE JOIN 지정합니다. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다.

SELECT *
FROM Sales.Customer AS c
INNER JOIN Sales.CustomerAddress AS ca ON c.CustomerID = ca.CustomerID
WHERE TerritoryID = 5
OPTION (MERGE JOIN);
GO

B. OPTIMIZE FOR 사용

다음 예에서는 쿼리를 최적화할 때 @city_name의 'Seattle' 값을 사용하고 @postal_code의 모든 열 값에서 조건자의 평균 선택도를 사용하도록 쿼리 최적화 프로그램에 지시합니다. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다.

CREATE PROCEDURE dbo.RetrievePersonAddress
@city_name NVARCHAR(30),
@postal_code NVARCHAR(15)
AS
SELECT * FROM Person.Address
WHERE City = @city_name AND PostalCode = @postal_code
OPTION ( OPTIMIZE FOR (@city_name = 'Seattle', @postal_code UNKNOWN) );
GO

C. MAXRECURSION 사용

MAXRECURSION 는 잘못된 형식의 재귀 공통 테이블 식이 무한 루프에 들어가지 않도록 방지하는 데 사용할 수 있습니다. 다음 예에서는 의도적으로 무한 루프를 만들고 MAXRECURSION 힌트를 사용하여 재귀 수준을 2로 제한하는 방법을 보여 줍니다. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다.

--Creates an infinite loop
WITH cte (CustomerID, PersonID, StoreID) AS
(
    SELECT CustomerID, PersonID, StoreID
    FROM Sales.Customer
    WHERE PersonID IS NOT NULL
  UNION ALL
    SELECT cte.CustomerID, cte.PersonID, cte.StoreID
    FROM cte
    JOIN  Sales.Customer AS e
        ON cte.PersonID = e.CustomerID
)
--Uses MAXRECURSION to limit the recursive levels to 2
SELECT CustomerID, PersonID, StoreID
FROM cte
OPTION (MAXRECURSION 2);
GO

코딩 오류가 수정된 MAXRECURSION 후에는 더 이상 필요하지 않습니다.

D. MERGE UNION 사용

다음 예에서는 MERGE UNION 쿼리 힌트를 사용합니다. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다.

SELECT *
FROM HumanResources.Employee AS e1
UNION
SELECT *
FROM HumanResources.Employee AS e2
OPTION (MERGE UNION);
GO

E. HASH GROUP 및 FAST 사용

다음 예제에서는 및 FAST 쿼리 힌트를 사용합니다HASH GROUP. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다.

SELECT ProductID, OrderQty, SUM(LineTotal) AS Total
FROM Sales.SalesOrderDetail
WHERE UnitPrice < $5.00
GROUP BY ProductID, OrderQty
ORDER BY ProductID, OrderQty
OPTION (HASH GROUP, FAST 10);
GO

F. MAXDOP 사용

다음 예에서는 MAXDOP 쿼리 힌트를 사용합니다. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다.

SELECT ProductID, OrderQty, SUM(LineTotal) AS Total
FROM Sales.SalesOrderDetail
WHERE UnitPrice < $5.00
GROUP BY ProductID, OrderQty
ORDER BY ProductID, OrderQty
OPTION (MAXDOP 2);
GO

G. INDEX 사용

다음 예제에서는 힌트를 INDEX 사용합니다. 첫 번째 예에서는 단일 인덱스를 지정하고, 두 번째 예에서는 단일 테이블 참조에 대해 여러 인덱스를 지정합니다. 두 예제에서 별칭 TABLE HINT 을 사용하는 테이블에 힌트를 적용 INDEX 하기 때문에 절은 노출된 개체 이름과 동일한 별칭도 지정해야 합니다. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다.

EXEC sp_create_plan_guide
    @name = N'Guide1',
    @stmt = N'SELECT c.LastName, c.FirstName, e.Title
              FROM HumanResources.Employee AS e
              JOIN Person.Contact AS c ON e.ContactID = c.ContactID
              WHERE e.ManagerID = 2;',
    @type = N'SQL',
    @module_or_batch = NULL,
    @params = NULL,
    @hints = N'OPTION (TABLE HINT(e, INDEX (IX_Employee_ManagerID)))';
GO
EXEC sp_create_plan_guide
    @name = N'Guide2',
    @stmt = N'SELECT c.LastName, c.FirstName, e.Title
              FROM HumanResources.Employee AS e
              JOIN Person.Contact AS c ON e.ContactID = c.ContactID
              WHERE e.ManagerID = 2;',
    @type = N'SQL',
    @module_or_batch = NULL,
    @params = NULL,
    @hints = N'OPTION (TABLE HINT(e, INDEX(PK_Employee_EmployeeID, IX_Employee_ManagerID)))';
GO

H. FORCESEEK 사용

다음 예제에서는 테이블 힌트를 FORCESEEK 사용합니다. 또한 절은 TABLE HINT 노출된 개체 이름과 동일한 두 부분으로 구성된 이름을 지정해야 합니다. 두 부분으로 구성된 이름을 사용하는 테이블에 힌트를 적용 INDEX 할 때 이름을 지정합니다. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다.

EXEC sp_create_plan_guide
    @name = N'Guide3',
    @stmt = N'SELECT c.LastName, c.FirstName, HumanResources.Employee.Title
              FROM HumanResources.Employee
              JOIN Person.Contact AS c ON HumanResources.Employee.ContactID = c.ContactID
              WHERE HumanResources.Employee.ManagerID = 3
              ORDER BY c.LastName, c.FirstName;',
    @type = N'SQL',
    @module_or_batch = NULL,
    @params = NULL,
    @hints = N'OPTION (TABLE HINT( HumanResources.Employee, FORCESEEK))';
GO

9\. 여러 테이블 힌트 사용

다음 예제에서는 한 테이블에 힌트를 INDEX 적용하고 다른 테이블에 힌트를 FORCESEEK 적용합니다. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다.

EXEC sp_create_plan_guide
    @name = N'Guide4',
    @stmt = N'SELECT e.ManagerID, c.LastName, c.FirstName, e.Title
              FROM HumanResources.Employee AS e
              JOIN Person.Contact AS c ON e.ContactID = c.ContactID
              WHERE e.ManagerID = 3;',
    @type = N'SQL',
    @module_or_batch = NULL,
    @params = NULL,
    @hints = N'OPTION (TABLE HINT (e, INDEX( IX_Employee_ManagerID))
                       , TABLE HINT (c, FORCESEEK))';
GO

J. TABLE HINT를 사용하여 기존 테이블 힌트 재정의

다음 예제에서는 힌트를 사용하는 TABLE HINT 방법을 보여줍니다. 힌트를 지정하지 않고 힌트를 사용하여 쿼리 절에 지정한 테이블 힌트 동작을 FROM 재정 INDEX 의할 수 있습니다. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다.

EXEC sp_create_plan_guide
    @name = N'Guide5',
    @stmt = N'SELECT e.ManagerID, c.LastName, c.FirstName, e.Title
              FROM HumanResources.Employee AS e WITH (INDEX (IX_Employee_ManagerID))
              JOIN Person.Contact AS c ON e.ContactID = c.ContactID
              WHERE e.ManagerID = 3;',
    @type = N'SQL',
    @module_or_batch = NULL,
    @params = NULL,
    @hints = N'OPTION (TABLE HINT(e))';
GO

11. 의미 체계에 영향을 주는 테이블 힌트 지정

다음 예제에서는 쿼리에 의미 체계에 영향을 주는 두 개의 NOLOCK테이블 힌트를 포함하고 있으며 INDEX의미 체계에 영향을 주지 않습니다. 쿼리 NOLOCK 의 의미 체계를 유지하기 위해 계획 지침의 절에 힌트가 OPTIONS 지정됩니다. 힌트와 함께 NOLOCK 문 컴파일 및 FORCESEEK 최적화 중에 쿼리에서 의미 체계에 영향을 주지 INDEX 않는 힌트를 지정하고 힌트를 바 INDEX 꿉니다. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다.

EXEC sp_create_plan_guide
    @name = N'Guide6',
    @stmt = N'SELECT c.LastName, c.FirstName, e.Title
              FROM HumanResources.Employee AS e
                   WITH (NOLOCK, INDEX (PK_Employee_EmployeeID))
              JOIN Person.Contact AS c ON e.ContactID = c.ContactID
              WHERE e.ManagerID = 3;',
    @type = N'SQL',
    @module_or_batch = NULL,
    @params = NULL,
    @hints = N'OPTION (TABLE HINT (e, INDEX(IX_Employee_ManagerID), NOLOCK, FORCESEEK))';
GO

다음 예에서는 최적화 프로그램에서 테이블 힌트에 지정된 인덱스 이외의 인덱스를 선택할 수 있도록 하면서 쿼리의 의미 체계를 유지하는 다른 방법을 보여 줍니다. 절에 힌트 OPTIONS 를 지정하여 NOLOCK 최적화 프로그램이 선택할 수 있도록 합니다. 의미 체계에 영향을 주기 때문에 힌트를 지정합니다. 그런 다음 테이블 참조만 있고 힌트가 없는 INDEX 키워드를 지정 TABLE HINT 합니다. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다.

EXEC sp_create_plan_guide
    @name = N'Guide7',
    @stmt = N'SELECT c.LastName, c.FirstName, e.Title
              FROM HumanResources.Employee AS e
                   WITH (NOLOCK, INDEX (PK_Employee_EmployeeID))
              JOIN Person.Contact AS c ON e.ContactID = c.ContactID
              WHERE e.ManagerID = 2;',
    @type = N'SQL',
    @module_or_batch = NULL,
    @params = NULL,
    @hints = N'OPTION (TABLE HINT (e, NOLOCK))';
GO

12. USE HINT 사용

다음 예제에서는 및 USE HINT 쿼리 힌트를 사용합니다RECOMPILE. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다.

SELECT * FROM Person.Address
WHERE City = 'SEATTLE' AND PostalCode = 98104
OPTION (RECOMPILE, USE HINT ('ASSUME_MIN_SELECTIVITY_FOR_FILTER_ESTIMATES', 'DISABLE_PARAMETER_SNIFFING'));
GO

13. QUERYTRACEON HINT 사용

다음 예제에서는 쿼리 힌트를 QUERYTRACEON 사용합니다. 이 예에서는 AdventureWorks2022 데이터베이스를 사용합니다. 다음 쿼리를 사용하여 특정 쿼리에 대해 추적 플래그 4199로 제어되는 계획에 영향을 주는 모든 핫픽스를 사용하도록 설정할 수 있습니다.

SELECT * FROM Person.Address
WHERE City = 'SEATTLE' AND PostalCode = 98104
OPTION (QUERYTRACEON 4199);

다음 쿼리와 같이 여러 추적 플래그를 사용할 수도 있습니다.

SELECT * FROM Person.Address
WHERE City = 'SEATTLE' AND PostalCode = 98104
OPTION  (QUERYTRACEON 4199, QUERYTRACEON 4137);

14. 쿼리 저장소 힌트 사용

Azure SQL Database의 쿼리 저장소 힌트 기능을 사용하면 애플리케이션 코드를 변경하지 않고도 쿼리 계획을 간편하게 셰이핑할 수 있습니다.

먼저 다음과 같이 쿼리 저장소 카탈로그 뷰에서 이미 실행된 쿼리를 식별합니다.

SELECT q.query_id, qt.query_sql_text
FROM sys.query_store_query_text qt
INNER JOIN sys.query_store_query q ON
    qt.query_text_id = q.query_text_id
WHERE query_sql_text like N'%ORDER BY ListingPrice DESC%'
  AND query_sql_text not like N'%query_store%';
GO

다음 예제에서는 레거시 카디널리티 예측 도구를 적용하는 힌트를 쿼리 저장소에서 식별된 query_id 39에 적용합니다.

EXEC sys.sp_query_store_set_hints @query_id= 39, @query_hints = N'OPTION(USE HINT(''FORCE_LEGACY_CARDINALITY_ESTIMATION''))';

다음 예제에서는 쿼리 저장소 식별된 구성된 메모리 제한의 최대 메모리 부여 크기를 PERCENT 39로 적용하는 query_id 힌트를 적용합니다.

EXEC sys.sp_query_store_set_hints @query_id= 39, @query_hints = N'OPTION(MAX_GRANT_PERCENT=10)';

다음 예제에서는 sql Server 2012(11.x) 쿼리 최적화 프로그램 동작을 포함하여 RECOMPILEMAXDOP 1query_id 39에 여러 쿼리 힌트를 적용합니다.

EXEC sys.sp_query_store_set_hints @query_id= 39,
    @query_hints = N'OPTION(RECOMPILE, MAXDOP 1, USE HINT(''QUERY_OPTIMIZER_COMPATIBILITY_LEVEL_110''))';

15. 특정 시점의 데이터 쿼리

적용 대상: Microsoft Fabric 내 Warehouse

Microsoft Fabric의 Synapse Data Warehouse에서 과거에 존재했던 데이터를 쿼리하려면 OPTION 절에서 TIMESTAMP 구문을 사용합니다. 다음 샘플 쿼리는 2024년 3월 13일 오후 7:39:35.28(UTC)에 표시된 데이터를 반환합니다. 표준 시간대는 항상 UTC입니다.

SELECT OrderDateKey, SUM(SalesAmount) AS TotalSales
FROM FactInternetSales
GROUP BY OrderDateKey
ORDER BY OrderDateKey
OPTION (FOR TIMESTAMP AS OF '2024-03-13T19:39:35.28');--March 13, 2024 at 7:39:35.28 PM UTC

다음을 통해 공유

쿼리 힌트(Transact-SQL)

Syntax

인수

{ HASH | ORDER } GROUP

{ MERGE | HASH | CONCAT } UNION

{ LOOP | MERGE | HASH } JOIN

DISABLE_OPTIMIZED_PLAN_FORCING

EXPAND VIEWS

FAST integer_value

FORCE ORDER

{ FORCE | DISABLE } EXTERNALPUSHDOWN

{ FORCE | DISABLE } SCALEOUTEXECUTION

KEEP PLAN

KEEPFIXED PLAN

IGNORE_NONCLUSTERED_COLUMNSTORE_INDEX

MAX_GRANT_PERCENT = <numeric_value>

MIN_GRANT_PERCENT = <numeric_value>

MAXDOP <integer_value>

MAXRECURSION <integer_value>

NO_PERFORMANCE_SPOOL

OPTIMIZE FOR( @variable_name { UNKNOWN | = <literal_constant> } [ , ...n ] )

OPTIMIZE FOR UNKNOWN

PARAMETERIZATION { SIMPLE | FORCED }

QUERYTRACEON <integer_value>

RECOMPILE

ROBUST PLAN

USE HINT( 'hint_name' )

USE PLAN N'xml_plan'

TABLE HINT ( exposed_object_name [ , <table_hint> [ [ , ] ... n ] ] )

FOR TIMESTAMP AS OF 'point_in_time'

설명

테이블 힌트를 쿼리 힌트로 지정

쿼리 저장소 힌트를 사용하여 힌트 지정

예

A. MERGE JOIN 사용

B. OPTIMIZE FOR 사용

C. MAXRECURSION 사용

D. MERGE UNION 사용

E. HASH GROUP 및 FAST 사용

F. MAXDOP 사용

G. INDEX 사용

H. FORCESEEK 사용

9\. 여러 테이블 힌트 사용

J. TABLE HINT를 사용하여 기존 테이블 힌트 재정의

11. 의미 체계에 영향을 주는 테이블 힌트 지정

12. USE HINT 사용

13. QUERYTRACEON HINT 사용

14. 쿼리 저장소 힌트 사용

15. 특정 시점의 데이터 쿼리

관련 콘텐츠

피드백

피드백

추가 리소스