sp_syscollector_update_collection_item (Transact-SQL)

Bağımsız değişkenler

• [collection_item_id =] collection_item_id
  Is the unique identifer that identifies the collection item.collection_item_id is int with a default value of NULL.collection_item_id must have a value if name is NULL.

• [adı =] ' name'
  Is the name of the collection item.name is sysname with a default value of NULL.name must have a value if collection_item_id is NULL.

• [new_name =] ' new_name'
  Is the new name for the collection item.new_name is sysname, and if used, cannot be an empty string.

  new_name benzersiz olması gerekir.Geçerli koleksiyon listesi öğe syscollector_collection_öğes sistem Görünüm adları, sorgu.

• [sıklık =] frequency
  Is the frequency (in seconds) that data is collected by this collection item.frequency is int, with a default of 5, the minimum value that can be specified.

• [parametre =] ' parameters'
  The input parameters for the collection item.parameters is xml with a default of NULL.The parameters schema must match the parameters schema of the toplayıcı türü.

Dönüş Kodu Değerleri

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

Remarks

koleksiyon küme olan küme nedeniyle bu modu hem de veri koleksiyon ve koleksiyon için belirtilen zamanlamaya ortaya için karşıya yükleme moduna önbelleğe alınmamış sıklığını değiştirme gözardı edilir küme.koleksiyon kümesi durumunu görüntülemek için , aşağıdaki sorguyu çalıştırın.replace <collection_item_id> Koleksiyon KIMLIĞI ile öğe güncelleştirilecek.

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

Bu yordamı çalıştırmak dc_admin veya üyelik dc_operator (yürütmek izni) içeren sabit veritabanı rolü gerektirir.Dc_operator, bu saklı yordam çalıştırabilirsiniz, ancak bu rolün üyeleri değiştirebilirsiniz özellikleri sınırlıdır.Aşağıdaki özellikler yalnızca dc_admin tarafından da değiştirilebilir:

• @ new_name

• @ parametreleri

Örnekler

Aşağıdaki örnekler koleksiyon dayalı öğe tanımlanan örnekte oluşturulmuş sp_syscollector_create_collection_item (Transact-SQL).

C.koleksiyon sıklığını değiştirme

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

b.koleksiyon yeniden adlandırma öğe

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.Bir koleksiyon öğesi parametrelerini değiştirme

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

See Also

Reference

Other Resources