fn_trace_gettable (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 désigne default, l'instruction fn_trace_gettable identifie tous les fichiers de substitution. fn_trace_gettable permet d'afficher une table comprenant toutes les colonnes autorisées pour la trace que vous avez sélectionné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

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

B. Utilisation de fn_trace_gettable pour retourner une table avec une colonne IDENTITY pouvant être chargée dans une table SQL Server

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

Historique des modifications

Voir aussi

Référence