sp_syscollector_update_collection_set (Transact-sql)

Kullanıcı tanımlı koleksiyonu kümesi özelliklerini değiştirmek için kullanılan veya kullanıcı tanımlı koleksiyonu yeniden adlandırmak için ayarlayın.

Dikkat notuDikkat

Bir proxy sunucu olarak yapılandırılmış Windows hesabını henüz açmamış içinde etkileşimli olmayan veya etkileşimli kullanıcı olduğu durumlarda, profil dizini yok ve basamak dizininin oluşturulması başarısız olur. Bu nedenle, etki alanı denetleyicisinde bir proxy hesabı kullanıyorsanız, en az bir kez bu profil dizini sağlamak için kullanılan interaktif hesap oluşturuldu belirtmeniz gerekir.

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

Sözdizimi

sp_syscollector_update_collection_set 
    [ [ @collection_set_id = ] collection_set_id ]
    , [ [ @name = ] 'name' ]
    , [ [ @new_name = ] 'new_name' ]
    , [ [ @target = ] 'target' ]
    , [ [ @collection_mode = ] collection_mode ]
    , [ [ @days_until_expiration = ] days_until_expiration ]
    , [ [ @proxy_id = ] proxy_id ]
    , [ [ @proxy_name = ] 'proxy_name' ]
    ,[ [ @schedule_uid = ] 'schedule_uid' ]
    ,[ [ @schedule_name = ] 'schedule_uid' ]
    , [ [ @logging_level = ] logging_level ]
    , [ [ @description = ] 'description' ]

Bağımsız değişkenler

  • [ @collection\_set\_id = ] collection_set_id
    Yerel koleksiyonu kümesi kimliktir. collection_set_idise intve bir değer olması gerekir namenull olur.

  • [ @name = ] 'name'
    Koleksiyonu kümesi adıdır. nameise sysnameve bir değer olması gerekir collection_set_idnull olur.

  • [ @new\_name = ] 'new_name'
    Koleksiyonu kümesi için yeni adıdır. new_nameise sysname, ve kullanılan, boş bir dize olamaz. new_namebenzersiz olmalıdır. Geçerli koleksiyonu kümesi adlarının listesi için sorgu syscollector_collection_setssistem görünüm.

  • [ @target = ] 'target'
    Gelecekteki kullanım için ayrılmıştır.

  • [ @collection\_mode = ] collection_mode
    Kullanılacak veri toplama türüdür. collection_modeise smallintve aşağıdaki değerlerden biri olabilir:

    0 - Önbellekli mod. Veri toplama ve karşıya yükleme ayrı zamanlamaları vardır. Sürekli koleksiyonu için önbelleğe alınmış modu belirtin.

    1 - Önbelleğe alınmamış modda. Veri toplama ve karşıya yükleme aynı zamanlamada olduğunu. Özel koleksiyon veya anlık görüntü koleksiyonu için önbelleğe alınmamış modunu belirtin.

    Önbellekli mod (0) önbelleğe alınmamış modundan değiştirme, ya da belirtmelisiniz schedule_uidya schedule_name.

  • [ @days\_until\_expiration= ] days_until_expiration
    Toplanan veri yönetimi veri ambarına kaydedilmiş olan gün sayısıdır. days_until_expirationis smallint. days_until_expiration0 ya da pozitif bir tamsayı olmalıdır.

  • [ @proxy\_id = ] proxy_id
    Benzersiz tanımlayıcısı olan bir SQL ServerAracısı proxy hesabı. proxy_idis int.

  • [ @proxy\_name = ] 'proxy_name'
    Proxy adıdır. proxy_nameise sysnameve NULL olabilecek.

  • [ @schedule\_uid = ] 'schedule_uid'
    Bir zamanlamaya işaret GUID'dir. schedule_uidis uniqueidentifier.

    Edinmek için schedule_uid, sorgu sysschedulessistem tablosu.

    Ne zaman collection_mode0 olarak ayarlanır schedule_uidya schedule_namebelirtilmesi gerekir. Ne zaman collection_mode1 değeri schedule_uidya schedule_namebelirtilen yoksayılır.

  • [ @schedule\_name = ] 'schedule_name'
    Zamanlamayı adıdır. proxy_nameise sysnameve NULL olabilecek. Belirtilmişse, schedule_uidnull olmalıdır. Edinmek için schedule_name, sorgu sysschedulessistem tablosu.

  • [ @logging\_level = ] logging_level
    Günlük düzeyidir. logging_levelise smallintile aşağıdaki değerlerden biri:

    0 - Günlük yürütme bilgilerini ve SSISizleme Etkinlikler:

    • Başlatma veya durdurma koleksiyonu kümeleri

    • Başlatma veya durdurma paketleri

    • Hata bilgileri

    1 - Düzey 0 günlüğü ve:

    • Yürütme istatistiklerini

    • Sürekli çalışan koleksiyonu ilerleme

    • Uyarı olaylarıSSIS

    2 Düzey-1 günlüğü ve ayrıntılı olay bilgilerini SSIS.

    Varsayılan değeri logging_level1.

  • [ @description = ] 'description'
    Koleksiyonu kümesi açıklaması bulunur. descriptionis nvarchar(4000).

