Compartilhar via


sp_query_store_force_plan (Transact-SQL)

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

Habilita forçar um plano específico para uma consulta específica no Repositório de Consultas.

Quando um plano for forçado para uma consulta específica, sempre que o SQL Server encontrar a consulta, ele tentará forçar o plano no Otimizador de Consulta. Se a forçagem do plano falhar, um Evento Estendido será disparado e o Otimizador de Consulta será instruído a fazer a otimização normalmente.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_query_store_force_plan
    [ @query_id = ] query_id ,
    [ @plan_id = ] plan_id ,
    [ @disable_optimized_plan_forcing = ] disable_optimized_plan_forcing ,
    [ @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 a ser forçado. @plan_id é bigint, sem padrão.

@disable_optimized_plan_forcing [ = ] disable_optimized_plan_forcing

Indica se a forçagem de plano otimizada deve ser desabilitada. @disable_optimized_plan_forcing é bit com um padrão de 0.

@force_plan_scope [ = ] 'replica_group_id'

Você pode forçar planos em uma réplica secundária quando o Repositório de Consultas para réplicas secundárias está habilitado. Execute sp_query_store_force_plan e sp_query_store_unforce_plan na réplica secundária. O argumento @force_plan_scope opcional é padronizado apenas para a réplica local (primária ou secundária), mas você pode, opcionalmente, especificar um replica_group_id referenciando sys.query_store_replicas.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

O plano de execução resultante forçado por esse recurso é o mesmo ou semelhante ao plano que está sendo forçado. Como o plano resultante pode não ser idêntico ao plano especificado pelo sys.sp_query_store_force_plan, o desempenho dos planos pode variar. Em casos raros, a diferença de desempenho pode ser significativa e negativa; Nesse caso, o administrador deve remover o plano forçado.

Revise planos forçados em réplicas secundárias com sys.query_store_plan_forcing_locations.

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 forçar, use o exemplo a seguir para forçar a consulta a usar um plano.

EXEC sp_query_store_force_plan
    @query_id = 3,
    @plan_id = 3;

Use sys.query_store_plan_forcing_locations, unido com sys.query_store_replicas, para recuperar o Repositório de Consultas para réplicas secundárias.

SELECT query_plan
FROM sys.query_store_plan AS qsp
INNER JOIN sys.query_store_plan_forcing_locations AS pfl
    ON pfl.query_id = qsp.query_id
INNER JOIN sys.query_store_replicas AS qsr
    ON qsr.replica_group_id = qsp.replica_group_id
WHERE qsr.replica_name = 'yourSecondaryReplicaName';