sys.fn_trace_getinfo (T-SQL)
Berlaku untuk: SQL Server
Mengembalikan informasi tentang jejak tertentu atau semua jejak yang ada.
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.
Sintaks
sys.fn_trace_getinfo ( { trace_id | NULL | 0 | DEFAULT } )
Argumen
trace_id
Adalah ID pelacakan. trace_id int. Input yang valid adalah nomor ID pelacakan, NULL, 0, atau DEFAULT. NULL, 0, dan DEFAULT adalah nilai yang setara dalam konteks ini. Tentukan NULL, 0, atau DEFAULT untuk mengembalikan informasi untuk semua jejak dalam instans SQL Server.
Tabel yang Dikembalikan
Nama kolom | Jenis data | Deskripsi |
---|---|---|
traceid | int | ID pelacakan. |
properti | int | Properti jejak: 1= Opsi pelacakan. Untuk informasi selengkapnya, lihat @options di sp_trace_create (Transact-SQL). 2 = Nama file 3 = Ukuran maksimum 4 = Waktu berhenti 5 = Status pelacakan saat ini. 0 = berhenti. 1 = berjalan. |
value | aql_variant | Informasi tentang properti jejak yang ditentukan. |
Keterangan
Saat melewati ID pelacakan tertentu, fn_trace_getinfo mengembalikan informasi tentang jejak tersebut. Ketika melewati ID yang tidak valid, fungsi ini mengembalikan set baris kosong.
fn_trace_getinfo menambahkan ekstensi .trc ke nama file jejak apa pun yang disertakan dalam tataan hasilnya. Untuk informasi tentang menentukan jejak, lihat sp_trace_create (Transact-SQL). Untuk informasi serupa tentang filter pelacakan, lihat sys.fn_trace_getfilterinfo (Transact-SQL).
Untuk contoh lengkap penggunaan prosedur tersimpan jejak, lihat Membuat Jejak (Transact-SQL).
Izin
Memerlukan izin ALTER TRACE pada server.
Contoh
Contoh berikut mengembalikan informasi tentang semua jejak aktif.
SELECT * FROM sys.fn_trace_getinfo(0) ;
GO
Lihat Juga
Membuat Jejak (Transact-SQL)
sp_trace_create (T-SQL)
sp_trace_generateevent (T-SQL)
sp_trace_setevent (T-SQL)
sp_trace_setfilter (T-SQL)
sp_trace_setstatus (T-SQL)
sys.fn_trace_getfilterinfo (T-SQL)
sys.fn_trace_geteventinfo (T-SQL)
sys.fn_trace_gettable (T-SQL)