sp_control_plan_guide (Transact-SQL)

Quita, habilita o deshabilita una guía de plan.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_control_plan_guide [ @operation = ] N'<control_option>'
  [ , [ @name = ] N'plan_guide_name' ]

<control_option>::=
{ 
    DROP 
  | DROP ALL
  | DISABLE
  | DISABLE ALL
  | ENABLE 
  | ENABLE ALL
}

Argumentos

• N' plan_guide_name '
  Especifica la guía de plan que se va a quitar, habilitar o deshabilitar. plan_guide_name se resuelve como la base de datos actual. Si no especifica, el valor predeterminado de plan_guide_name es NULL.

• DROP
  Quita la guía de plan especificada por plan_guide_name. Una vez quitada una guía de plan, las ejecuciones futuras de una consulta que coincidía anteriormente con la guía de plan no se ven afectadas por dicha guía de plan.

• DROP ALL
  Quita todas las guías de plan de la base de datos actual. No se puede especificar **N'**plan_guide_name cuando se especifica DROP ALL.

• DISABLE
  Deshabilita la guía de plan especificada por plan_guide_name. Una vez deshabilitada una guía de plan, las ejecuciones futuras de una consulta que coincidía anteriormente con la guía de plan no se ven afectadas por dicha guía de plan.

• DISABLE ALL
  Deshabilita todas las guías de plan de la base de datos actual. No se puede especificar **N'**plan_guide_name cuando se especifica DISABLE ALL.

• ENABLE
  Habilita la guía de plan especificada por plan_guide_name. Una guía de plan puede coincidir con una consulta apta después de ser habilitada. De manera predeterminada, las guías de plan se habilitan en el momento en que se crean.

• ENABLE ALL
  Habilita todas las guías de plan de la base de datos actual. No se puede especificar **N'plan_guide_name'**cuando se especifica ENABLE ALL.

Comentarios

Se producirá un error si se intenta quitar o modificar una función, procedimiento almacenado o desencadenador DML al que una guía de plan, habilitada o deshabilitada, haga referencia.

Al deshabilitar una guía de plan deshabilitada o habilitar una guía de plan habilitada, no se produce ningún cambio o error.

Las guías de planes no están disponibles en todas las ediciones de Microsoft SQL Server. Para obtener una lista de características admitidas por las ediciones de SQL Server, vea Características compatibles con las ediciones de SQL Server 2012. Sin embargo, puede ejecutar sp_control_plan_guide con la opción DROP o DROP ALL en cualquier edición de SQL Server.

Permisos

Para ejecutar sp_control_plan_guide en una guía de plan de tipo OBJECT (creada especificando @type = 'OBJECT'), se requiere el permiso ALTER en el objeto al que hace referencia la guía de plan. Todas las demás guías de plan requieren el permiso ALTER DATABASE.

Ejemplos

A.Habilitar, deshabilitar y quitar una guía de plan

El ejemplo siguiente crea una guía de plan, la deshabilita, la habilita y la quita.

--Create a procedure on which to define the plan guide.
IF OBJECT_ID(N'Sales.GetSalesOrderByCountry', N'P') IS NOT NULL
    DROP PROCEDURE Sales.GetSalesOrderByCountry;
GO
CREATE PROCEDURE Sales.GetSalesOrderByCountry 
    (@Country nvarchar(60))
AS
BEGIN
    SELECT *
    FROM Sales.SalesOrderHeader AS h 
    INNER JOIN Sales.Customer AS c ON h.CustomerID = c.CustomerID
    INNER JOIN Sales.SalesTerritory AS t ON c.TerritoryID = t.TerritoryID
    WHERE t.CountryRegionCode = @Country;
END
GO
--Create the plan guide.
EXEC sp_create_plan_guide N'Guide3',
    N'SELECT *
    FROM Sales.SalesOrderHeader AS h 
    INNER JOIN Sales.Customer AS c ON h.CustomerID = c.CustomerID
    INNER JOIN Sales.SalesTerritory AS t ON c.TerritoryID = t.TerritoryID
    WHERE t.CountryRegionCode = @Country',
    N'OBJECT',
    N'Sales.GetSalesOrderByCountry',
    NULL,
    N'OPTION (OPTIMIZE FOR (@Country = N''US''))';
GO
--Disable the plan guide.
EXEC sp_control_plan_guide N'DISABLE', N'Guide3';
GO
--Enable the plan guide.
EXEC sp_control_plan_guide N'ENABLE', N'Guide3';
GO
--Drop the plan guide.
EXEC sp_control_plan_guide N'DROP', N'Guide3';

B.Deshabilitar todas las guías de plan de la base de datos actual.

En el ejemplo siguiente se deshabilitan todas las guías de plan de la base de datos AdventureWorks2012 .

USE AdventureWorks2012;
GO
EXEC sp_control_plan_guide N'DISABLE ALL';

Vea también

Referencia

Procedimientos almacenados del motor de base de datos (Transact-SQL)

Procedimientos almacenados del sistema (Transact-SQL)

sp_create_plan_guide (Transact-SQL)

sys.plan_guides (Transact-SQL)

Conceptos

Guías de plan