• Article

fn_trace_gettable (Transact-SQL)

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

Icône Lien de rubriqueConventions de syntaxe de Transact-SQL

Syntaxe

fn_trace_gettable ( 'filename' , number_files )

Arguments

  • 'filename'
    Spécifie le fichier de trace initial à lire. filename est de type 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 filename. number_files est de type int.

Notes

Si l'argument number_files est spécifié en tant que default, fn_trace_gettable lit tous les fichiers de substitution jusqu'à la fin de la trace. fn_trace_gettable renvoie une table avec toutes les colonnes valides pour la trace spécifiée. Pour plus d'informations, cliquez sur le lien sp_trace_setevent (Transact-SQL).

Notez bien que la fonction fn_trace_gettable ne permet pas d'importer des fichiers de substitution (selon l'argument number_files) lorsque le nom du fichier d'origine se termine par un trait de soulignement ou une valeur numérique. Cette opération n'est pas valable lorsque le trait de soulignement et le nombre sont ajoutés automatiquement lors du remplacement d'un fichier. Une autre solution consiste à renommer les fichiers de trace pour supprimer les traits de soulignement dans le fichier d'origine. Par exemple : si Trace_Oct_5.trc est le fichier d'origine et que le fichier de substitution s'appelle Trace_Oct_5_1.trc, vous pouvez les renommer en employant les noms suivants : 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

A. 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 AdventureWorks2008R2;
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 AdventureWorks2008R2;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO