core.sp_update_data_source (Transact-SQL)

在管理資料倉儲的 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，請查詢 msdb 資料庫中的 dbo.syscollector_collection_sets 檢視表。

• [ @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;

變更記錄

更新的內容
已更正第一個句子中的 core.source_info_internal 資料表名稱。
已更正「語法」一節中的 named_instance 引數名稱。
已更正「備註」一節中 core.source_info_internal 資料表和 days_until_expiration 引數的名稱。
已更正此範例中的 GUID、引數名稱和語法。

請參閱

參考

系統預存程序 (Transact-SQL)

資料收集器預存程序 (Transact-SQL)

概念

管理資料倉儲