Share via


sp_syscollector_start_collection_set (Transact-SQL)

適用於:SQL Server

如果收集器已啟用且收集組未執行,就會啟動收集組。 如果未啟用收集器,請執行 sp_syscollector_enable_collector 啟用收集器,然後使用這個預存程序啟動收集組。

Transact-SQL 語法慣例

語法

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

引數

[ @collection_set_id = ] collection_set_id

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

[ @name = ] N'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 帳戶,則需要系統管理員固定伺服器角色中的成員資格。

範例

下列範例會使用其標識碼啟動收集組。

USE msdb;
GO
EXEC sp_syscollector_start_collection_set @collection_set_id = 1;