sp_syscollector_run_collection_set (Transact-SQL)

適用於:SQL Server

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

注意

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

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

Transact-SQL 語法慣例

語法

dbo.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為 ,且如果 @name 為 NULL,就必須有 值。

[ @name = ] N'name'

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

傳回碼值

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

備註

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

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

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

權限

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

範例

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

USE msdb;
GO

EXECUTE sp_syscollector_run_collection_set @collection_set_id = 1;