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 で、既定値はありません。

Note

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 の値が変更された。

アクセス許可

(EXECUTE 権限を持つ) mdw_writer固定データベース ロールのメンバーシップが必要です。

例

次の例では、データ ソース (この場合は Disk Usage コレクション セット) を更新し、有効期限までの日数を設定し、ソースの識別子を返します。 この例では、既定のインスタンスが使用されています。

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;

関連するコンテンツ