sys.fn_validate_plan_guide(Transact-SQL)

지정된 계획 지침의 유효성을 확인할 수 있습니다. sys.fn_validate_plan_guide 함수는 계획 지침이 쿼리에 적용될 때 발생하는 첫 번째 오류 메시지를 반환합니다. 계획 지침이 유효하면 빈 행 집합이 반환됩니다. 데이터베이스의 물리적 디자인을 변경한 후에 계획 지침이 잘못될 수 있습니다. 예를 들어 계획 지침이 특정 인스턴스를 지정한 이후 해당 인스턴스가 삭제되면 쿼리가 더 이상 계획 지침을 사용할 수 없습니다.

계획 지침을 확인하여 최적화 프로그램이 수정하지 않고 해당 계획을 사용할 수 있는지 확인할 수 있습니다. 작동 결과에 따라 계획 지침을 삭제할지 결정하고 쿼리를 반환하거나 데이터베이스 디자인을 수정할 수 있습니다. 예를 들어 계획 지침에 지정된 인덱스를 다시 만들어서 이 작업을 수행할 수 있습니다.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙

구문

sys.fn_validate_plan_guide ( plan_guide_id )

인수

  • plan_guide_id
    sys.plan_guides 카탈로그 뷰에서 보고되는 계획 지침의 ID입니다. plan_guide_id는 int이며 기본값은 없습니다.

반환된 테이블

열 이름

데이터 형식

설명

msgnum

int

오류 메시지 ID입니다.

severity

tinyint

1에서 25 사이의 메시지 심각도입니다.

state

smallint

오류가 발생한 코드의 지점을 나타내는 오류의 상태 번호입니다.

message

nvarchar(2048)

오류의 메시지 텍스트입니다.

사용 권한

OBJECT 범위 계획 지침에는 참조된 개체에 대한 VIEW DEFINITION 또는 ALTER 권한이 필요하고 계획 지침에 제공된 쿼리나 일괄 처리에 대한 권한이 필요합니다. 예를 들어 일괄 처리에 SELECT 문이 있으면 참조 개체의 SELECT 권한이 필요합니다.

SQL 범위 또는 TEMPLATE 범위의 계획 지침에는 데이터베이스에 대한 ALTER 권한과 계획 지침에 제공된 쿼리나 일괄 배치를 컴파일할 수 있는 권한이 필요합니다. 예를 들어 일괄 처리에 SELECT 문이 있으면 참조 개체의 SELECT 권한이 필요합니다.

1.데이터베이스에 있는 모든 계획 지침 확인

다음 예에서는 현재 데이터베이스에 있는 모든 계획 지침의 유효성을 확인합니다. 빈 결과 집합이 반환되면 모든 계획 지침을 사용할 수 있습니다.

USE AdventureWorks2012;
GO
SELECT plan_guide_id, msgnum, severity, state, message
FROM sys.plan_guides
CROSS APPLY fn_validate_plan_guide(plan_guide_id);
GO

2.데이터베이스를 변경하기 전에 계획 지침 유효성 테스트

다음 예에서는 명시적 트랜잭션을 사용하여 인덱스를 삭제합니다. sys.fn_validate_plan_guide 함수가 실행되어 이 동작이 데이터베이스의 계획 지침을 무효화시키는지 여부를 확인합니다. 함수의 결과에 따라 DROP INDEX 문이 커밋되거나 트랜잭션이 롤백되고 인덱스가 삭제되지 않습니다.

USE AdventureWorks2012;
GO
BEGIN TRANSACTION;
DROP INDEX IX_SalesOrderHeader_CustomerID ON Sales.SalesOrderHeader;
-- Check for invalid plan guides.
IF EXISTS (SELECT plan_guide_id, msgnum, severity, state, message
           FROM sys.plan_guides
           CROSS APPLY sys.fn_validate_plan_guide(plan_guide_id))
    ROLLBACK TRANSACTION;
ELSE
    COMMIT TRANSACTION;
GO

참고 항목

참조

sp_create_plan_guide(Transact-SQL)

sp_create_plan_guide_from_handle(Transact-SQL)

개념

계획 지침