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


sp_syscollector_start_collection_set (Transact-SQL)

Область применения: SQL Server

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @collection_set_id = ] collection_set_id

Уникальный локальный идентификатор набора коллекций. @collection_set_id имеет значение int с значением по умолчаниюNULL. @collection_set_id должно иметь значение, если @name NULL.

[ @name = ] N'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;