fn_trace_gettable (Transact-SQL)
Renvoie le contenu d'un ou plusieurs fichiers de trace dans un format tabulaire.
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
L'exemple suivant appelle fn_trace_gettable dans la clause FROM d'une instruction SELECT...INTO.
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
L'exemple suivant appelle la fonction dans une instruction SELECT...INTO et retourne une table avec une colonne IDENTITY qui peut être chargée dans la table temp_trc.
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
Mise à jour du contenu |
---|
Mise à jour de la rubrique Remarques relative à l'utilisation des fichiers de substitution lorsque le nom du fichier de trace d'origine se termine par un trait de soulignement ou une valeur numérique. |