sp_syscollector_run_collection_set (Transact-SQL)

適用於:SQL Server

如果收集器已啟用,就會啟動收集組,而且收集組已設定為非快取收集模式。

注意

如果針對針對快取收集模式設定的收集組執行此程式,則此程式會失敗。

sp_syscollector_run_collection_set 可讓使用者取得隨選數據快照集。

Transact-SQL 語法慣例

語法

sp_syscollector_run_collection_set
    [ [ @collection_set_id = ] collection_set_id ]
    [ , [ @name = ] N'name' ]
[ ; ]

引數

[ @collection_set_id = ] collection_set_id

收集組的唯一本機標識碼。 @collection_set_id為 int,預設值NULL為 ,且如果 @nameNULL,就必須有 值。

[ @name = ] N'name'

收集組的名稱。 @name為 sysname,預設值NULL為 ,如果 @collection_set_idNULL,則必須有值。

傳回碼值

0 (成功)或 1 (失敗)。

備註

@collection_set_id或@name必須有值,兩者都不能是 NULL

此程式會啟動集合並上傳指定收集組的工作,如果收集組已 將其@collection_mode 設定為非快取 ,1則立即啟動收集代理程序作業。 如需詳細資訊,請參閱 sp_syscollector_create_collection_set (Transact-SQL)

sp_sycollector_run_collection_set 也可以用來執行沒有排程的收集組。

權限

需要dc_operator的成員資格(具有 EXECUTE 許可權)固定資料庫角色才能執行此程式。

範例

使用其標識碼啟動收集組。

USE msdb;
GO
EXEC sp_syscollector_run_collection_set
    @collection_set_id = 1;