sys.sp_xtp_control_query_exec_stats (Transact-SQL)

Aplica-se: SQL Server

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.

Reduz o desempenho quando você habilita a coleta de estatísticas. Se você precisar solucionar problemas de um ou alguns procedimentos armazenados compilados nativamente, poderá habilitar a coleta de estatísticas apenas para esses poucos procedimentos armazenados compilados nativamente.

Para habilitar a coleta de estatísticas no nível do procedimento para todos os procedimentos armazenados compilados nativamente, consulte sys.sp_xtp_control_proc_exec_stats.

Sintaxe

sys.sp_xtp_control_query_exec_stats
    [ [ @new_collection_value = ] collection_value ]
    [ , [ @database_id = ] database_id ]
    [ , [ @xtp_object_id = ] procedure_id ]
    , [ @old_collection_value = ] old_collection_value OUTPUT
[ ; ]

Argumentos

@new_collection_value [ = ] collection_value

Determina se a coleta de estatísticas no nível do procedimento está ativada (1) ou desativada (0). @new_collection_value é pouco.

@new_collection_value é definido como quando o 0 SQL Server é iniciado.

@database_id [ = ] database_id, [ @xtp_object_id = ] procedure_id

A ID do banco de dados e a ID do objeto (tipo de dados int) para o procedimento armazenado compilado nativamente. Se a coleta de estatísticas estiver habilitada para a instância (sys.sp_xtp_control_proc_exec_stats), as estatísticas em um procedimento armazenado compilado nativamente serão coletadas. Desativar a coleta de estatísticas na instância não desativa a coleta de estatísticas para procedimentos armazenados individuais compilados nativamente.

Use sys.databases, sys.procedures, DB_ID ou OBJECT_ID para obter IDs para um banco de dados e um procedimento armazenado.

@old_collection_value [ = ] old_collection_value SAÍDA

Retorna o status atual. @old_collection_value é pouco.

Valores do código de retorno

0 para o sucesso. Diferente de zero para falha.

Permissões

Requer associação na função sysadmin fixa.

Exemplos

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, em seguida, para um procedimento armazenado compilado nativamente específico.

DECLARE @c BIT;

EXEC sys.sp_xtp_control_query_exec_stats @new_collection_value = 1;

EXEC sys.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 = 41576255;

EXEC sys.sp_xtp_control_query_exec_stats @database_id = 5,
    @xtp_object_id = 41576255,
    @old_collection_value = @c OUTPUT;

SELECT @c AS 'collection status';