core.sp_update_data_source (Transact-SQL)

  • 發行項

適用於：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為 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;

相關內容