sp_syscollector_start_collection_set (Transact-SQL)sp_syscollector_start_collection_set (Transact-SQL)

適用対象:○SQL Server (2008 以降)×Azure SQL Database×Azure SQL Data Warehouse ×Parallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

コレクターが既に有効になっており、コレクション セットがまだ実行されていない場合、コレクション セットを開始します。Starts a collection set if the collector is already enabled and the collection set is not running. コレクターが有効でない場合は、実行して、コレクターを有効にsp_syscollector_enable_collectorし、このストアド プロシージャを使用して、コレクション セットを開始します。If the collector is not enabled, enable the collector by running sp_syscollector_enable_collector and then use this stored procedure to start a collection set.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax


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

引数Arguments

[ @collection_set_id = ] collection_set_id[ @collection_set_id = ] collection_set_id
コレクション セットの一意なローカル識別子を指定します。Is the unique local identifier for the collection set. collection_set_idintで、既定値は NULL です。collection_set_id is int with a default value of NULL. collection_set_id場合、値が必要名前は NULL です。collection_set_id must have a value if name is NULL.

[ @name = ] '名前'[ @name = ] 'name'
コレクション セットの名前を指定します。Is the name of the collection set. 名前sysnameで、既定値は NULL です。name is sysname with a default value of NULL. 名前場合、値が必要collection_set_idは NULL です。name must have a value if collection_set_id is NULL.

リターン コードの値Return Code Values

0 (成功) または1 (失敗)0 (success) or 1 (failure)

解説Remarks

sp_syscollector_create_collection_set を msdb システム データベースのコンテキストで実行し、SQL Server エージェントを有効にする必要があります。sp_syscollector_create_collection_set must be run in the context of the msdb system database and SQL Server Agent must be enabled.

このプロシージャをスケジュールがないコレクション セットに対して実行すると、失敗します。This procedure fails when run against a collection set that does not have a schedule. 場合、コレクション セットが、スケジュール (コレクション モード設定されているために非キャッシュなど) を使用して、 sp_syscollector_run_collection_setストアド プロシージャをコレクション セットを開始します。If the collection set does not have a schedule (because its collection mode is set to non-cached, for example), use the sp_syscollector_run_collection_set stored procedure to start the collection set.

このプロシージャは、コレクションを有効にし、指定されたコレクション セットのジョブをアップロードして、コレクション セットのコレクション モードがキャッシュ (0) に設定されている場合は、直ちにコレクション エージェント ジョブを開始します。This procedure enables the collection and upload jobs for the specified collection set, and will immediately start the collection agent job if the collection set has its collection mode set to cached (0). 詳細については、次を参照してください。 sp_syscollector_create_collection_setです。For more information, see sp_syscollector_create_collection_set.

コレクション セットにコレクション アイテムが含まれていない場合、この操作には何も効果がありません。If the collection set does not contain any collection items, this operation has no effect. 警告としてエラー 14685 が返されます。Error 14685 is returned as a warning.

権限Permissions

このプロシージャを実行するには、dc_operator 固定データベース ロールのメンバーシップが必要です。Requires membership in the dc_operator fixed database role to execute this procedure. コレクション セットにプロキシ アカウントがない場合は、sysadmin 固定サーバー ロールのメンバーシップが必要です。If the collection set does not have a proxy account, membership in the sysadmin fixed server role is required.

使用例Examples

次の例では、識別子を使用してコレクション セットを開始します。The following example starts a collection set using its identifier.

USE msdb;  
GO  
EXEC sp_syscollector_start_collection_set @collection_set_id = 1;  

参照See Also

データ コレクター ストアド プロシージャ (Transact-SQL) Data Collector Stored Procedures (Transact-SQL)
データ コレクション Data Collection
syscollector_collection_sets (Transact-SQL)syscollector_collection_sets (Transact-SQL)