fn_trace_gettable (Transact-SQL)
Renvoie le contenu d'un ou plusieurs fichiers de trace dans un format tabulaire.
Conventions de la 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, consultez sp_trace_setevent (Transact-SQL).
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 à l'intérieur de la clause FROM
d'une instruction SELECT...INTO
.
USE AdventureWorks;
GO
SELECT * INTO temp_trc
FROM fn_trace_gettable('c:\temp\my_trace.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 AdventureWorks;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\my_trace.trc', default);
GO
Voir aussi
Référence
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)