sp_query_store_unforce_plan (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores Banco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Permite cancelar a imposição de um plano forçado anteriormente para uma consulta específica no Repositório de Consultas.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@query_id [ = ] query_id

A ID da consulta. @query_id é bigint, sem padrão.

@plan_id [ = ] plan_id

A ID do plano de consulta que não será mais imposto. @plan_id é bigint, sem padrão.

@force_plan_scope [ = ] 'replica_group_id'

Você pode forçar e desforçar planos em uma réplica secundária quando o Repositório de Consultas para réplicas secundárias estiver habilitado. Execute sp_query_store_force_plan e sp_query_store_unforce_plan na réplica secundária. O argumento @force_plan_scope opcional tem como padrão apenas a réplica local, mas você pode especificar opcionalmente um replica_group_id sys.query_store_plan_forcing_locations de referência.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Permissões

Requer a permissão ALTER no banco de dados.

Exemplos

O exemplo a seguir retorna informações sobre as consultas no Repositório 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;

Depois de identificar os query_id e os plan_id que você deseja desforçar, use o exemplo a seguir para desforçar o plano.

EXEC sp_query_store_unforce_plan 3, 3;

Próximas etapas