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

  • Статья

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;