次の方法で共有


sp_syscollector_start_collection_set (Transact-SQL)

適用対象: SQL Server

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

Transact-SQL 構文表記規則

構文

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

引数

[ @collection_set_id = ] collection_set_id

コレクション セットの一意のローカル識別子。 @collection_set_idint で、既定値は NULL です。 @nameNULL場合、@collection_set_idには値が必要です。

[ @name = ] N'name'

コレクション セットの名前。 @namesysname で、既定値は NULL です。 @collection_set_idNULL場合、@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;