sp_syscollector_create_collection_item (języka Transact-SQL)
Tworzy element kolekcji w użytkownika zdefiniowane zestaw kolekcji.A element kolekcja Określa dane, które mają być zbierane i częstotliwości, z jaką dane są zbierane.
.gif "Topic link icon")
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
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