sp_trace_setstatus (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Memodifikasi status pelacakan yang ditentukan saat ini.

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

sp_trace_setstatus
    [ @traceid = ] traceid
    , [ @status = ] status
[ ; ]

Argumen

[ @traceid = ] traceid

ID jejak yang akan dimodifikasi. @traceid int, tanpa default. Pengguna menggunakan nilai @traceid ini untuk mengidentifikasi, memodifikasi, dan mengontrol jejak. Untuk informasi tentang mengambil @traceid, lihat sys.fn_trace_getinfo (Transact-SQL).

[ @status = ] status

Menentukan tindakan yang akan diterapkan pada jejak. @status int, tanpa default.

Tabel berikut mencantumkan status yang mungkin ditentukan.

Keadaan Deskripsi
0 Menghentikan jejak yang ditentukan.
1 Memulai jejak yang ditentukan.
2 Menutup jejak yang ditentukan dan menghapus definisinya dari server.

Catatan

Jejak harus dihentikan terlebih dahulu sebelum dapat ditutup. Jejak harus dihentikan dan ditutup terlebih dahulu sebelum dapat dilihat.

Mengembalikan nilai kode

Tabel berikut ini menjelaskan nilai kode yang mungkin didapatkan pengguna setelah menyelesaikan prosedur tersimpan.

Mengembalikan kode Deskripsi
0 Tidak ada kesalahan.
1 Kesalahan tidak diketahui.
8 Status yang ditentukan tidak valid.
9 Trace Handle yang ditentukan tidak valid.
13 Kehabisan memori. Dikembalikan ketika tidak ada cukup memori untuk melakukan tindakan yang ditentukan.

Jika jejak sudah dalam status yang ditentukan, SQL Server mengembalikan 0.

Keterangan

Parameter semua prosedur tersimpan SQL Trace (sp_trace_*) diketik secara ketat. Jika parameter ini tidak dipanggil dengan jenis data parameter input yang benar, seperti yang ditentukan dalam deskripsi argumen, prosedur tersimpan mengembalikan kesalahan.

Untuk contoh penggunaan prosedur tersimpan jejak, lihat Membuat Jejak (Transact-SQL).

Izin

Memerlukan izin ALTER TRACE.

Konten terkait