sp_syscollector_start_collection_set (Transact-SQL)

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

Cинтаксические обозначения в 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;

См. также

Справочник

Хранимые процедуры сборщика данных (Transact-SQL)

syscollector_collection_sets (Transact-SQL)

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

Сбор данных