Поделиться через


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_id.NULL

Значения кода возврата

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;