Dönüş Kodu Değerleri

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

Açıklamalar

sp_syscollector_update_collection_setiçeriğinde çalıştırılmalıdır msdb sistem veritabanı.

Ya collection_set_idya namegereken bir değeri var, ikisi de boş olamaz. Bu değerleri almak için sorgu syscollector_collection_setssistem görünüm.

Koleksiyonu kümesi çalışıyorsa, yalnızca güncelleştirebilirsiniz schedule_uid ve description. Koleksiyonu kümesi durdurmak için kullanın sp_syscollector_stop_collection_set.

İ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

  • @target

  • @proxy\_id

  • @description

  • @collection\_mode

  • @days\_until\_expiration

Örnekler

A.Koleksiyonu kümesi yeniden adlandırma

Aşağıdaki örnek, kullanıcı tanımlı koleksiyonu kümesi yeniden adlandırır.

USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Simple collection set test 1',
@new_name = N'Collection set test 1 in cached mode';
GO

USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Simple collection set test 1',
@new_name = N'Collection set test 1 in cached mode';
GO

B.Önbelleğe alınmamış gelen önbelleğe koleksiyonu modunu değiştirme

Aşağıdaki örnek toplama modu önbelleğe alınmış modu önbelleğe alınmamış modundan değiştirir. Bu değişiklik bir zamanlama kimliği veya zaman çizelgesi adı belirtmeniz gerekir.

USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Collection set test 1 in cached mode',
@collection_mode = 0,
@schedule_uid = 'C7022AF3-51B8-4011-B159-64C47C88FF70';
-- alternatively, use @schedule_name.
-- @schedule_name = N'CollectorSchedule_Every_15min;
GO

USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Collection set test 1 in cached mode',
@collection_mode = 0,
@schedule_uid = 'C7022AF3-51B8-4011-B159-64C47C88FF70';
-- alternatively, use @schedule_name.
-- @schedule_name = N'CollectorSchedule_Every_15min;
GO

C.Diğer toplama değiştirme parametreleri ayarla

Aşağıdaki örnek, adlandırılmış ayarlamak toplama çeşitli özelliklerini güncelleştirir "basit koleksiyonu kümesi sınayın 2'.

USE msdb;
GO
EXEC dbo.sp_syscollector_update_collection_set
@name = N'Simple collection set test 2',
@collection_mode = 1,
@days_until_expiration = 5,
@description = N'This is a test collection set that runs in noncached mode.',
@logging_level = 0;
GO

USE msdb;
GO
EXEC dbo.sp_syscollector_update_collection_set
@name = N'Simple collection set test 2',
@collection_mode = 1,
@days_until_expiration = 5,
@description = N'This is a test collection set that runs in noncached mode.',
@logging_level = 0;
GO

Ayrıca bkz.

Başvuru

Sistem saklı yordamları (Transact-sql)

syscollector_collection_sets (Transact-sql)

dbo.sysschedules (Transact-sql)

Kavramlar

Veri toplama