sp_trace_setstatus (Transact-SQL)

Article
08/19/2013

Modifie l'état actuel de la trace spécifiée.

Important

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez plutôt des événements étendus.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status

Arguments

[ @traceid= ] trace_id
ID de la trace à modifier. trace_id est de type int et n'a pas de valeur par défaut. L'utilisateur emploie cette valeur trace_id pour identifier, modifier et contrôler la trace. Pour plus d'informations sur la récupération de l'argument trace_id, consultez sys.fn_trace_getinfo (Transact-SQL).
[ @status= ] status
Indique l'action à implémenter sur la trace. status est de type int et n'a pas de valeur par défaut.

Le tableau ci-après répertorie les états qui peuvent être spécifiés.

État

Description

0

Arrête la trace spécifiée.

1

Démarre la trace spécifiée.

2

Ferme la trace spécifiée et supprime sa définition du serveur.

[!REMARQUE]

Une trace doit d'abord être arrêtée avant d'être fermée de la même façon qu'elle doit d'abord être arrêtée et fermée avant de pouvoir être consultée.

État	Description
0	Arrête la trace spécifiée.
1	Démarre la trace spécifiée.
2	Ferme la trace spécifiée et supprime sa définition du serveur.

Valeurs des codes de retour

Le tableau suivant décrit les valeurs de code que les utilisateurs peuvent recevoir à la fin de l'exécution de la procédure stockée.

Code de retour	Description
0	Aucune erreur.
1	Erreur inconnue.
8	L'état spécifié n'est pas valide.
9	Le descripteur de trace spécifié n'est pas valide.
13	Mémoire insuffisante. Ce code est retourné lorsqu'il n'y a pas assez de mémoire pour exécuter l'action spécifiée.

Si la trace présente déjà l'état spécifié, SQL Server retourne 0.

Notes

Les paramètres de toutes les procédures stockées Trace SQL (sp_trace_xx) possèdent un type précis. Si ces paramètres ne sont pas appelés à l'aide des types de données de paramètre d'entrée appropriés, comme le définit la description de l'argument, la procédure stockée renvoie une erreur.

Pour obtenir un exemple d'utilisation de procédures stockées de trace, consultez Créer une trace (Transact-SQL).