Compartir a través de

  • Artículo

DBCC FREEPROCCACHE (Transact-SQL)

Quita todos los elementos de la memoria caché del plan, quita un plan concreto de la misma especificando un identificador de plan o un identificador SQL, o quita todas las entradas de caché asociadas a un grupo de recursos de servidor especificado.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

DBCC FREEPROCCACHE [ ( { plan_handle | sql_handle | pool_name } ) ] [ WITH NO_INFOMSGS ]

Argumentos

Notas

Use DBCC FREEPROCCACHE con precaución para borrar la caché del plan. Por ejemplo, al liberar la caché del plan se volverá a compilar un procedimiento almacenado en vez de reutilizarlo desde la caché. Esto causa una disminución repentina y temporal del rendimiento de las consultas. Para cada almacén de caché borrado de la caché del plan, el registro de errores de SQL Server contendrá el siguiente mensaje informativo: "SQL Server ha detectado %d instancias de vaciado del almacén de caché '%s' (parte de la caché del plan) debidas a operaciones 'DBCC FREEPROCCACHE' o 'DBCC FREESYSTEMCACHE'". Este mensaje se registra cada cinco minutos siempre que se vacía la caché dentro de ese intervalo de tiempo.

Conjuntos de resultados

Si no se especifica la cláusula WITH NO_INFOMSGS, se devuelve DBCC FREEPROCCACHE:

"La ejecución de DBCC se ha completado. Si DBCC imprime algún mensaje de error, póngase en contacto con su administrador del sistema."

Permisos

Requiere el permiso ALTER SERVER STATE en el servidor.

Ejemplos

A. Borrar un plan de consultas de la caché del plan

En el ejemplo siguiente se especifica el identificador de plan de consultas para borrar el plan de consultas de la caché del plan. Para asegurarse de que la consulta del ejemplo está en la caché del plan, la consulta se ejecuta primero. Se consultan las vistas de administración dinámicas sys.dm_exec_cached_plans y sys.dm_exec_sql_text para obtener el identificador de plan para la consulta. A continuación, el valor del identificador de plan del conjunto de resultados se inserta en la instrucción DBCC FREEPROCACHE para borrar únicamente dicho plan de la caché del plan.

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

Éste es el conjunto de resultados.

plan_handle                                         text

--------------------------------------------------  -----------------------------

0x060006001ECA270EC0215D05000000000000000000000000  SELECT * FROM Person.Address;

(1 fila afectada)

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

B. Borrar todos los planes de la caché del plan

En el ejemplo siguiente se borran todos los elementos de la caché del plan. Para que no se muestre el mensaje informativo, se especifica la cláusula WITH NO_INFOMSGS .

DBCC FREEPROCCACHE WITH NO_INFOMSGS;

C. Borrar todas las entradas de caché asociadas a un grupo de recursos de servidor

En el ejemplo siguiente se borran todas las entradas de caché asociadas a un grupo de recursos de servidor especificado. Primero, se consulta la vista sys.dm_resource_governor_resource_pools para obtener el valor de pool_name.

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

Historial de cambios

Contenido actualizado

Se ha corregido la información sobre grupos de recursos de servidor en la introducción y se ha agregado información en la sección Argumentos sobre las maneras de obtener información de nombre de un grupo del regulador de recursos.

Se ha agregado el ejemplo C.