sys.fn_trace_getinfo (Transact-SQL)
Retourne des informations sur une trace spécifiée ou toutes les traces existantes.
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.
S'applique à : SQL Server (SQL Server 2008 via la version actuelle). |
.gif "Icône Lien de rubrique")
Conventions de la syntaxe Transact-SQL
Syntaxe
sys.fn_trace_getinfo ( { trace_id | NULL | 0 | DEFAULT } )
Arguments
- trace_id
Identificateur de la trace. trace_id est de type int. Les entrées autorisées sont l'ID d'une trace ou la valeur 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 les informations de toutes les traces de l'instance de SQL Server.
Tables retournées
Nom de colonne |
Type de données |
Description |
|---|---|---|
traceid |
int |
Identificateur de la trace. |
property |
int |
Propriété de la trace : 1 = options de trace. Pour plus d'informations, consultez @options dans 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é, 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.
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 de procédures stockées de trace, consultez Créer une trace (Transact-SQL).
Autorisations
L'autorisation ALTER TRACE est nécessaire 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
Tâches
Créer une trace (Transact-SQL)
Référence
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)