Freigeben über

  • Artikel

Vorgehensweise: Hinzufügen eines Auflistelements zu einem Auflistsatz

Sie können einem vorhandenen Auflistsatz mithilfe der mit dem Datenauflister bereitgestellten gespeicherten Prozeduren ein Auflistelement hinzufügen.

Führen Sie die folgenden Schritte mithilfe des Abfrage-Editors in SQL Server Management Studio aus.

Hinzufügen eines Auflistelements zu einem Auflistsatz

  1. Beenden Sie den Auflistsatz, dem Sie das Element hinzufügen möchten, in dem Sie die gespeicherte Prozedur sp_syscollector_stop_collection_set ausführen. Um z. B. einen Auflistsatz mit dem Namen "Test Collection Set" zu beenden, führen Sie die folgenden Anweisungen aus:

    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
    HinweisHinweis

    Sie können den Auflistsatz auch mit dem Objekt-Explorer in SQL Server Management Studio beenden. Weitere Informationen finden Sie unter Vorgehensweise: Starten oder Beenden eines Auflistsatzes.

  2. Deklarieren Sie den Auflistsatz, dem Sie das Auflistelement hinzufügen möchten. Der folgende Code ist ein Beispiel für das Deklarieren der Auflistsatz-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. Deklarieren Sie den Auflistertyp. Der folgende Code ist ein Beispiel für das Deklarieren des generischen T-SQL-Abfrageauflistertyps.

    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';

    Sie können den folgenden Code ausführen, um eine Liste der installierten Auflistertypen abzurufen:

    USE msdb
SELECT * from syscollector_collector_types
GO

    Weitere Informationen finden Sie unter Auflistertypen.

  4. Führen Sie die gespeicherte Prozedur sp_syscollector_create_collection_item aus, um das Auflistelement zu erstellen. Sie müssen das Schema für das Auflistelement so deklarieren, dass es dem Schema zugeordnet wird, das für den gewünschten Auflistertyp erforderlich ist. Im folgenden Beispiel wird das generische T-SQL-Abfrageeingabeschema verwendet.

    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. Bevor Sie den aktualisierten Auflistsatz starten, führen Sie die folgende Abfrage aus, um zu überprüfen, ob das neue Auflistelement erstellt wurden:

    USE msdb
SELECT * from syscollector_collection_sets
SELECT * from syscollector_collection_items
GO

    Die Auflistsätze und ihre Auflistelemente werden auf der Registerkarte Ergebnisse angezeigt.