sys.fn_trace_getinfo (Transact-SQL)
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)