Udostępnij za pośrednictwem

  • Artykuł

fn_trace_gettable (Transact-SQL)

Zwraca zawartość jednego lub większej liczby plików śledzenia w formie tabeli.

Topic link iconKonwencje składni języka Transact-SQL

fn_trace_gettable ( 'filename' , number_files )

Argumenty

  • 'filename'
    Specifies the initial trace file to be read.filename is nvarchar(256), with no default.

  • number_files
    Określa liczbę plików najazdu do odczytu.This number includes the initial file specified in filename.number_files is an int.

Remarks

If number_files is specified as default, fn_trace_gettable reads all rollover files until it reaches the end of the trace.fn_trace_gettable returns a table with all the columns valid for the specified trace.Aby uzyskać więcej informacji zobaczsp_trace_setevent (Transact-SQL).

Należy pamiętać, że funkcja fn_trace_gettable nie będzie ładował pliki najazdu (Jeśli ta opcja zostanie użyty przy użyciu number_files argument) w przypadku gdy oryginalną nazwę plik śledzenia kończy się z podkreśleniem i wartość liczbową. (To nie ma zastosowania do podkreślenia i liczby, które są dołączane automatycznie, kiedy plik toczy się.) Aby uniknąć tego problemu można zmienić nazwy plików śledzenia, aby usunąć podkreślenia w oryginalnej nazwy pliku. Na przykład, jeśli oryginalny plik nosi nazwę Trace_Oct_5.TRC nosi i plik przerzucaniaTrace_Oct_5_1.TRC, można zmienić nazwy plików do TraceOct5.trc and TraceOct5_1.trc.

Ta funkcja może odczytywać śledzenia, który jest nadal aktywne w wystąpieniu, na którym jest wykonywane.

Uprawnienia

Wymaga ALTER TRACE uprawnień na serwerze.

Przykłady

A.Za pomocą fn_trace_gettable w celu zaimportowania wiersze z plik śledzenia

Następujący przykład wywołania fn_trace_gettable wewnątrz FROM Klauzula SELECT...INTO Instrukcja.

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

B.Aby powrócić do tabela z kolumną identyfikacji, które mogą być ładowane do tabela programu SQL Server przy użyciu fn_trace_gettable

W poniższym przykładzie wywołuje funkcja w ramach SELECT...INTO Instrukcja i zwraca tabela z IDENTITY kolumna, które mogą być ładowane do tabela 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

Historia zmian

Microsoft Learning

Aktualizowana sekcję Spostrzeżenia informacji na temat zachowania pliku najazdu zakończona oryginalną nazwę plik śledzenia z podkreśleniem i wartość liczbową.