sys.sp_xtp_control_query_exec_stats (Transact-SQL)sys.sp_xtp_control_query_exec_stats (Transact-SQL)

APLICA-SE A: simSQL Server nãoBanco de Dados SQL do Azure nãoAzure Synapse Analytics (SQL DW) nãoParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Habilita a coleta de estatísticas por consulta para todos os procedimentos armazenados compilados nativamente para a instância ou para procedimentos armazenados compilados nativamente específicos.Enables per query statistics collection for all natively compiled stored procedures for the instance, or specific natively compiled stored procedures.

Reduz o desempenho quando você habilita a coleta de estatísticas.Performance decreases when you enable statistics collection. Se você precisar solucionar problemas de um ou alguns procedimentos armazenados compilados nativamente, será necessário habilitar a coleta de estatísticas apenas para esses.If you only need to troubleshoot one, or a few natively compiled stored procedures, you can enabling statistics collection for just those few natively compiled stored procedures.

Para habilitar a coleta de estatísticas no nível de procedimento para todos os procedimentos armazenados compilados nativamente, consulte sp_xtp_control_proc_exec_stats (Transact-SQL).To enable statistics collection at the procedure level for all natively compiled stored procedures, see sys.sp_xtp_control_proc_exec_stats (Transact-SQL).

SintaxeSyntax

sp_xtp_control_query_exec_stats [ [ @new_collection_value = ] collection_value ],  
[ [ @database_id = ] database_id   
[ , [ @xtp_object_id = ] procedure_id ] ,   
[ @old_collection_value] ]  

ArgumentosArguments

@new_collection_value = valor@new_collection_value = value
Determina se a coleta de estatísticas no nível do procedimento está ativada (1) ou desativada (0).Determines whether procedure-level statistics collection is on (1) or off (0).

@new_collection_value é definido como zero quando SQL ServerSQL Server é iniciado.@new_collection_value is set to zero when SQL ServerSQL Server starts.

@database_id = = database_id, @xtp_object_id = procedure_id@database_id = = database_id, @xtp_object_id = procedure_id
A ID de banco de dados e a ID de objeto do procedimento armazenado compilado nativamente.The database ID and object ID for the natively compiled stored procedure. Se a coleta de estatísticas é habilitada para a instância (sp_xtp_control_proc_exec_stats (Transact-SQL)), as estatísticas em um procedimento armazenado compilado nativamente são coletadas.If statistics collection is enabled for the instance (sys.sp_xtp_control_proc_exec_stats (Transact-SQL)), statistics on a natively compiled stored procedure are collected. Se você desativar a coleção de estatísticas na instância, ela não será desativada para cada procedimento armazenado compilado de forma nativa.Turning off statistics collection on the instance does not turn off statistics collection for individual natively compiled stored procedures.

Use sys. Databases (Transact-SQL), Procedures (Transact-SQL), DB_ID (Transact-SQL), ou OBJECT_ID (Transact-SQL) para obter as IDs de um banco de dados e o procedimento armazenado.Use sys.databases (Transact-SQL), sys.procedures (Transact-SQL), DB_ID (Transact-SQL), or OBJECT_ID (Transact-SQL) to get IDs for a database and stored procedure.

@old_collection_value = valor@old_collection_value = value
Retorna o status atual.Returns the current status.

Código de retornoReturn Code

0 para êxito.0 for success. Diferente de zero para falha.Nonzero for failure.

PermissõesPermissions

Requer associação à função sysadmin fixa.Requires membership in the fixed sysadmin role.

Exemplo de códigoCode Sample

O exemplo de código a seguir mostra como habilitar a coleta de estatísticas para todos os procedimentos armazenados compilados nativamente para a instância e, depois, para um procedimento armazenado compilado nativamente específico.The following code sample shows how to enable statistics collection for all natively compiled stored procedures for the instance and then for a specific natively compiled stored procedure.

DECLARE @c bit  
  
EXEC [sys].[sp_xtp_control_query_exec_stats] @new_collection_value = 1;  
  
EXEC sp_xtp_control_query_exec_stats @old_collection_value=@c output;  
SELECT @c AS 'collection status';  
  
EXEC [sys].[sp_xtp_control_query_exec_stats] @new_collection_value = 1,   
@database_id = 5, @xtp_object_id = 341576255;  
  
EXEC sp_xtp_control_query_exec_stats @database_id = 5,   
@xtp_object_id = 341576255, @old_collection_value=@c output;  
  
SELECT @c AS 'collection status';  

Consulte tambémSee Also

Procedimentos armazenados do sistema (Transact-SQL) System Stored Procedures (Transact-SQL)
OLTP in-memory (Otimização na memória)In-Memory OLTP (In-Memory Optimization)