sys.fn_trace_gettable (T-SQL)

Artikel
08/21/2023

Berlaku untuk: SQL Server

Mengembalikan konten satu atau beberapa file pelacakan dalam bentuk tabular.

Penting

Fitur ini akan dihapus dalam versi SQL Server yang akan datang. Hindari menggunakan fitur ini dalam pekerjaan pengembangan baru, dan rencanakan untuk memodifikasi aplikasi yang saat ini menggunakan fitur ini. Gunakan Extended Events sebagai gantinya.

Konvensi sintaks transact-SQL

Sintaks

  
fn_trace_gettable ( 'filename' , number_files )

Argumen

'nama file'
Menentukan file pelacakan awal yang akan dibaca. nama file adalah nvarchar(256), tanpa default.

number_files
Menentukan jumlah file rollover yang akan dibaca. Nomor ini mencakup file awal yang ditentukan dalam nama file. number_files adalah int.

Keterangan

Jika number_files ditentukan sebagai default, fn_trace_gettable membaca semua file rollover hingga mencapai akhir jejak. fn_trace_gettable mengembalikan tabel dengan semua kolom yang valid untuk pelacakan yang ditentukan. Untuk informasi selengkapnya, lihat sp_trace_setevent (Transact-SQL).

Ketahuilah bahwa fungsi fn_trace_gettable tidak akan memuat file rollover (ketika opsi ini ditentukan dengan menggunakan argumen number_files ) di mana nama file jejak asli berakhir dengan garis bawah dan nilai numerik. (Ini tidak berlaku untuk garis bawah dan angka yang secara otomatis ditambahkan ketika file bergulir.) Sebagai solusinya, Anda dapat mengganti nama file jejak untuk menghapus garis bawah dalam nama file asli. Misalnya, jika file asli diberi nama Trace_Oct_5.trc dan file rollover diberi nama Trace_Oct_5_1.trc, Anda dapat mengganti nama file menjadi TraceOct5.trc dan TraceOct5_1.trc.

Fungsi ini dapat membaca jejak yang masih aktif pada instans tempatnya dijalankan.

Izin

Memerlukan izin ALTER TRACE pada server.

Contoh

J. Menggunakan fn_trace_gettable untuk mengimpor baris dari file pelacakan

Contoh berikut memanggil di dalam FROM klausul fn_trace_gettable SELECT...INTO pernyataan.

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

B. Menggunakan fn_trace_gettable untuk mengembalikan tabel dengan kolom IDENTITY yang dapat dimuat ke dalam tabel SQL Server

Contoh berikut memanggil fungsi sebagai bagian SELECT...INTO dari pernyataan dan mengembalikan tabel dengan IDENTITY kolom yang dapat dimuat ke dalam tabel 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

Lihat Juga

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

Bagikan melalui