修改指定的跟蹤的當前狀態(tài)。
sp_trace_setstatus [ @traceid = ] trace_id
, [ @status = ] status
[ @traceid = ] trace_id
是要修改的跟蹤 ID。trace_id 的數據類型為 int,沒有默認設置。用戶使用 trace_id 值識別、修改和控制跟蹤。
[ @status = ] status
指定要在跟蹤上執(zhí)行的操作。status 的數據類型為 int,沒有默認設置。
下表列出了可以指定的狀態(tài)。
狀態(tài) | 描述 |
---|---|
0 | 停止指定的跟蹤。 |
1 | 啟動指定的跟蹤。 |
2 | 關閉指定的跟蹤并從服務器中刪除其定義。 |
說明 在關閉跟蹤前首先必須先停止它。
下表描述在存儲過程完成之后用戶可能獲得的代碼值。
返回代碼 | 描述 |
---|---|
0 | 沒有錯誤。 |
1 | 未知錯誤。 |
8 | 指定的狀態(tài)無效。 |
9 | 指定的跟蹤句柄無效。 |
13 | 內存不足。在沒有足夠內存執(zhí)行指定的操作時返回此代碼。 |
如果跟蹤已經處于指定的狀態(tài),則 SQL Server 將返回 0。
sp_trace_setstatus 是 Microsoft SQL Server 2000 存儲過程,它執(zhí)行以前由 SQL Server 早期版本中使用的 xp_trace_* 擴展存儲過程執(zhí)行的許多操作。使用 sp_trace_setstatus 而不使用:
嚴格地鍵入所有 SQL 跟蹤存儲過程 (sp_trace_xx) 的參數。如果沒有用正確的輸入參數數據類型(與在參數說明中指定的相同)調用這些參數,則存儲過程將返回錯誤。
只有 sysadmin 固定服務器角色成員才能執(zhí)行 sp_trace_setstatus。