sp_syscollector_start_collection_set (Transact-SQL)
如果收集器已經啟用而且收集組並未執行中,就會啟動收集組。 如果收集器尚未啟用,請執行 sp_syscollector_enable_collector 來啟用收集器,然後使用這個預存程序來啟動收集組。
語法
sp_syscollector_start_collection_set
[ [ @collection_set_id = ] collection_set_id ]
, [[ @name = ] 'name' ]
引數
[ @collection\_set\_id = ] collection_set_id
這是收集組的唯一本機識別碼。 collection_set_id 是 int 預設值為 NULL。 若 name 為 NULL 時,collection_set_id 就必須具有值。[ @name = ] 'name'
這是收集組的名稱。 name 是 sysname 預設值為 NULL。 若 collection_set_id 為 NULL 時,name 就必須具有值。
傳回碼值
0 (成功) 或 1 (失敗)
備註
sp_syscollector_create_collection_set 必須在 msdb 系統資料庫的內容中執行,而且 SQL Server Agent 必須已啟用。
如果此程序是針對沒有排程的收集組來執行,此程序就會失敗。 如果收集組沒有排程 (例如,因為它的收集模式設定為非快取),請使用 sp_syscollector_run_collection_set 預存程序來啟動收集組。
這個程序會針對指定的收集組啟用收集和上傳作業,而且如果收集組將其收集模式設定為快取 (0),此程序將立即啟動收集代理程式作業。 如需詳細資訊,請參閱<sp_syscollector_create_collection_set>。
如果收集組未包含任何收集項,這項作業沒有任何作用。 就會傳回錯誤 14685 當做警告。
權限
需要 dc_operator 固定資料庫角色中的成員資格,才能執行此程序。 如果收集組沒有 Proxy 帳戶,就需要系統管理員 (sysadmin) 固定伺服器角色中的成員資格。
範例
下列範例會開始一個收集組,其方式是使用此收集組的識別碼。
USE msdb;
GO
EXEC sp_syscollector_start_collection_set @collection_set_id = 1;
請參閱
參考
syscollector_collection_sets (Transact-SQL)