sys.sp_xtp_control_query_exec_stats (Transact-SQL)

  • Article

S’applique à :SQL Server

Active la collection de statistiques par requête pour toutes les procédures stockées compilées en mode natif pour l'instance, ou pour des procédures stockées compilées en mode natif spécifiques.

Les performances sont altérées lorsque vous activez la collection de statistiques. Si vous n’avez besoin que de résoudre un problème, ou quelques procédures stockées compilées en mode natif, vous pouvez activer la collecte des statistiques pour ces quelques procédures stockées compilées en mode natif.

Pour activer la collecte des statistiques au niveau de la procédure pour toutes les procédures stockées compilées en mode natif, consultez sys.sp_xtp_control_proc_exec_stats (Transact-SQL).

Syntaxe

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
[ ; ]

Arguments

[ @new_collection_value = ] collection_value

Détermine si la collecte des statistiques au niveau de la procédure est activée (1) ou désactivée (0). @new_collection_value est bit.

@new_collection_value est défini 0 au démarrage de SQL Server.

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

ID de base de données et ID d’objet (type de données int) pour la procédure stockée compilée en mode natif. Si la collecte des statistiques est activée pour l’instance (sys.sp_xtp_control_proc_exec_stats (Transact-SQL),les statistiques sur une procédure stockée compilée en mode natif sont collectées. La désactivation de la collecte de statistiques sur l’instance ne désactive pas la collecte de statistiques pour les procédures stockées compilées en mode natif.

Utilisez sys.databases (Transact-SQL), sys.procedures (Transact-SQL), DB_ID (Transact-SQL) ou OBJECT_ID (Transact-SQL) pour obtenir des ID pour une base de données et une procédure stockée.

[ @old_collection_value = ] sortie de old_collection_value

Retourne l'état actuel. @old_collection_value est bit.

Valeurs des codes de retour

0 pour réussir. Une valeur différente de zéro pour un échec.

Autorisations

Nécessite l’appartenance au rôle sysadmin fixe.

Exemples

L’exemple de code suivant montre comment activer la collecte de statistiques pour toutes les procédures stockées compilées en mode natif pour l’instance, puis pour une procédure stockée compilée en mode natif spécifique.

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';

Contenu connexe