sp_syscollector_create_collection_item (Transact-sql)

Makale
10/29/2012

Koleksiyon öğesi, bir kullanıcı tanımlı koleksiyonu kümesi oluşturur. Koleksiyon öğesi veri toplanacak ve hangi verilerin toplandığını sıklığını tanımlar.

Konu bağlantısı simgesi Transact-SQL Sözdizim Kuralları

Sözdizimi

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

Bağımsız değişkenler

@ collection_set_id = collection_set_id
Yerel koleksiyonu kümesi kimliktir. collection_set_idis int.
@ collector_type_uid ='collector_type_uid'
Bu öğe için Toplayıcı türünü tanımlayan GUID olarak collector_type_uidolan uniqueidentifierile hiçbir varsayılan değer... Sorgu Toplayıcı türlerinin listesi için syscollector_collector_typessistem görünüm.
@name ='name'
Koleksiyon öğesi adıdır. nameise sysnameve bir boş veya null olamaz.

namebenzersiz olmalıdır. Geçerli koleksiyonu öğe adlarının listesi için sorgu syscollector_collection_itemssistem görünüm.
@ frekans = frequency
Verileri bu Koleksiyon öğesi tarafından ne sıklıkta toplanır (saniye cinsinden) belirtmek için kullanılır. frequencyise int, 5 varsayılan. Belirtilen en düşük değer 5 saniyedir.

Koleksiyonu kümesi modu önbelleğe alınmamış ayarlanmışsa, bu mod veri toplama ve karşıya yükleme koleksiyonu kümesi için belirtilen zamanlamaya meydana neden olduğu frekans sayılır. Koleksiyonu kümesi koleksiyonu modunu görüntülemek için syscollector_collection_sets görünümü.
parametreleri ='parameters'
Giriş parametreleri için Toplayıcı türü. parametersise xmlnull varsayılan. parametersŞema eşleşmesi parametrelerini şema Toplayıcı türü.
@ collection_item_id = collection_item_id
Koleksiyon tanımlayan benzersiz tanımlayıcı öğe ayarlayın. collection_item_idise intve çıktı.

Dönüş Kodu Değerleri

0(başarılı) veya 1(hata)

Açıklamalar

sp_syscollector_create_collection_itemiçeriğinde çalıştırılmalıdır msdbsistem veritabanı.

Koleksiyon öğesi eklendiği ayarlamak koleksiyonu Koleksiyon öğesi oluşturmadan önce durdurulmalıdır. Koleksiyon öğeleri sistem koleksiyonu kümeleri için eklenemiyor.

İzinler

Üyelik dc_admin(ile execute izni) sabit veritabanı rolü, bu yordamı yürütmek.

Örnekler

Koleksiyon öğesi koleksiyonu türüne göre aşağıdaki örnek oluşturur Generic T-SQL Query Collector Typeve adlandırılmış ayarlamak koleksiyonu ekler Simple collection set test 2. Belirtilen koleksiyon oluşturmak için ayarlamak, çalıştırmak örnekte b sp_syscollector_create_collection_set (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;

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;