sp_syscollector_create_collection_item (języka Transact-SQL)

Argumenty

• [@ collection_set_id =] collection_set_id
  Is the unique local identifier for the collection set.collection_set_id is int.

• [@ collector_type_uid =] ' collector_type_uid"
  Jest identyfikatorem GUID identyfikujący typ modułu zbierającego dane dane dla tego element collector_type_uid jest uniqueidentifier bez wartości domyślne Aby wyświetlić listę typów modułów zbierających widoku systemu syscollector_collector_types kwerendy.

• [@ nazwa =] ' name"
  Is the name of the collection item.name is sysname and cannot be an empty string or NULL.

  name musi być unikatowa.Aby wyświetlić listę bieżących element kolekcja widoku systemu syscollector_collection_items kwerendy nazwy.

• [@ częstotliwość =] frequency
  Is used to specify (in seconds) how frequently data is collected by this collection item.frequency is int, with a default of 5.Minimalna wartość, która może być określony, to 5 sekund.

  Jeśli zestaw kolekcja jest ustawiona na brak pamięci podręcznej trybu częstotliwość jest ignorowany, ponieważ w tym trybie powoduje, że zbieranie danych i przekazywania w harmonogramu określonego dla zestaw kolekcja.Aby wyświetlić tryb zbierania zestaw kolekcja, kwerendy syscollector_collection_sets widok systemu.

• [@ parametrów =] ' parameters"
  The input parameters for the collector type.parameters is xml with a default of NULL.The parameters schema must match the parameters schema of the typ modułu zbierającego dane.

• [@ collection_item_id =] collection_item_id
  Is the unique identifer that identifies the collection set item.collection_item_id is int and has OUTPUT.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Remarks

sp_syscollector_create_collection_item musi być uruchamiane w kontekście systemu bazy danych msdb.

zestaw kolekcja Których element kolekcja jest dodawany muszą być zatrzymane przed utworzeniem element kolekcja.Kolekcja elementów nie można dodać do systemu pobierania zestawów.

Uprawnienia

Wymaga członkostwo w stała rola bazy danych dc_admin (z uprawnienie wykonać) do wykonać tej procedury.

Przykłady

W następującym przykładzie zostanie utworzony element kolekcja, w zależności od typu kolekcja Generic T-SQL Query Collector Type i dodaje go do zestaw kolekcja nazwane Simple collection set test 2. Aby utworzyć kolekcja określony zestaw, uruchomić przykład B w sp_syscollector_create_collection_set (języka Transact-SQL).

USE msdb;
GO
DECLARE @collection_item_id int;
DECLARE @collection_set_id int = (SELECT collection_set_id 
                                  FROM syscollector_collection_sets
                                  WHERE name = N'Simple collection set test 2');
DECLARE @collector_type_uid uniqueidentifier = 
    (SELECT collector_type_uid
     FROM syscollector_collector_types
     WHERE name = N'Generic T-SQL Query Collector Type');
DECLARE @params xml = 
    CONVERT(xml, N'<ns:TSQLQueryCollector xmlns:ns="DataCollectorType">
            <Query>
                <Value>SELECT * FROM sys.objects</Value>
                <OutputTable>MyOutputTable</OutputTable>
            </Query>
            <Databases> 
                <Database> UseSystemDatabases = "true" 
                           UseUserDatabases = "true"
                </Database>
            </Databases>
         </ns:TSQLQueryCollector>');

EXEC sp_syscollector_create_collection_item
    @collection_set_id = @collection_set_id,
    @collector_type_uid = @collector_type_uid,
    @name = 'My custom TSQL query collector item',
    @frequency = 6000,
    @parameters = @params,
    @collection_item_id = @collection_item_id OUTPUT;

See Also

Reference

Other Resources