core.sp_update_data_source (Transact-SQL)

Статья
12/22/2023

Применимо к:SQL Server

Обновления существующей строке или вставляет новую строку в таблицу хранилища core.source_info_internal данных управления. Эта процедура вызывается компонентом времени выполнения сборщика данных каждый раз, когда пакет передачи начинает загружать данные в хранилище данных управления.

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

Синтаксис

core.sp_update_data_source [ @collection_set_uid = ] 'collection_set_uid'
    , [ @machine_name = ] 'machine_name'
    , [ @named_instance = ] 'named_instance'
    , [ @days_until_expiration = ] days_until_expiration
    , [ @source_id = ] source_id OUTPUT
[ ; ]

Аргументы

[ @collection_set_uid = ] 'collection_set_uid'

Имеет значение GUID для набора элементов сбора. @collection_set_uid является уникальным идентификатором без значения по умолчанию. Чтобы получить GUID, запросите представление dbo.syscollector_collection_sets в msdb базе данных.

[ @machine_name = ] 'machine_name'

Имя сервера, на котором находится набор элементов сбора. @machine_name — sysname без значения по умолчанию.

[ @named_instance = ] 'named_instance'

Имя экземпляра набора элементов сбора. @named_instance — sysname без значения по умолчанию.

Примечание.

named_instance должно быть полным именем экземпляра, которое состоит из имени компьютера и имени экземпляра в форме<computername>\<instancename>.

[ @days_until_expiration = ] days_until_expiration

Количество дней, остающихся до окончания срока хранения данных в моментальном снимке. @days_until_expiration меньше.

[ @source_id = ] source_id

Уникальный идентификатор для источника обновления. @source_id имеет значение int и возвращается в виде выходных данных.

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

0 (успешно) или 1 (сбой).

Замечания

Каждый раз, когда пакет отправки начинает отправлять данные в хранилище данных управления, вызов компонента core.sp_update_data_sourceвремени выполнения сборщика данных. Таблица core.source_info_internal обновляется, если одно из следующих изменений произошло с момента последней отправки:

Был добавлен новый набор элементов сбора.
Изменилось значение days_until_expiration.

Разрешения

Требуется членство в предопределенных ролевые роли базы данных mdw_writer (с разрешением EXECUTE).

Примеры

В следующем примере обновляется источник данных (в данном случае — набор сбора «Занято места на диске»), устанавливается новое количество дней до истечения срока и возвращается идентификатор источника. В примере используется экземпляр по умолчанию.

USE <management_data_warehouse>;
GO
DECLARE @source_id INT;

EXEC core.sp_update_data_source @collection_set_uid = '7B191952-8ECF-4E12-AEB2-EF646EF79FEF',
    @machine_name = '<computername>',
    @named_instance = 'MSSQLSERVER',
    @days_until_expiration = 10,
    @source_id = @source_id OUTPUT;

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