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

  • Статья

sp_syscollector_delete_collection_item (Transact-SQL)

Удаляет элемент сбора из набора сбора.

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

Синтаксис

sp_syscollector_delete_collection_item [[ @collection_item_id = ] collection_item_id ]
        , [[ @name = ] 'name' ]

Аргументы

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

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

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

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

Замечания

Функция sp_syscollector_delete_collection_item должна выполняться в контексте системной базы данных msdb. Удалять элементы сбора из системных наборов сбора невозможно.

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

Разрешения

Для выполнения этой процедуры требуется членство в предопределенной роли базы данных dc_admin (с разрешением EXECUTE).

Примеры

В следующем примере удаляется элемент сбора с именем MyCollectionItem1.

USE msdb;
GO
EXEC sp_syscollector_delete_collection_item @name = 'MyCollectionItem1';