sp_syscollector_run_collection_set (Transact-SQL)

Запускает набор сбора в случае, если сборщик данных уже включен, а набор сбора настроен на сбор без кэширования.

Примечание
Эта процедура завершится со сбоем, если она будет запущена для набора сбора, настроенного на сбор с кэшированием.

Хранимая процедура sp_syscollector_run_collection_set позволяет пользователю создавать моментальные снимки данных по запросу.

Синтаксические обозначения Transact-SQL

Синтаксис

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

Аргументы

• [ @collection_set_id = ] collection_set_id
  Уникальный локальный идентификатор набора элементов сбора. Аргумент collection_set_id имеет тип int и должен иметь значение, если аргумент name имеет значение NULL.

• [ @name = ] 'name'
  Имя набора элементов сбора. Аргумент name имеет тип sysname и должен иметь значение, если аргумент 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

См. также

Справочник

Системные хранимые процедуры (Transact-SQL)

Основные понятия

Сбор данных