Udostępnij za pośrednictwem

  • Artykuł

sp_syscollector_create_collection_set (języka Transact-SQL)

Tworzy nowy kolekcja zestaw.Ta procedura składowana można użyć do utworzenia niestandardowej kolekcja zestaw danych kolekcja.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

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 ]

Argumenty

  • [ @name = ] 'name'
    Jest to nazwa kolekcja zestaw.namejest sysname i nie może być pusty ciąg lub wartość NULL.

    namemusi być unikatowa.Lista nazwy bieżącegozestaw kolekcjakwerendy syscollector_collection_sets systemu widoku.

  • [ @target = ] 'target'
    Zarezerwowane do użytku w przyszłości.namejest nvarchar(128) o wartości domyślnej NULL.

  • [ @collection_mode = ] collection_mode
    Określa sposób zebrane i zapisane dane.collection_modejest smallint i może mieć jedną z następujących wartości:

    0 - Tryb buforowany.kolekcja danych i przekazywania znajdują się na osobne harmonogramy.Określ tryb pamięci podręcznej dla stałego kolekcja.

    1 - Tryb niebuforowany.kolekcja danych i przekazywania jest według tego samego harmonogramu.Określić tryb ad hoc kolekcja lub migawka kolekcja-buforowane.

    Wartość domyślna dla collection_mode 0.Gdy collection_mode jest równa 0, schedule_uid lub schedule_name musi być określony.

  • [ @days_until_expiration = ] days_until_expiration
    To liczba dni, w których zebrane dane są zapisywane w zarządzanie magazyn danych.days_until_expirationjest smallint z wartości domyślnej (dwa lata) 730.days_until_expirationmusi być dodatnią liczbą całkowitą lub 0.

  • [ @proxy_id = ] proxy_id
    Jest identyfikator unikatowy dla SQL Server konto proxyagenta.proxy_idjest int o wartości domyślnej NULL.Jeśli określony, proxy_name musi mieć wartość NULL.Aby uzyskać proxy_id, kwerenda sysproxies tabela systemowa.dc_admin Stałą rola bazy danych musi mieć uprawnienie do dostępu do serwera proxy.Aby uzyskać więcej informacji, zobacz Tworzenie SQL Server agenta proxy.

  • [ @proxy_name = ] 'proxy_name'
    Jest to nazwa konto proxy.proxy_namejest sysname o wartości domyślnej NULL.Jeśli określony, proxy_id musi mieć wartość NULL.Aby uzyskać proxy_name, kwerenda sysproxies tabela systemowa.

  • [ @schedule_uid = ] 'schedule_uid'
    To identyfikator GUID, który wskazuje na harmonogram.schedule_uidjest uniqueidentifier o wartości domyślnej NULL.Jeśli określony, schedule_name musi mieć wartość NULL.Aby uzyskać schedule_uid, kwerenda sysschedules tabela systemowa.

    Gdy collection_mode jest zestaw na 0, schedule_uid lub schedule_name musi być określony.Gdy collection_mode jest zestaw na 1, schedule_uid lub schedule_name jest ignorowane, jeśli określono.

  • [ @schedule_name = ] 'schedule_name'
    Jest to nazwa harmonogramu.schedule_namejest sysname o wartości domyślnej NULL.Jeśli określony, schedule_uid musi mieć wartość NULL.Aby uzyskać schedule_name, kwerenda sysschedules tabela systemowa.

  • [ @logging_level = ] logging_level
    Jest poziomrejestrowania.logging_leveljest smallint z jedną z następujących wartości:

    0 - informacje wykonanie dziennika i SSIS zdarzenia, które śledzą:

    • Uruchamianie zatrzymywania kolekcja zestawów

    • Uruchamianie zatrzymania pakietów

    • Informacje o błędach

    1 - poziom-0 rejestrowania i:

    • Wykonanie statystyki

    • Stale uruchomiony postępu kolekcja

    • Zdarzenia ostrzegawcze zSSIS

    2 - rejestrowanie poziom-1 i szczegółowe informacje dotyczące zdarzenie zSSIS

    Wartość domyślna dla logging_level 1.

  • [ @description = ] 'description'
    Jest opis kolekcja zestaw.descriptionjest nvarchar(4000) o wartości domyślnej NULL.

  • [ @collection_set_id = ] collection_set_id
    Jest unikatowy identyfikator lokalny dla kolekcja zestaw.collection_set_idjest int z danych wyjściowych i jest wymagany.

  • [ @collection_set_uid = ] 'collection_set_uid'
    To identyfikator GUID dla kolekcja zestaw.collection_set_uidjest uniqueidentifier z danych wyjściowych z domyślną wartość NULL.

Wartości kodów powrotnych

0(sukces) lub 1 (błąd)

Uwagi

sp_syscollector_create_collection_setmusi być uruchamiany w kontekście msdb systemu bazy danych.

Uprawnienia

Wymaga członkostwa w dc_admin (z uprawnieniem Wykonywanie) ustalony rola bazy danych do wykonać tej procedury.

Przykłady

A.Tworzenie kolekcja zestaw przy użyciu wartości domyślnych

Poniższy przykład tworzy kolekcja,zestaw przez podanie tylko wymaganych parametrów. @collection_modenie jest wymagane, ale domyślny tryb kolekcja (buforowane) wymaga określenia identyfikator harmonogramu lub nazwa harmonogramu.

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.Tworzenie kolekcja zestaw przy użyciu określonych wartości

Poniższy przykład tworzy kolekcja,zestaw , określając wartości dla wielu parametrów.

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;