次の方法で共有

sp_syscollector_start_collection_set (Transact-SQL)

  • [アーティクル]

コレクターが既に有効になっており、コレクション セットがまだ実行されていない場合、コレクション セットを開始します。 コレクターが有効になっていない場合は、sp_syscollector_enable_collector を実行してコレクターを有効にした後、このストアド プロシージャを使用してコレクション セットを開始します。

トピック リンク アイコン Transact-SQL 構文表記規則

構文

sp_syscollector_start_collection_set 
    [ [ @collection_set_id = ] collection_set_id ]
    , [[ @name = ] 'name' ]

引数

  • [ @collection\_set\_id = ] collection_set_id
    コレクション セットの一意なローカル識別子を指定します。 collection_set_id のデータ型は int で、既定値は NULL です。 name が NULL の場合は必ず collection_set_id の値を指定する必要があります。

  • [ @name = ] 'name'
    コレクション セットの名前を指定します。 name のデータ型は sysname で、既定値は NULL です。 collection_set_id が NULL の場合は必ず name の値を指定する必要があります。

リターン コードの値

0 (成功) または 1 (失敗)

説明

sp_syscollector_create_collection_set を msdb システム データベースのコンテキストで実行し、SQL Server エージェントを有効にする必要があります。

このプロシージャをスケジュールがないコレクション セットに対して実行すると、失敗します。 コレクション セットにスケジュールがない場合は (コレクション モードが非キャッシュに設定されている場合など)、sp_syscollector_run_collection_set ストアド プロシージャを使用してコレクション セットを開始します。

このプロシージャは、コレクションを有効にし、指定されたコレクション セットのジョブをアップロードして、コレクション セットのコレクション モードがキャッシュ (0) に設定されている場合は、直ちにコレクション エージェント ジョブを開始します。 詳細については、「sp_syscollector_create_collection_set」を参照してください。

コレクション セットにコレクション アイテムが含まれていない場合、この操作には何も効果がありません。 警告としてエラー 14685 が返されます。

権限

このプロシージャを実行するには、dc_operator 固定データベース ロールのメンバーシップが必要です。 コレクション セットにプロキシ アカウントがない場合は、sysadmin 固定サーバー ロールのメンバーシップが必要です。

使用例

次の例では、識別子を使用してコレクション セットを開始します。

USE msdb;
GO
EXEC sp_syscollector_start_collection_set @collection_set_id = 1;

関連項目

参照

データ コレクター ストアド プロシージャ (Transact-SQL)

syscollector_collection_sets (Transact-SQL)

概念

データ コレクション