core.sp_update_data_source (Transact-SQL)
適用於:SQL Server
更新現有的數據列,或在管理數據倉儲數據表中插入新的數據列 core.source_info_internal
。 每次上傳套件開始將數據上傳至管理數據倉儲時,數據收集器運行時間元件都會呼叫此程式。
語法
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;