sp_syscollector_create_collection_set (Transact-sql)

Makale
10/29/2012

Yeni bir koleksiyon kümesi oluşturur. Bu saklı yordam veri toplamak için ayarladığınız özel koleksiyonu oluşturmak için kullanabilirsiniz.

Dikkat
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.

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_create_collection_set 
      [ @name = ] '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_name' ]
    , [ [ @logging_level = ] logging_level ]
    , [ [ @description = ] 'description' ]
    , [ @collection_set_id = ] collection_set_id OUTPUT 
    , [ [ @collection_set_uid = ] 'collection_set_uid' OUTPUT ]

Bağımsız değişkenler

[ @name = ] 'name'
Koleksiyonu kümesi adıdır. nameise sysnameve bir boş veya null olamaz.

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. nameise nvarchar(128), varsayılan değeri NULL.
[ @collection\_mode = ] collection_mode
Veri toplanan ve saklanan bir şekilde belirtir. 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.

Varsayılan değeri collection_mode0. Ne zaman collection_mode0 schedule_uidya schedule_namebelirtilmesi gerekir.
[ @days\_until\_expiration = ] days_until_expiration
Toplanan veri yönetimi veri ambarına kaydedilmiş olan gün sayısıdır. days_until_expirationise smallint730 (iki yıl) varsayılan değeri ile. 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_idise int, varsayılan değeri NULL. Belirtilmişse, proxy_namenull olmalıdır. Edinmek için proxy_id, sorgu sysproxiessistem tablosu. dc_adminSabit veritabanı rolü proxy erişim iznine sahip olması gerekir. Daha fazla bilgi için, bkz. SQL Server Aracısı Proxy oluşturma.
[ @proxy\_name = ] 'proxy_name'
Proxy hesabının adıdır. proxy_nameise sysname, varsayılan değeri NULL. Belirtilmişse, proxy_idnull olmalıdır. Edinmek için proxy_name, sorgu sysproxiessistem tablosu.
[ @schedule\_uid = ] 'schedule_uid'
Bir zamanlamaya işaret GUID'dir. schedule_uidise uniqueidentifier, varsayılan değeri NULL. Belirtilmişse, schedule_namenull olmalıdır. 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. schedule_nameise sysname bir varsayılan değeri null. 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 bilgileriniSSIS

Varsayılan değeri logging_level1.
[ @description = ] 'description'
Koleksiyonu kümesi açıklaması bulunur. descriptionise nvarchar(4000) , varsayılan değeri NULL.
[ @collection\_set\_id = ] collection_set_id
Yerel koleksiyonu kümesi kimliktir. collection_set_idise intÇıkış ile gereklidir.
[ @collection\_set\_uid = ] 'collection_set_uid'
Koleksiyonu kümesi GUID değeridir. collection_set_uidise uniqueidentifierNULL varsayılan değere sahip çıktı.

Dönüş Kodu Değerleri

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

Açıklamalar

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

İzinler

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

Örnekler

A.Koleksiyon oluşturma varsayılan değerleri kullanarak ayarlama

Aşağıdaki örnek, yalnızca gerekli parametreleri ayarlamak koleksiyonu oluşturur. @collection\_modegerekli değildir, ancak zamanlama kimliği veya zaman çizelgesi adı belirtme (önbelleğe alınmış) varsayılan toplama modu gerektirir.

USE msdb;
GO
DECLARE @collection_set_id int;
EXECUTE dbo.sp_syscollector_create_collection_set
    @name = N'Simple collection set test 1',
    @description = N'This is a test collection set that runs in non-cached mode.',
    @collection_mode = 1,
    @collection_set_id = @collection_set_id OUTPUT;
GO

USE msdb;
GO
DECLARE @collection_set_id int;
EXECUTE dbo.sp_syscollector_create_collection_set
    @name = N'Simple collection set test 1',
    @description = N'This is a test collection set that runs in non-cached mode.',
    @collection_mode = 1,
    @collection_set_id = @collection_set_id OUTPUT;
GO

B.Koleksiyon oluşturma belirli değerleri kullanarak ayarlama

Aşağıdaki örnek, birçok parametreler için değerler belirterek ayarlamak koleksiyonu oluşturur.

USE msdb;
GO
DECLARE @collection_set_id int;
DECLARE @collection_set_uid uniqueidentifier;
SET @collection_set_uid = NEWID();
EXEC dbo.sp_syscollector_create_collection_set
    @name = N'Simple collection set test 2',
    @collection_mode = 0,
    @days_until_expiration = 365,
    @description = N'This is a test collection set that runs in cached mode.',
    @logging_level = 2,
    @schedule_name = N'CollectorSchedule_Every_30min',
    @collection_set_id = @collection_set_id OUTPUT,
    @collection_set_uid = @collection_set_uid OUTPUT;

USE msdb;
GO
DECLARE @collection_set_id int;
DECLARE @collection_set_uid uniqueidentifier;
SET @collection_set_uid = NEWID();
EXEC dbo.sp_syscollector_create_collection_set
    @name = N'Simple collection set test 2',
    @collection_mode = 0,
    @days_until_expiration = 365,
    @description = N'This is a test collection set that runs in cached mode.',
    @logging_level = 2,
    @schedule_name = N'CollectorSchedule_Every_30min',
    @collection_set_id = @collection_set_id OUTPUT,
    @collection_set_uid = @collection_set_uid OUTPUT;

Ayrıca bkz.