sys.fn_trace_gettable (Transact-SQL)
Renvoie le contenu d'un ou plusieurs fichiers de trace dans un format tabulaire.
Important
Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft 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.
.gif "Icône Lien de rubrique")
Conventions de la syntaxe 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) et n'a pas de 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 number_files est spécifié comme 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).
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 de trace 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 AdventureWorks2012;
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 AdventureWorks2012;
GO
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);
GO
Voir aussi
Référence
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)