sp_syscollector_update_collection_item (Transact-sql)

Makale
10/29/2012

Bir kullanıcı tanımlı koleksiyonu öğe özelliklerini değiştirmek veya kullanıcı tanımlı koleksiyonu öğeyi yeniden adlandırmak için kullanılır.

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

Sözdizimi

sp_syscollector_update_collection_item 
      [ [ @collection_item_id = ] collection_item_id ]
    , [ [ @name = ] 'name' ]
    , [ [ @new_name = ] 'new_name' ]
    , [ [ @frequency = ] frequency ]
    , [ [ @parameters = ] 'parameters' ]

Bağımsız değişkenler

@ collection_item_id =collection_item_id
Koleksiyon öğesi tanımlayan benzersiz tanımlayıcı olduğunu. collection_item_idise int, varsayılan değeri NULL. collection_item_idbir değer olması gerekir namenull olur.
@name = 'name'
Koleksiyon öğesi adıdır. nameise sysname, varsayılan değeri NULL. namebir değer olması gerekir collection_item_idnull olur.
@new\_name ='new_name'
Koleksiyon öğesi yeni adıdır. new_nameise sysname, ve kullanılan, boş bir dize olamaz.

new_namebenzersiz olmalıdır. Geçerli koleksiyonu öğe adlarının listesi için sorgu syscollector_collection_itemssistem görünüm.
@ frekans =frequency
Sıklığını (saniye cinsinden) veri olan bu Koleksiyon öğesi tarafından toplanır. frequencyise int, 5, belirtilen minimum değeri varsayılan.
parametreleri = 'parameters'
Giriş parametreleri için Koleksiyon öğesi. parametersise xmlnull varsayılan. parametersŞema eşleşmesi parametrelerini şema Toplayıcı türü.

Dönüş Kodu Değerleri

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

Açıklamalar

Koleksiyonu kümesi modu önbelleğe alınmamış ayarlanmışsa, frekansı değiştirme veri toplama ve karşıya yükleme koleksiyonu kümesi için belirtilen zamanlamaya meydana Bu mod neden olduğu göz ardı edilir. Koleksiyonu kümesi durumunu görüntülemek için aşağıdaki sorguyu çalıştırın. Yerine <collection_item_id>haberdar olmak için Koleksiyon öğesi kimliği ile.

USE msdb;
GO
SELECT cs.collection_set_id, collection_set_uid, cs.name 
    ,'is running' = CASE WHEN is_running =  0 THEN 'No' ELSE 'Yes' END
    ,'cache mode' = CASE WHEN collection_mode = 0 THEN 'Cached mode' ELSE 'Non-cached mode' END
FROM syscollector_collection_sets AS cs
JOIN syscollector_collection_items AS ci 
ON ci.collection_set_id = cs.collection_set_id
WHERE collection_item_id = <collection_item_id>;

USE msdb;
GO
SELECT cs.collection_set_id, collection_set_uid, cs.name 
    ,'is running' = CASE WHEN is_running =  0 THEN 'No' ELSE 'Yes' END
    ,'cache mode' = CASE WHEN collection_mode = 0 THEN 'Cached mode' ELSE 'Non-cached mode' END
FROM syscollector_collection_sets AS cs
JOIN syscollector_collection_items AS ci 
ON ci.collection_set_id = cs.collection_set_id
WHERE collection_item_id = <collection_item_id>;

İzinler

Üyelik dc_adminya da dc_operator(ile execute izni) sabit veritabanı rolü, bu yordamı yürütmek. Her ne kadar dc_operatorBu saklı yordam, bu rolün üyeleri sınırlı onlar değiştirebileceğiniz özellikler çalıştırabilirsiniz. Aşağıdaki özellikler yalnızca değiştirilebilir dc_admin:

@new\_name
@parameters

Örnekler

Aşağıdaki örnekler tanımlanan örnek oluşturulan Koleksiyon öğesi esas alan sp_syscollector_create_collection_item (Transact-sql).

A.Koleksiyonu sıklığını değiştirme

Aşağıdaki örnek, belirtilen Koleksiyon öğesi koleksiyonu sıklığını değiştirir.

USE msdb;
GO
EXEC sp_syscollector_update_collection_item 
@name = N'My custom TSQL query collector item',
@frequency = 3000;
GO

USE msdb;
GO
EXEC sp_syscollector_update_collection_item 
@name = N'My custom TSQL query collector item',
@frequency = 3000;
GO

B.Koleksiyon öğesi yeniden adlandırılıyor

Aşağıdaki örnek bir toplama öğeyi yeniden adlandırır.

USE msdb;
GO
EXEC sp_syscollector_update_collection_item 
@name = N'My custom TSQL query collector item',
@new_name = N'My modified TSQL item';
GO

USE msdb;
GO
EXEC sp_syscollector_update_collection_item 
@name = N'My custom TSQL query collector item',
@new_name = N'My modified TSQL item';
GO

C.Koleksiyon öğesi parametrelerini değiştirme

Aşağıdaki örnek, Koleksiyon öğesi ile ilişkilendirilmiş parametrelerini değiştirir. Deyimi içinde tanımlanan <Value>özniteliği değişti ve UseSystemDatabasesözniteliği false olarak ayarlanmışsa. Bu öğe için geçerli parametrelerini görüntülemek için parameters sütununda syscollector_collection_itemssistem görünüm. Sen-ebilmek lüzum-e değeri değiştirmek @collection\_item\_id.

USE msdb;
GO
EXEC sp_syscollector_update_collection_item 
@collection_item_id = 9, 
@parameters = '
    <ns:TSQLQueryCollector xmlns:ns="DataCollectorType">
        <Query>
            <Value>SELECT * FROM sys.dm_db_index_usage_stats</Value>
            <OutputTable>MyOutputTable</OutputTable>
        </Query>
        <Databases>
            <Database> UseSystemDatabases = "false" 
                       UseUserDatabases = "true"</Database>
        </Databases>
    </ns:TSQLQueryCollector>';
GO

USE msdb;
GO
EXEC sp_syscollector_update_collection_item 
@collection_item_id = 9, 
@parameters = '
    <ns:TSQLQueryCollector xmlns:ns="DataCollectorType">
        <Query>
            <Value>SELECT * FROM sys.dm_db_index_usage_stats</Value>
            <OutputTable>MyOutputTable</OutputTable>
        </Query>
        <Databases>
            <Database> UseSystemDatabases = "false" 
                       UseUserDatabases = "true"</Database>
        </Databases>
    </ns:TSQLQueryCollector>';
GO