sys.dm_exec_procedure_stats (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

Retorna estatísticas de desempenho de agregação para procedimentos armazenados em cache. A exibição retorna uma linha para cada plano de procedimento armazenado, e o tempo de vida da linha é igual ao tempo em que o procedimento armazenado permanece em cache. Quando um procedimento armazenado é removido do cache, a linha correspondente é eliminada da exibição. Nesse momento, o query_cache_removal_statistics evento é gerado de forma semelhante ao sys.dm_exec_query_stats para SQL Server e Instância Gerenciada SQL do Azure.

No Banco de Dados SQL do Azure, as exibições de gerenciamento dinâmico não podem expor informações que afetariam a contenção do banco de dados ou expor informações sobre outros bancos de dados aos quais o usuário tem acesso. Para evitar a exposição dessas informações, todas as linhas que contêm dados que não pertencem ao locatário conectado são filtradas.

Observação

Os resultados de sys.dm_exec_procedure_stats podem variar com cada execução, pois os dados refletem apenas consultas concluídas, e não aquelas ainda em andamento. Para chamar isso do Azure Synapse Analytics ou do Analytics Platform System (PDW), use o nome sys.dm_pdw_nodes_exec_procedure_stats. Não há suporte a essa sintaxe para o pool de SQL sem servidor no Azure Synapse Analytics.

Nome da coluna	Tipo de dados	Descrição
database_id	int	ID do banco de dados no qual o procedimento armazenado reside. No Banco de Dados SQL do Azure, os valores são exclusivos em um único banco de dados ou em um pool elástico, mas não em um servidor lógico.
object_id	int	Número de identificação de objeto do procedimento armazenado.
tipo	char(2)	Tipo do objeto: P = Procedimento armazenado SQL PC = Procedimento armazenado de assembly (CLR) X = Procedimento armazenado estendido
type_desc	nvarchar(60)	Descrição do tipo de objeto: SQL_STORED_PROCEDURE CLR_STORED_PROCEDURE EXTENDED_STORED_PROCEDURE
sql_handle	varbinary(64)	Isso pode ser usado para correlacionar com consultas em sys.dm_exec_query_stats que foram executadas de dentro deste procedimento armazenado.
plan_handle	varbinary(64)	Identificador do plano na memória. Esse identificador é transitório e permanece constante somente enquanto o plano permanece no cache. Esse valor pode ser usado com a exibição de gerenciamento dinâmico sys.dm_exec_cached_plans. Sempre será 0x000 quando um procedimento armazenado compilado nativamente consultar uma tabela com otimização de memória.
cached_time	datetime	Hora em que o procedimento armazenado foi adicionado ao cache.
last_execution_time	datetime	Hora em que o procedimento armazenado foi executado pela última vez.
execution_count	bigint	O número de vezes que o procedimento armazenado foi executado desde que foi compilado pela última vez.
total_worker_time	bigint	A quantidade total de tempo de CPU, em microssegundos, que foi consumida pelas execuções desse procedimento armazenado desde que ele foi compilado. Para procedimentos armazenados compilados de modo nativo, o total_worker_time pode não ser preciso se várias execuções levarem menos de 1 milissegundo.
last_worker_time	bigint	Tempo de CPU, em microssegundos, consumido na última vez em que o procedimento armazenado foi executado. 1
min_worker_time	bigint	O tempo mínimo de CPU, em microssegundos, que esse procedimento armazenado já consumiu durante uma única execução. 1
max_worker_time	bigint	O tempo máximo de CPU, em microssegundos, que esse procedimento armazenado já consumiu durante uma única execução. 1
total_physical_reads	bigint	O número total de leituras físicas realizadas pelas execuções desse procedimento armazenado desde que ele foi compilado. Sempre será 0 ao consultar uma tabela com otimização de memória.
last_physical_reads	bigint	O número de leituras físicas realizadas na última vez que o procedimento armazenado foi executado. Sempre será 0 ao consultar uma tabela com otimização de memória.
min_physical_reads	bigint	O número mínimo de leituras físicas que esse procedimento armazenado já executou durante uma única execução. Sempre será 0 ao consultar uma tabela com otimização de memória.
max_physical_reads	bigint	O número máximo de leituras físicas que esse procedimento armazenado já executou durante uma única execução. Sempre será 0 ao consultar uma tabela com otimização de memória.
total_logical_writes	bigint	O número total de gravações lógicas executadas por execuções desse procedimento armazenado desde que ele foi compilado. Sempre será 0 ao consultar uma tabela com otimização de memória.
last_logical_writes	bigint	O número de páginas do pool de buffers sujas na última vez que o plano foi executado. Se uma página já estiver suja (modificada), nenhuma gravação será contabilizada. Sempre será 0 ao consultar uma tabela com otimização de memória.
min_logical_writes	bigint	O número mínimo de gravações lógicas que esse procedimento armazenado já executou durante uma única execução. Sempre será 0 ao consultar uma tabela com otimização de memória.
max_logical_writes	bigint	O número máximo de gravações lógicas que esse procedimento armazenado já executou durante uma única execução. Sempre será 0 ao consultar uma tabela com otimização de memória.
total_logical_reads	bigint	O número total de leituras lógicas realizadas pelas execuções desse procedimento armazenado desde que ele foi compilado. Sempre será 0 ao consultar uma tabela com otimização de memória.
last_logical_reads	bigint	O número de leituras lógicas executadas na última vez que o procedimento armazenado foi executado. Sempre será 0 ao consultar uma tabela com otimização de memória.
min_logical_reads	bigint	O número mínimo de leituras lógicas que esse procedimento armazenado já executou durante uma única execução. Sempre será 0 ao consultar uma tabela com otimização de memória.
max_logical_reads	bigint	O número máximo de leituras lógicas que esse procedimento armazenado já executou durante uma única execução. Sempre será 0 ao consultar uma tabela com otimização de memória.
total_elapsed_time	bigint	O tempo total decorrido, em microssegundos, para a conclusão das execuções desse procedimento armazenado.
last_elapsed_time	bigint	O tempo decorrido, em microssegundos, para a execução mais recentemente concluída deste procedimento armazenado.
min_elapsed_time	bigint	O tempo mínimo decorrido, em microssegundos, para qualquer execução concluída deste procedimento armazenado.
max_elapsed_time	bigint	O tempo máximo decorrido, em microssegundos, para qualquer execução concluída deste procedimento armazenado.
total_spills	bigint	O número total de páginas derramadas pela execução deste procedimento armazenado desde que foi compilado. Aplica-se a: Começando com o SQL Server 2017 (14.x) CU3
last_spills	bigint	O número de páginas derramadas na última vez que o procedimento armazenado foi executado. Aplica-se a: Começando com o SQL Server 2017 (14.x) CU3
min_spills	bigint	O número mínimo de páginas que esse procedimento armazenado já vazou durante uma única execução. Aplica-se a: Começando com o SQL Server 2017 (14.x) CU3
max_spills	bigint	O número máximo de páginas que esse procedimento armazenado já vazou durante uma única execução. Aplica-se a: Começando com o SQL Server 2017 (14.x) CU3
pdw_node_id	int	O identificador do nó em que essa distribuição está ativada. Aplica-se a: Azure Synapse Analytics, Analytics Platform System (PDW)
total_page_server_reads	bigint	O número total de leituras do servidor de página executadas pelas execuções desse procedimento armazenado desde que ele foi compilado. Aplica-se a: Hiperescala do Banco de Dados SQL do Azure
last_page_server_reads	bigint	O número de leituras do servidor de página executadas na última vez que o procedimento armazenado foi executado. Aplica-se a: Hiperescala do Banco de Dados SQL do Azure
min_page_server_reads	bigint	O número mínimo de servidor de página lê que esse procedimento armazenado já foi executado durante uma única execução. Aplica-se a: Hiperescala do Banco de Dados SQL do Azure
max_page_server_reads	bigint	O número máximo de servidores de página lê que esse procedimento armazenado já foi executado durante uma única execução. Aplica-se a: Hiperescala do Banco de Dados SQL do Azure

1 Para procedimentos armazenados compilados nativamente quando a coleta de estatísticas está habilitada, o tempo de trabalho é coletado em milissegundos. Se a consulta for executada em menos de um milissegundo, o valor será 0.

Permissões

No SQL Server e na Instância Gerenciada de SQL, requer a permissão VIEW SERVER STATE.

Nos objetivos de serviço do Banco de Dados SQL Básico, S0 e S1 e para bancos de dados em pools elásticos, é necessária a conta do administrador do servidor, a conta do administrador do Microsoft Entra ou a associação à ##MS_ServerStateReader##função de servidor. Em todos os outros objetivos de serviço do Banco de Dados SQL, a permissão VIEW DATABASE STATE no banco de dados ou a associação à função de servidor ##MS_ServerStateReader## são necessárias.

Permissões do SQL Server 2022 e posteriores

É necessária a permissão VIEW SERVER PERFORMANCE STATE no servidor.

Comentários

As estatísticas da exibição serão atualizadas quando uma execução de procedimento armazenado for concluída.

Exemplos

O exemplo a seguir retorna informações sobre os dez principais procedimentos armazenados identificados por tempo médio decorrido.

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;  

Confira também

Funções e exibições de gerenciamento dinâmico relacionadas à execução (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)