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

  • Статья

sp_syscollector_start_collection_set (Transact-SQL)

Запускает набор сбора в том случае, если сборщик данных уже включен, но набор сбора еще не работает. Если сборщик не включен, включите его, выполнив функцию sp_syscollector_enable_collector, а затем запустите набор сбора при помощи этой хранимой процедуры.

Значок ссылки на разделСоглашение о синтаксисе в Transact-SQL

Синтаксис

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

Аргументы

  • [ @collection\_set\_id = ] collection_set_id
    Уникальный локальный идентификатор набора сбора. Параметр collection_set_id имеет тип int со значением по умолчанию NULL. Параметр collection_set_id должен иметь значение, если значение параметра name равно NULL.

  • [ @name = ] 'name'
    Имя набора сбора. Параметр name имеет тип sysname со значением по умолчанию NULL. Параметр name должен иметь значение, если значение параметра collection_set_id равно NULL.

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

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Функция sp_syscollector_create_collection_set должна выполняться в контексте системной базы данных msdb, а агент SQL Server должен быть включен.

Эта процедура завершится с ошибкой при запуске с набором сбора, для которого нет расписания. Если набор сбора не имеет расписания (например, потому что для него установлен режим сбора без кэширования), для его запуска используйте хранимую процедуру sp_syscollector_run_collection_set.

Данная процедура включает задания сбора и передачи данных для заданного набора сбора, а также немедленно запускает задание агента сбора, если для этого набора сбора значение параметра равно 0 (режим сбора с кэшированием). Дополнительные сведения см. в разделе sp_syscollector_create_collection_set.

Если набор сбора не содержит каких-либо элементов, эта операция не действует. В качестве предупреждения возвращается ошибка 14685.

Разрешения

Для выполнения этой процедуры требуется членство в предопределенной роли базы данных dc_operator. Если набор сбора не имеет учетной записи-посредника, требуется членство в предопределенной роли сервера sysadmin.

Примеры

В следующем примере запуск набора сбора осуществляется с помощью его идентификатора.

USE msdb;
GO
EXEC sp_syscollector_start_collection_set @collection_set_id = 1;