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

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';

См. также

Справочник

sp_syscollector_create_collection_item (Transact-SQL)

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

syscollector_collection_items (Transact-SQL)

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

Сбор данных