sys.fn_trace_getinfo (Transact-SQL)

Article
03/13/2024

S'applique à : SQL Server

Retourne des informations sur une trace spécifiée ou toutes les traces existantes.

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

  
sys.fn_trace_getinfo ( { trace_id | NULL | 0 | DEFAULT } )

Arguments

trace_id
ID de la trace. trace_id est int. Les entrées valides sont le numéro d’ID d’une trace, NULL, 0 ou DEFAULT. Les valeurs NULL, 0 et DEFAULT sont des valeurs équivalentes dans ce contexte. Spécifiez NULL, 0 ou DEFAULT pour retourner des informations pour toutes les traces dans l’instance de SQL Server.

Tables retournées

Nom de la colonne	Type de données	Description
traceid	int	Identificateur de la trace.
propriété	int	Propriété de la trace : 1 = options de trace. Pour plus d’informations, consultez @options sp_trace_create (Transact-SQL). 2 = nom de fichier 3 = taille maxi 4 = heure d'arrêt 5 = statut de trace actuel. 0 = arrêtée. 1 = exécution.
value	sql_variant	Informations sur la propriété de la trace spécifiée.

Notes

Lorsque l'identificateur d'une trace spécifique lui est passé, la fonction fn_trace_getinfo retourne les informations relatives à cette trace. Lorsqu'un identificateur non valide lui est passé, cette fonction renvoie un ensemble de lignes vide.

La fonction fn_trace_getinfo ajoute une extension .trc au nom de tous les fichiers de trace inclus dans son jeu de résultats. Pour plus d’informations sur la définition d’une trace, consultez sp_trace_create (Transact-SQL). Pour obtenir des informations similaires sur les filtres de trace, consultez sys.fn_trace_getfilterinfo (Transact-SQL).

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

autorisations

Nécessite l'autorisation ALTER TRACE sur le serveur.

Exemples

L'exemple suivant retourne des informations sur toutes les traces actives.

SELECT * FROM sys.fn_trace_getinfo(0) ;  
GO

Voir aussi

Créer une trace (Transact-SQL)
sp_trace_create (Transact-SQL)
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)
sys.fn_trace_getfilterinfo (Transact-SQL)
sys.fn_trace_geteventinfo (Transact-SQL)
sys.fn_trace_gettable (Transact-SQL)

Partager via