sys.fn_trace_gettable (Transact-SQL)

platí pro:SQL Server

Vrací obsah jednoho nebo více sledovacích souborů v tabulkové podobě.

Important

Tato funkce bude odebrána v budoucí verzi SQL Serveru. Nepoužívejte tuto funkci v nové vývojové práci a naplánujte úpravu aplikací, které tuto funkci aktuálně používají. Místo toho použijte Rozšířené události.

Transact-SQL konvence syntaxe

Syntax

  
fn_trace_gettable ( 'filename' , number_files )

Arguments

'název souboru'
Specifikuje počáteční trace soubor, který má být načten. Název souboru je nvarchar(256), bez výchozího nastavení.

number_files
Určuje počet souborů rolloveru, které mají být čteny. Toto číslo zahrnuje počáteční soubor uvedený v názvu souboru. number_files je int.

Remarks

Pokud je number_files nastaveno jako výchozí, fn_trace_gettable čte všechny rollover soubory, dokud nedojde na konec stopy. fn_trace_gettable vrátí tabulku se všemi sloupci platnými pro zadanou stopu. Pro více informací viz sp_trace_setevent (Transact-SQL).

Mějte na paměti, že funkce fn_trace_gettable nenačítá rollover soubory (pokud je tato možnost specifikována pomocí argumentu number_files ), kde původní název trace souboru končí podtržítkem a číselnou hodnotou. (To se nevztahuje na podtržítko a číslo, které jsou automaticky přidány při převedení souboru.) Jako obcházení můžete přejmenovat soubory stopování tak, aby se odstranily podtržítka v původním názvu souboru. Například pokud je původní soubor pojmenován Trace_Oct_5.trc a rollover soubor Trace_Oct_5_1.trc, můžete soubory přejmenovat na TraceOct5.trc a TraceOct5_1.trc.

Tato funkce dokáže číst stopu, která je stále aktivní na instanci, na které je vykonána.

Permissions

Vyžaduje na serveru oprávnění ALTER TRACE.

Examples

A. Použití fn_trace_gettable k importu řádků ze sledovacího souboru

Následující příklad volá fn_trace_gettable uvnitř klauzule FROM tvrzení SELECT...INTO .

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

B. Použitím fn_trace_gettable pro vrácení tabulky s sloupcemIDENTITY, který lze načíst do SQL Server tabulky

Následující příklad volá funkci jako součást příkazu SELECT...INTO a vrací tabulku se sloupcem IDENTITY , který lze načíst do tabulky 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

Související obsah

  • Last updated on