sys.dm_exec_procedure_stats (Transact-SQL)
Applies to: 
SQL Server
Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Analytics Platform System (PDW)
Returns aggregate performance statistics for cached stored procedures. The view returns one row for each cached stored procedure plan, and the lifetime of the row is as long as the stored procedure remains cached. When a stored procedure is removed from the cache, the corresponding row is eliminated from this view. At that time, the query_cache_removal_statistics event is raised similar to sys.dm_exec_query_stats for SQL Server and Azure SQL Managed Instance.
In Azure SQL Database, dynamic management views cannot expose information that would impact database containment or expose information about other databases the user has access to. To avoid exposing this information, every row that contains data that doesn't belong to the connected tenant is filtered out.
Note
The results of sys.dm_exec_procedure_stats may vary with each execution as the data only reflects finished queries, and not ones still in-flight.
To call this from Azure Synapse Analytics or Analytics Platform System (PDW), use the name sys.dm_pdw_nodes_exec_procedure_stats. This syntax is not supported by serverless SQL pool in Azure Synapse Analytics.
| Column name | Data type | Description |
|---|---|---|
| database_id | int | Database ID in which the stored procedure resides. In Azure SQL Database, the values are unique within a single database or an elastic pool, but not within a logical server. |
| object_id | int | Object identification number of the stored procedure. |
| type | char(2) | Type of the object: P = SQL stored procedure PC = Assembly (CLR) stored procedure X = Extended stored procedure |
| type_desc | nvarchar(60) | Description of the object type: SQL_STORED_PROCEDURE CLR_STORED_PROCEDURE EXTENDED_STORED_PROCEDURE |
| sql_handle | varbinary(64) | This can be used to correlate with queries in sys.dm_exec_query_stats that were executed from within this stored procedure. |
| plan_handle | varbinary(64) | Identifier for the in-memory plan. This identifier is transient and remains constant only while the plan remains in the cache. This value may be used with the sys.dm_exec_cached_plans dynamic management view. Will always be 0x000 when a natively compiled stored procedure queries a memory-optimized table. |
| cached_time | datetime | Time at which the stored procedure was added to the cache. |
| last_execution_time | datetime | Last time at which the stored procedure was executed. |
| execution_count | bigint | The number of times that the stored procedure has been executed since it was last compiled. |
| total_worker_time | bigint | The total amount of CPU time, in microseconds, that was consumed by executions of this stored procedure since it was compiled. For natively compiled stored procedures, total_worker_time may not be accurate if many executions take less than 1 millisecond. |
| last_worker_time | bigint | CPU time, in microseconds, that was consumed the last time the stored procedure was executed. 1 |
| min_worker_time | bigint | The minimum CPU time, in microseconds, that this stored procedure has ever consumed during a single execution. 1 |
| max_worker_time | bigint | The maximum CPU time, in microseconds, that this stored procedure has ever consumed during a single execution. 1 |
| total_physical_reads | bigint | The total number of physical reads performed by executions of this stored procedure since it was compiled. Will always be 0 querying a memory-optimized table. |
| last_physical_reads | bigint | The number of physical reads performed the last time the stored procedure was executed. Will always be 0 querying a memory-optimized table. |
| min_physical_reads | bigint | The minimum number of physical reads that this stored procedure has ever performed during a single execution. Will always be 0 querying a memory-optimized table. |
| max_physical_reads | bigint | The maximum number of physical reads that this stored procedure has ever performed during a single execution. Will always be 0 querying a memory-optimized table. |
| total_logical_writes | bigint | The total number of logical writes performed by executions of this stored procedure since it was compiled. Will always be 0 querying a memory-optimized table. |
| last_logical_writes | bigint | The number of buffer pool pages dirtied the last time the plan was executed. If a page is already dirty (modified) no writes are counted. Will always be 0 querying a memory-optimized table. |
| min_logical_writes | bigint | The minimum number of logical writes that this stored procedure has ever performed during a single execution. Will always be 0 querying a memory-optimized table. |
| max_logical_writes | bigint | The maximum number of logical writes that this stored procedure has ever performed during a single execution. Will always be 0 querying a memory-optimized table. |
| total_logical_reads | bigint | The total number of logical reads performed by executions of this stored procedure since it was compiled. Will always be 0 querying a memory-optimized table. |
| last_logical_reads | bigint | The number of logical reads performed the last time the stored procedure was executed. Will always be 0 querying a memory-optimized table. |
| min_logical_reads | bigint | The minimum number of logical reads that this stored procedure has ever performed during a single execution. Will always be 0 querying a memory-optimized table. |
| max_logical_reads | bigint | The maximum number of logical reads that this stored procedure has ever performed during a single execution. Will always be 0 querying a memory-optimized table. |
| total_elapsed_time | bigint | The total elapsed time, in microseconds, for completed executions of this stored procedure. |
| last_elapsed_time | bigint | The elapsed time, in microseconds, for the most recently completed execution of this stored procedure. |
| min_elapsed_time | bigint | The minimum elapsed time, in microseconds, for any completed execution of this stored procedure. |
| max_elapsed_time | bigint | The maximum elapsed time, in microseconds, for any completed execution of this stored procedure. |
| total_spills | bigint | The total number of pages spilled by execution of this stored procedure since it was compiled. Applies to: Starting with SQL Server 2017 (14.x) CU3 |
| last_spills | bigint | The number of pages spilled the last time the stored procedure was executed. Applies to: Starting with SQL Server 2017 (14.x) CU3 |
| min_spills | bigint | The minimum number of pages that this stored procedure has ever spilled during a single execution. Applies to: Starting with SQL Server 2017 (14.x) CU3 |
| max_spills | bigint | The maximum number of pages that this stored procedure has ever spilled during a single execution. Applies to: Starting with SQL Server 2017 (14.x) CU3 |
| pdw_node_id | int | The identifier for the node that this distribution is on. Applies to: Azure Synapse Analytics, Analytics Platform System (PDW) |
| total_page_server_reads | bigint | The total number of page server reads performed by executions of this stored procedure since it was compiled. Applies to: Azure SQL Database Hyperscale |
| last_page_server_reads | bigint | The number of page server reads performed the last time the stored procedure was executed. Applies to: Azure SQL Database Hyperscale |
| min_page_server_reads | bigint | The minimum number of page server reads that this stored procedure has ever performed during a single execution. Applies to: Azure SQL Database Hyperscale |
| max_page_server_reads | bigint | The maximum number of page server reads that this stored procedure has ever performed during a single execution. Applies to: Azure SQL Database Hyperscale |
1 For natively compiled stored procedures when statistics collection is enabled, worker time is collected in milliseconds. If the query executes in less than a millisecond, the value will be 0.
Permissions
On SQL Server and SQL Managed Instance, requires VIEW SERVER STATE permission.
On SQL Database Basic, S0, and S1 service objectives, and for databases in elastic pools, the server admin account, the Microsoft Entra admin account, or membership in the ##MS_ServerStateReader## server role is required. On all other SQL Database service objectives, either the VIEW DATABASE STATE permission on the database, or membership in the ##MS_ServerStateReader## server role is required.
Permissions for SQL Server 2022 and later
Requires VIEW SERVER PERFORMANCE STATE permission on the server.
Remarks
Statistics in the view are updated when a stored procedure execution completes.
Examples
The following example returns information about the top ten stored procedures identified by average elapsed time.
SELECT TOP 10 d.object_id, d.database_id, OBJECT_NAME(object_id, database_id) 'proc name',
d.cached_time, d.last_execution_time, d.total_elapsed_time,
d.total_elapsed_time/d.execution_count AS [avg_elapsed_time],
d.last_elapsed_time, d.execution_count
FROM sys.dm_exec_procedure_stats AS d
ORDER BY [total_worker_time] DESC;
See Also
Execution Related Dynamic Management Views and Functions (Transact-SQL)
sys.dm_exec_sql_text (Transact-SQL)
sys.dm_exec_query_plan (Transact-SQL)
sys.dm_exec_query_stats (Transact-SQL)
sys.dm_exec_trigger_stats (Transact-SQL)
sys.dm_exec_cached_plans (Transact-SQL)