sp_trace_setstatus (Transact-SQL)

  • Article

S’applique à :SQL Server

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

Important

Cette fonctionnalité sera supprimée dans une version future de 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.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @traceid = ] traceid

ID de la trace à modifier. @traceid est int, sans valeur par défaut. L’utilisateur utilise cette valeur @traceid pour identifier, modifier et contrôler la trace. Pour plus d’informations sur la récupération du @traceid, consultez sys.fn_trace_getinfo (Transact-SQL).

[ @status = ] état

Indique l'action à implémenter sur la trace. @status est int, sans valeur par défaut.

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

Statut 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.

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 handle de trace spécifié n’est pas valide.
13 Mémoire insuffisante. Retourné lorsqu’il n’y a pas suffisamment de mémoire pour effectuer l’action spécifiée.

Si la trace est déjà dans l’état spécifié, SQL Server retourne 0.

Notes

Les paramètres de toutes les procédures stockées trace SQL (sp_trace_*) sont strictement typés. Si ces paramètres ne sont pas appelés avec les types de données de paramètre d’entrée corrects, comme spécifié dans la description de l’argument, la procédure stockée retourne une erreur.

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

Autorisations

Nécessite l’autorisation ALTER TRACE.

Contenu connexe