sys.fn_trace_gettable (Transact-SQL)

Gäller för:SQL Server

Returnerar innehållet i en eller flera spårfiler i tabellform.

Important

Den här funktionen tas bort i en framtida version av SQL Server. Undvik att använda den här funktionen i nytt utvecklingsarbete och planera att ändra program som för närvarande använder den här funktionen. Använd utökade händelser i stället.

Transact-SQL syntaxkonventioner

Syntax

  
fn_trace_gettable ( 'filename' , number_files )

Arguments

'filnamn'
Specificerar den initiala spårfilen som ska läsas. Filnamnet är nvarchar(256), utan standard.

number_files
Specificerar antalet rollover-filer som ska läsas. Detta nummer inkluderar den initiala filen som anges i filnamnet. number_files är en int.

Remarks

Om number_files anges som standard läser fn_trace_gettable alla rollover-filer tills den når slutet av spårningen. fn_trace_gettable returnerar en tabell med alla kolumner giltiga för den specificerade spårningen. För mer information, se sp_trace_setevent (Transact-SQL).

Var medveten om att fn_trace_gettable-funktionen inte laddar rollover-filer (när detta alternativ anges med number_files-argumentet ) där det ursprungliga spårfilnamnet slutar med ett understreck och ett numeriskt värde. (Detta gäller inte understreck och nummer som automatiskt läggs till när en fil rullas över.) Som en lösning kan du byta namn på spårfilerna för att ta bort understrecken i det ursprungliga filnamnet. Till exempel, om originalfilen heter Trace_Oct_5.trc och rollover-filen heter Trace_Oct_5_1.trc, kan du byta namn på filerna till TraceOct5.trc och TraceOct5_1.trc.

Denna funktion kan läsa ett spår som fortfarande är aktivt på den instans där den körs.

Permissions

Kräver ALTER TRACE-behörighet på servern.

Examples

A. Att använda fn_trace_gettable för att importera rader från en spårfil

Följande exempel anropar fn_trace_gettable inuti FROM satsen i ett SELECT...INTO påstående.

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

B. Att använda fn_trace_gettable för att returnera en tabell med en IDENTITY kolumn som kan laddas in i en SQL Server tabell

Följande exempel anropar funktionen som en del av en SELECT...INTO sats och returnerar en tabell med en IDENTITY kolumn som kan laddas in i tabellen temp_trc.

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

Se även

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

  • Last updated on