sp_syscollector_start_collection_set (Transact-SQL)
適用対象: SQL Server
コレクターが既に有効になっていて、コレクション セットが実行されていない場合は、コレクション セットを開始します。 コレクターが有効になっていない場合は、 sp_syscollector_enable_collector を実行してコレクターを有効にしてから、このストアド プロシージャを使用してコレクション セットを開始します。
構文
sp_syscollector_start_collection_set
[ [ @collection_set_id = ] collection_set_id ]
[ , [ @name = ] N'name' ]
[ ; ]
引数
[ @collection_set_id = ] collection_set_id
コレクション セットの一意のローカル識別子。 @collection_set_id は int で、既定値は NULL
です。 @nameがNULL
場合、@collection_set_idには値が必要です。
[ @name = ] N'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;