sp_recompile (Transact-SQL)

Causes stored procedures and triggers to be recompiled the next time they are run. It does this by dropping the existing plan from the procedure cache forcing a new plan to be created the next time that the procedure or trigger is run. In a SQL Server Profiler collection, the event SP:CacheInsert is logged instead of the event SP:Recompile.

Topic link iconTransact-SQL Syntax Conventions

Syntax

sp_recompile [ @objname= ] 'object'

Arguments

  • [ @objname = ] 'object'
    Is the qualified or unqualified name of a stored procedure, trigger, table, or view in the current database. object is nvarchar(776), with no default. If object is the name of a stored procedure or trigger, the stored procedure or trigger will be recompiled the next time that it is run. If object is the name of a table or view, all the stored procedures that reference the table or view will be recompiled the next time they are run.

Return Code Values

0 (success) or a nonzero number (failure)

Remarks

sp_recompile looks for an object in the current database only.

The queries used by stored procedures and triggers are optimized only when they are compiled. As indexes or other changes that affect statistics are made to the database, compiled stored procedures and triggers may lose efficiency. By recompiling stored procedures and triggers that act on a table, you can reoptimize the queries.

Note

SQL Server automatically recompiles stored procedures and triggers when it is advantageous to do this.

Permissions

Requires ALTER permission on the specified object.

Examples

The following example causes stored procedures that act on the Customer table to be recompiled the next time they are run.

USE AdventureWorks;
GO
EXEC sp_recompile N'Sales.Customer';
GO