sp_query_store_unforce_plan (Transact-SQL)

  • Artículo

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores Azure SQL DatabaseAzure SQL Managed Instance

Habilita la aplicación de un plan forzado previamente para una consulta determinada en el Almacén de consultas.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_query_store_unforce_plan
    [ @query_id = ] query_id ,
    [ @plan_id = ] plan_id ,
    [ @force_plan_scope = ] 'replica_group_id'
[ ; ]

Argumentos

[ @query_id = ] query_id

Identificador de la consulta. @query_id es bigint, sin valor predeterminado.

[ @plan_id = ] plan_id

Identificador del plan de consulta que ya no se aplicará. @plan_id es bigint, sin valor predeterminado.

[ @force_plan_scope = ] 'replica_group_id'

Puede forzar y forzar planes en una réplica secundaria cuando se habilita Almacén de consultas para réplicas secundarias. Ejecute sp_query_store_force_plan y sp_query_store_unforce_plan en la réplica secundaria. El argumento opcional @force_plan_scope solo tiene como valor predeterminado la réplica local, pero opcionalmente puede especificar un replica_group_id que haga referencia a sys.query_store_plan_forcing_locations.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Permisos

Requiere el permiso ALTER en la base de datos.

Ejemplos

En el ejemplo siguiente se devuelve información sobre las consultas del Almacén de consultas.

SELECT txt.query_text_id,
    txt.query_sql_text,
    pl.plan_id,
    qry.*
FROM sys.query_store_plan AS pl
INNER JOIN sys.query_store_query AS qry
    ON pl.query_id = qry.query_id
INNER JOIN sys.query_store_query_text AS txt
    ON qry.query_text_id = txt.query_text_id;

Después de identificar el query_id y plan_id que desea deshacer, use el ejemplo siguiente para deshacer el plan.

EXEC sp_query_store_unforce_plan 3, 3;

Pasos siguientes