sys.fn_trace_gettable (Transact-SQL)

Article
07/05/2024

S'applique à : SQL Server

Renvoie le contenu d'un ou plusieurs fichiers de trace dans un format tabulaire.

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

  
fn_trace_gettable ( 'filename' , number_files )

Arguments

'filename'
Spécifie le fichier de trace initial à lire. nom_fichier est nvarchar(256), sans valeur par défaut.

number_files
Spécifie le nombre de fichiers de substitution à lire. Ce nombre inclut le fichier initial spécifié dans le nom de fichier. number_files est un int.

Notes

Si number_files est spécifié comme valeur par défaut, fn_trace_gettable lit tous les fichiers de substitution jusqu’à ce qu’il atteigne la fin de la trace. fn_trace_gettable retourne une table avec toutes les colonnes valides pour la trace spécifiée. Pour plus d’informations, consultez sp_trace_setevent (Transact-SQL).

N’oubliez pas que la fonction fn_trace_gettable ne charge pas les fichiers de substitution (lorsque cette option est spécifiée à l’aide de l’argument number_files ) où le nom de fichier de trace d’origine se termine par un trait de soulignement et une valeur numérique. (Cela ne s’applique pas au trait de soulignement et au nombre ajoutés automatiquement lorsqu’un fichier est annulé.) Pour contourner ce problème, vous pouvez renommer les fichiers de trace pour supprimer les traits de soulignement dans le nom de fichier d’origine. Par exemple, si le fichier d’origine est nommé Trace_Oct_5.trc et que le fichier de substitution est nommé Trace_Oct_5_1.trc, vous pouvez renommer les fichiers en TraceOct5.trc et TraceOct5_1.trc.

Cette fonction peut lire une trace encore active sur l'instance sur laquelle elle est exécutée.

autorisations

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

Exemples

R. Utilisation de fn_trace_gettable pour importer des lignes à partir d'un fichier de trace

L'exemple suivant appelle fn_trace_gettable dans la clause FROM d'une instruction SELECT...INTO.

USE AdventureWorks2022;  
GO  
SELECT * INTO temp_trc  
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);  
GO

B. Utilisation de fn_trace_gettable pour renvoyer une table ayant une colonne IDENTITY qui peut être chargée dans une table SQL Server

L'exemple suivant appelle la fonction dans une instruction SELECT...INTO et renvoie une table avec une colonne IDENTITY qui peut être chargée dans la table temp_trc.

USE AdventureWorks2022;  
GO  
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc  
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);  
GO

Voir aussi

sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)

Partage via