Compartilhar via

sp_query_store_unforce_plan (Transact-SQL)

  • Artigo

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

Permite a desimposiçã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

Importante

Os argumentos para procedimentos armazenados estendidos devem ser inseridos na ordem específica, conforme descrito na seção sintaxe. Se os parâmetros forem inseridos fora de ordem, ocorrerá uma mensagem de erro.

@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 imposta. @plan_id é bigint, sem padrão.

@force_plan_scope [ = ] 'replica_group_id'

Você pode cancelar os planos em uma réplica secundária quando 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 primária. Usar o argumento @force_plan_scope usa como padrão a réplica local em que o comando está sendo executado, mas você pode especificar um replica_group_id referenciando a exibição do catálogo do sistema sys.query_store_plan_forcing_locations.

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 o query_id e o plan_id que você deseja desimpor, use o exemplo a seguir para desforçar o plano.

EXEC sp_query_store_unforce_plan 3, 3;

Conteúdo relacionado