core.sp_update_data_source (Transact-SQL)

Статья
06/18/2013

Обновляет существующую строку или вставляет новую строку в таблицу 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 имеет тип uniqueidentifier и не имеет значения по умолчанию. Чтобы получить идентификатор 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 имеет тип smallint.
[ @source\_id = ] source_id
Уникальный идентификатор для источника обновления. source_id имеет тип int и возвращается как переменная OUTPUT.

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

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;

См. также

Справочник

Системные хранимые процедуры (Transact-SQL)

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

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

Хранилище данных управления

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