DBCC FREEPROCCACHE (Transact-SQL)

( { plan_handle | sql_handle | pool_name } )

plan_handle identifica exclusivamente um plano de consulta de um lote executado cujo plano reside no cache do plano. plan_handle é varbinary(64) e pode ser obtido nos seguintes objetos de gerenciamento dinâmico:

• sys.dm_exec_cached_plans

• sys.dm_exec_requests

• sys.dm_exec_query_memory_grants

• sys.dm_exec_query_stats

sql_handle é o identificador SQL do lote a ser apagado. sql_handle é varbinary(64) e pode ser obtido nos seguintes objetos de gerenciamento dinâmico:

• sys.dm_exec_query_stats

• sys.dm_exec_requests

• sys.dm_exec_cursors

• sys.dm_exec_xml_handles

• sys.dm_exec_query_memory_grants

pool_name é o nome de um pool de recursos do Administrador de Recursos. pool_name é sysname e pode ser obtido pela consulta da exibição de gerenciamento dinâmico sys.dm_resource_governor_resource_pools.

Para associar um grupo de carga de trabalho do Administrador de Recursos a um pool de recursos, consulte a exibição de gerenciamento dinâmico sys.dm_resource_governor_workload_groups. Para obter informações sobre o grupo de carga de trabalho durante uma sessão, consulte a exibição de gerenciamento dinâmico sys.dm_exec_sessions.

WITH NO_INFOMSGS

Suprime todas as mensagens informativas.

Use DBCC FREEPROCCACHE para limpar o cache do plano cuidadosamente. Por exemplo, liberar o cache do plano faz com que um procedimento armazenado seja recompilado em vez de reutilizado no cache. Isso pode causar uma diminuição súbita e temporária no desempenho de consulta. Para cada armazenamento em cache limpo no cache do plano, o log de erros do SQL Server conterá a seguinte mensagem informativa: "O SQL Server encontrou %d ocorrência(s) de liberação de armazenamento em cache '% s' (parte do cache do plano) devido às operações 'DBCC FREEPROCCACHE' ou 'DBCC FREESYSTEMCACHE'". Essa mensagem é registrada a cada cinco minutos, contanto que o cache seja liberado dentro desse intervalo de tempo.

Quando a cláusula WITH NO_INFOMSGS não estiver especificada, DBCC FREEPROCCACHE retornará:

"A execução do DBCC foi concluída. Se o DBCC imprimiu mensagens de erro, entre em contato com o administrador do sistema".

Requer permissão ALTER SERVER STATE no servidor.

A. Apagando um plano de consulta do cache do plano

USE AdventureWorks;
GO
SELECT * FROM Person.Address;
GO
SELECT plan_handle, st.text
FROM sys.dm_exec_cached_plans 
CROSS APPLY sys.dm_exec_sql_text(plan_handle) AS st
WHERE text LIKE N'SELECT * FROM Person.Address%';
GO

-- Remove the specific plan from the cache.
DBCC FREEPROCCACHE (0x060006001ECA270EC0215D05000000000000000000000000);
GO

B. Apagando todos os planos do cache do plano

DBCC FREEPROCCACHE WITH NO_INFOMSGS;

C. Desmarca todas as entradas de cache associadas a um pool de recursos

SELECT * FROM sys.dm_resource_governor_resource_pools;
GO
DBCC FREEPROCCACHE (default);
GO

Referência

Conceitos