Artykuł
07/26/2011

sp_syscollector_create_collection_item (języka Transact-SQL)

Tworzy kolekcjaelement w zdefiniowanej przez użytkownika kolekcja,zestaw. element kolekcjadefiniuje zbierania danych i częstotliwości, z jaką dane są zbierane.

Ikona łącza do tematu Języka Transact-SQL składni konwencje

Składnia

sp_syscollector_create_collection_item 
      [ @collection_set_id = ] collection_set_id 
    , [ @collector_type_uid = ] 'collector_type_uid'
    , [ @name = ] 'name' 
    , [ [ @frequency = ] frequency ]
    , [ @parameters = ] 'parameters'
    , [ @collection_item_id = ] collection_item_id OUTPUT

Argumenty

[ @ collection_set_id = ] collection_set_id
Jest unikatowy identyfikator lokalny dla kolekcja zestaw.collection_set_idis int.
[ @ collector_type_uid = ] 'collector_type_uid"
Identyfikator GUID, który identyfikuje typ modułu zbierającego dla tego elementjestcollector_type_uid jest uniqueidentifier z nie wartości domyślne... Lista typów modułów zbierających kwerendy syscollector_collector_types systemu widoku.
[ @name =] 'name'
Jest nazwąelement kolekcja. namejest sysname i nie może być pusty ciąg lub wartość NULL.

namemusi być unikatowa.Lista aktualne nazwyelement kolekcjakwerendy syscollector_collection_items systemu widoku.
[ @ częstotliwość = ] frequency
Służy do określania (w sekundach), jak często dane są zbierane przezelement kolekcja. frequencyjest int, domyślna wartość 5.Wartość minimalna, który może być określony jest 5 sekund.

kolekcjazestaw jest zestaw tryb buforowany, częstotliwość jest ignorowana, ponieważ powoduje to tryb kolekcja danych i przekazywania na harmonogram określony dla kolekcjazestaw. Aby wyświetlić tryb kolekcja kolekcja zestaw, kwerenda syscollector_collection_sets widok systemu.
[ @ parametrów = ] 'parameters"
Parametry wejściowe typ modułu zbierającego.parametersjest xml Domyślna wartość NULL.parameters Schematu musi odpowiadać schematu parametry typ modułu zbierającego.
[ @ collection_item_id = ] collection_item_id
Jest unikatowym identyfikatorem, identyfikującyzestaw kolekcjaelement. collection_item_idjest int i ma wyjście.

Wartości kodów powrotnych

0(sukces) lub 1 (błąd)

Uwagi

sp_syscollector_create_collection_itemmusi być uruchamiany w kontekście msdbsystemu bazy danych.

kolekcjazestaw do którego dodanyelement kolekcjamuszą być zatrzymane przed utworzeniemelement kolekcja. Kolekcja elementów nie można dodać do systemu kolekcja zestawów.

Uprawnienia

Wymaga członkostwa w dc_admin (z uprawnieniem Wykonywanie) ustalony rola bazy danych do wykonać tej procedury.

Przykłady

Poniższy przykład tworzy kolekcja element na podstawie typu kolekcja Generic T-SQL Query Collector Type i dodaje go do kolekcja zestaw o nazwie Simple collection set test 2.Aby utworzyć określonej kolekcja 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;