컬렉션 집합에 컬렉션 항목 추가(Transact-SQL)Add a Collection Item to a Collection Set (Transact-SQL)

데이터 수집기와 함께 제공되는 저장 프로시저를 사용하여 기존 컬렉션 집합에 컬렉션 항목을 추가할 수 있습니다.You can add a collection item to an existing collection set using the stored procedures that are provided with the data collector.

SQL Server Management StudioSQL Server Management Studio의 쿼리 편집기를 사용하여 다음 단계를 수행해야 합니다.Carry out the following steps using Query Editor in SQL Server Management StudioSQL Server Management Studio.

컬렉션 집합에 컬렉션 항목 추가Add a collection item to a collection set

  1. sp_syscollector_stop_collection_set 저장 프로시저를 실행하여 항목을 추가할 컬렉션 집합을 중지합니다.Stop the collection set that you want to add the item to by running the sp_syscollector_stop_collection_set stored procedure. 예를 들어, "Test Collection Set"라는 컬렉션 집합을 중지하려면 다음 문을 실행합니다.For example, to stop a collection set that is named "Test Collection Set", run the following statements:

    USE msdb  
    DECLARE @csid int  
    SELECT @csid = collection_set_id  
    FROM syscollector_collection_sets  
    WHERE name = 'Test Collection Set'  
    SELECT @csid  
    EXEC dbo.sp_syscollector_stop_collection_set @collection_set_id = @csid  
    
    참고

    SQL Server Management StudioSQL Server Management Studio에서 개체 탐색기를 사용하여 컬렉션 집합을 중지할 수도 있습니다.You can also stop the collection set by using Object Explorer in SQL Server Management StudioSQL Server Management Studio. 자세한 내용은 컬렉션 집합 시작 또는 중지를 참조하세요.For more information, see Start or Stop a Collection Set.

  2. 컬렉션 항목을 추가하려는 컬렉션 집합을 선택합니다.Declare the collection set that you want to add the collection item to. 다음 코드에서는 컬렉션 집합 ID를 선언하는 방법을 보여 줍니다.The following code provides an example of how to declare the collection set ID.

    DECLARE @collection_set_id_1 int  
    SELECT @collection_set_id_1 = collection_set_id FROM [msdb].[dbo].[syscollector_collection_sets]  
    WHERE name = N'Test Collection Set'; -- name of collection set  
    
  3. 수집기 유형을 선언합니다.Declare the collector type. 다음 코드에서는 일반 T-SQL 쿼리 수집기 유형을 선언하는 방법을 보여 줍니다.The following code provides an example of how to declare the Generic T-SQL Query collector type.

    DECLARE @collector_type_uid_1 uniqueidentifier  
    SELECT @collector_type_uid_1 = collector_type_uid FROM [msdb].[dbo].[syscollector_collector_types]   
       WHERE name = N'Generic T-SQL Query Collector Type';  
    

    다음 코드를 실행하여 설치된 수집기 유형의 목록을 가져옵니다.You can run the following code to obtain a list of the installed collector types:

    USE msdb  
    SELECT * from syscollector_collector_types  
    GO  
    
  4. sp_syscollector_create_collection_item 저장 프로시저를 실행하여 컬렉션 항목을 만듭니다.Run the sp_syscollector_create_collection_item stored procedure to create the collection item. 원하는 수집기 유형에 필요한 스키마에 매핑되도록 컬렉션 항목에 대한 스키마를 선언해야 합니다.You must declare the schema for the collection item so that it maps to the required schema for the desired collector type. 다음 예제에서는 일반 T-SQL 쿼리 입력 스키마를 사용합니다.The following example uses the Generic T-SQL Query input schema.

    DECLARE @collection_item_id int;  
    EXEC [msdb].[dbo].[sp_syscollector_create_collection_item]   
    @name=N'OS Wait Stats', --name of collection item  
    @parameters=N'  
    <ns:TSQLQueryCollector xmlns:ns="DataCollectorType">  
     <Query>  
      <Value>select * from sys.dm_os_wait_stats</Value>  
      <OutputTable>os_wait_stats</OutputTable>  
    </Query>  
    </ns:TSQLQueryCollector>',  
    @collection_item_id = @collection_item_id OUTPUT,  
    @frequency = 60,  
    @collection_set_id = @collection_set_id_1, --- Provides the collection set ID number  
    @collector_type_uid = @collector_type_uid_1 -- Provides the collector type UID  
    SELECT @collection_item_id     
    
  5. 업데이트된 컬렉션 집합을 시작하기 전에 다음 쿼리를 실행하여 새 컬렉션 항목이 만들어졌는지 확인합니다.Before starting the updated collection set, run the following query to verify that the new collection item has been created:

    USE msdb  
    SELECT * from syscollector_collection_sets  
    SELECT * from syscollector_collection_items  
    GO  
    

    컬렉션 집합 및 해당 컬렉션 항목은 결과 탭에 표시됩니다.The collection sets and their collection items are displayed in the Results tab.

참고 항목See Also

일반 T-SQL 쿼리 수집기 유형을 사용하는 사용자 지정 컬렉션 집합 만들기(Transact-SQL) Create a Custom Collection Set That Uses the Generic T-SQL Query Collector Type (Transact-SQL)
데이터 수집기 저장 프로시저(Transact-SQL) Data Collector Stored Procedures (Transact-SQL)