创建新的计划指南

项目
08/30/2023

适用范围：SQL Server Azure SQL 数据库 Azure SQL 托管实例

计划指南通过将查询提示或现有查询计划附加到查询来影响查询优化。在计划指南中，需要指定要优化的语句以及包含要使用的查询提示的 OPTION 子句。或要用于优化查询的特定查询计划。当查询执行时，查询优化器会将相应 Transact-SQL 语句与计划指南进行匹配，然后在运行时将此 OPTION 子句附加到查询，或使用指定的查询计划。

计划指南将固定查询计划和/或查询提示应用于查询。

限制和局限

sp_create_plan_guide 的参数必须以显示的顺序提供。为 sp_create_plan_guide的参数提供值时，必须显式指定所有的参数名称，或全部都不指定。例如，如果指定了 @name =，则也必须指定 @stmt =、@type = 等。同样，如果省略了 @name = 并仅提供了参数值，则也必须省略其余的参数名称并仅提供它们的值。参数名称仅用于说明，以帮助了解语法。 SQL Server 不会验证指定的参数名称是否与使用此名称的位置中的参数名称相匹配。
您可以为相同的查询和批处理或模块创建多个 OBJECT 或 SQL 计划指南。但是，在任何给定的时间只能启用一个计划指南。
无法为引用存储过程、函数或 DML 触发器（指定了 WITH ENCRYPTION 子句或为临时触发器）的 @module_or_batch 值创建 OBJECT 类型的计划指南。
如果尝试删除或修改的函数、存储过程或 DML 触发器由某个计划指南引用，则不管该指南为启用状态还是禁用状态，都会导致错误。尝试删除计划指南被引用并已为其定义触发器的表也将导致错误。

权限

若要创建类型为 OBJECT 的计划指南，需要拥有对被引用对象的 ALTER 权限。若要创建类型为 SQL 或 TEMPLATE 的计划指南，需要拥有对当前数据库的 ALTER 权限。

使用 SSMS 创建计划指南

单击加号以便展开您要在其中创建计划指南的数据库，然后单击加号以便展开 “可编程性” 文件夹。
右键单击“计划指南”文件夹，然后选择“新建计划指南…”。
在 “新建计划指南” 对话框的 “名称” 框中，输入计划指南的名称。
在语句框中，输入要对其应用计划指南的 Transact-SQL 语句。
在“作用域类型”列表中，选择 Transact-SQL 语句在其中出现的实体的类型。这便指定了用于将 Transact-SQL 语句与计划指南匹配的上下文。可能的值为 OBJECT、 SQL和 TEMPLATE。
在作用域批处理框中，输入 Transact-SQL 语句在其中出现的批处理文本。批处理文本不能包括 USEdatabase 语句。只有在 SQL 选择为作用域类型时， “作用域批处理” 框才可用。如果在 SQL 为作用域类型时在“作用域批处理”框中未输入任何内容，则将批处理文本的值设置为与 “语句” 框中相同的值。
在 “作用域批处理” 列表中，输入其中包含该对象的架构的名称。只有在 “对象” 选择为作用域类型时， “作用域架构名称” 框才可用。
在作用域对象名称框中，输入 Transact-SQL 存储过程的名称、用户定义的标量函数的名称、多语句表值函数的名称或其中出现 Transact-SQL 语句的 DML 触发器的名称。只有在 “对象” 选择为作用域类型时， “作用域对象名称” 框才可用。
在参数框中，输入 Transact-SQL 语句中嵌入的所有参数的参数名称和数据类型。

只有当下列任意一个条件为真时才会应用参数：
- 作用域类型为 SQL 或 TEMPLATE。如果为 TEMPLATE，则参数不能为 NULL。
- Transact-SQL 语句使用 sp_executesql 进行提交，并且指定了该参数的值，或者 SQL Server 在参数化某语句之后内部提交该语句。
在提示框中，输入要应用于 Transact-SQL 语句的查询提示或查询计划。若要指定一个或多个查询提示，请输入一个有效的 OPTION 子句。
单击“确定”。

plan_guide

使用 T-SQL 创建计划指南

在 “对象资源管理器” 中，连接到数据库引擎的实例。
在标准菜单栏上，单击 “新建查询” 。

将以下示例复制并粘贴到查询窗口中，然后单击“执行” 。

-- creates a plan guide named Guide1 based on a SQL statement  
EXEC sp_create_plan_guide   
    @name = N'Guide1',   
    @stmt = N'SELECT TOP 1 *   
              FROM Sales.SalesOrderHeader   
              ORDER BY OrderDate DESC',   
    @type = N'SQL',  
    @module_or_batch = NULL,   
    @params = NULL,   
    @hints = N'OPTION (MAXDOP 1)';

有关详细信息，请参阅 sp_create_plan_guide (Transact-SQL)。

通过

创建新的计划指南

限制和局限

权限

使用 SSMS 创建计划指南

使用 T-SQL 创建计划指南

反馈

其他资源