sys.fn_trace_gettable (Transact-SQL)

Van toepassing op:SQL Server

Geeft de inhoud van één of meer tracebestanden in tabelvorm terug.

Important

Deze functie wordt verwijderd in een toekomstige versie van SQL Server. Vermijd het gebruik van deze functie in nieuwe ontwikkelwerkzaamheden en plan om toepassingen te wijzigen die momenteel gebruikmaken van deze functie. Gebruik in plaats daarvan uitgebreide gebeurtenissen.

Transact-SQL syntaxis-conventies

Syntax

  
fn_trace_gettable ( 'filename' , number_files )

Arguments

'bestandsnaam'
Specificeert het initiële tracebestand dat gelezen moet worden. Bestandsnaam is nvarchar(256), zonder standaard.

number_files
Specificeert het aantal rollover-bestanden dat gelezen moet worden. Dit nummer bevat het initiële bestand dat in de bestandsnaam is gespecificeerd. number_files is een int.

Remarks

Als number_files als standaard is opgegeven, leest fn_trace_gettable alle rollover-bestanden totdat het het einde van de trace bereikt. fn_trace_gettable geeft een tabel terug met alle kolommen geldig voor het opgegeven spoor. Voor meer informatie, zie sp_trace_setevent (Transact-SQL).

Wees je ervan bewust dat de fn_trace_gettable-functie geen rollover-bestanden zal laden (wanneer deze optie wordt gespecificeerd met het number_files-argument ) waarbij de oorspronkelijke trace-bestandsnaam eindigt met een underscore en een numerieke waarde. (Dit geldt niet voor de onderscore en het nummer die automatisch worden toegevoegd wanneer een bestand wordt overgezet.) Als oplossing kun je de trace-bestanden hernoemen om de onderscores in de oorspronkelijke bestandsnaam te verwijderen. Als het originele bestand bijvoorbeeld Trace_Oct_5.trc heet en het rolloverbestand Trace_Oct_5_1.trc, kun je de bestanden hernoemen naar TraceOct5.trc en TraceOct5_1.trc.

Deze functie kan een trace lezen die nog actief is op de instantie waarop deze wordt uitgevoerd.

Permissions

Vereist ALTER TRACE-machtiging op de server.

Examples

A. Het gebruik van fn_trace_gettable om rijen uit een tracebestand te importeren

Het volgende voorbeeld roept fn_trace_gettable binnen de FROM clausule van een SELECT...INTO statement.

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

B. Met fn_trace_gettable een tabel retourneren met een IDENTITY kolom die in een SQL Server tabel geladen kan worden

Het volgende voorbeeld roept de functie aan als onderdeel van een SELECT...INTO instructie en geeft een tabel terug met een IDENTITY kolom die in de tabel temp_trcgeladen kan worden.

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

Zie ook

sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)
sp_trace_setstatus (Transact-SQL)

  • Last updated on