Sdílet prostřednictvím

sp_syscollector_create_collection_set (Transact-SQL)

platí pro:SQL Server

Vytvoří novou kolekční sadu. Tuto uloženou proceduru můžete použít k vytvoření vlastní kolekční sady pro sběr dat.

Výstraha

V případech, kdy je Windows účet nastavený jako proxy neinteraktivní nebo interaktivní uživatel, který se ještě nepřihlásil, adresář profilu nebude existovat a vytvoření stagingového adresáře selže. Pokud tedy používáte proxy účet na doménovém řadiči, musíte specifikovat interaktivní účet, který byl použit alespoň jednou, abyste zajistili, že adresář profilu byl vytvořen.

Transact-SQL konvence syntaxe

Syntaxe

sp_syscollector_create_collection_set
    [ @name = ] N'name'
    [ , [ @target = ] N'target' ]
    [ , [ @collection_mode = ] collection_mode ]
    [ , [ @days_until_expiration = ] days_until_expiration ]
    [ , [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
    [ , [ @schedule_uid = ] 'schedule_uid' ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @logging_level = ] logging_level ]
    [ , [ @description = ] N'description' ]
    , [ @collection_set_id = ] collection_set_id OUTPUT
    [ , [ @collection_set_uid = ] 'collection_set_uid' OUTPUT ]
[ ; ]

Arguments

[ @name = ] N'jméno'

Název sbírky. @name je sysname a nemůže být prázdný řetězec ani NULL.

@name musí být jedinečný. Pro seznam aktuálních názvů sad kolekcí se dotazujte do syscollector_collection_sets systémového zobrazení.

[ @target = ] N'cíl'

Vyhrazeno pro budoucí použití. @target je nvarchar(128), s výchozím hodnotou NULL.

[ @collection_mode = ] collection_mode

@collection_mode je smallint, s výchozím nastavením 0.

Specifikuje způsob, jakým jsou data sbírána a ukládána. @collection_mode je smallint, s výchozím hodnotou 0, a může mít jednu z následujících hodnot:

  • 0: Režim cache. Sběr a nahrávání dat probíhají podle různých harmonogramů. Specifikujte režim cache pro kontinuální sběr.

  • 1: Režim bez cache. Sběr a nahrávání dat probíhá podle stejného harmonogramu. Specifikujte režim bez cache pro ad hoc sběr nebo sběr snímků.

Když je @collection_mode , 0musí být specifikována @schedule_uid nebo @schedule_name .

[ @days_until_expiration = ] days_until_expiration

Počet dní, po které jsou shromážděná data uložena v správcovském datovém skladu. @days_until_expiration je smallint, s výchozím 730 limitem (dva roky). @days_until_expiration musí být 0 kladné celé číslo.

[ @proxy_id = ] proxy_id

Jedinečný identifikátor pro proxy účet SQL Server Agent. @proxy_id je int, s výchozím nastavením NULL. Pokud je specifikováno, @proxy_name musí být NULL. Pro získání @proxy_id dotazujte do systémové tabulky sysproxies . Role dc_admin pevné databázové role musí mít oprávnění k přístupu k proxy. Pro více informací viz Vytvořte proxy agenta SQL Server.

[ @proxy_name = ] N'proxy_name'

Název proxy účtu. @proxy_name je sysname s výchozím nastavením NULL. Pokud je specifikováno, @proxy_id musí být .NULL Pro získání @proxy_name dotazujte do systémové tabulky sysproxies .

[ @schedule_uid = ] 'schedule_uid'

GUID, který ukazuje na rozvrh. @schedule_uid je uniqueidentifier s výchozím nastavením NULL. Pokud je specifikováno, @schedule_name musí být .NULL Pro získání @schedule_uid dotazujte systémovou tabulku sysschedules .

Když je @collection_mode nastaveno na 0, musí být specifikováno @schedule_uid nebo @schedule_name . Když je @collection_mode nastaveno na 1, @schedule_uid nebo @schedule_name se ignoruje, pokud je specifikováno.

[ @schedule_name = ] N'schedule_name'

Název rozvrhu. @schedule_name je sysname s výchozím nastavením NULL. Pokud je specifikováno, @schedule_uid musí být .NULL Pro získání @schedule_name dotazujte systémovou tabulku sysschedules .

[ @logging_level = ] logging_level

Úroveň zaznamenání. @logging_level je smallint, s výchozím nastavením 1, s jednou z následujících hodnot:

  • 0: záznamy o provádění a SSIS události, které sledují:

    • Startování/zastavení sběrných sad
    • Spouštění/zastavování balíčků
    • Informace o chybě

  • 1: 0 level logging a:

    • Statistika provádění
    • Průběžný průběh sběru
    • Varovné události od SSIS

  • 2: 1 level logging a podrobné informace o událostech ze SSIS.

[ @description = ] N'popis"

Popis sbírky. @description je nvarchar(4000), s výchozím hodnotou NULL.

[ @collection_set_id = ] collection_set_id VÝSTUP

Jedinečný lokální identifikátor pro kolekční množinu. @collection_set_id je parametr OUTPUT typu int.

[ @collection_set_uid = ] VÝSTUP 'collection_set_uid'

GUID pro kolekci. @collection_set_uid je parametr OUTPUT typu uniqueidentifier.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Poznámky

sp_syscollector_create_collection_set musí být spuštěn v kontextu systémové databáze msdb .

Povolení

Vyžaduje členství v pevné databázové roli dc_admin (s oprávněním EXECUT) pro provedení tohoto postupu.

Examples

A. Vytvořte kolekci pomocí výchozích hodnot

Následující příklad vytváří množinu kolekce specifikováním pouze požadovaných parametrů. @collection_mode není vyžadováno, ale výchozí režim sběru (cache) vyžaduje zadání buď ID plánu, nebo názvu plánu.

USE msdb;
GO

DECLARE @collection_set_id AS 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. Vytvořte kolekci pomocí specifikovaných hodnot

Následující příklad vytváří množinu kolekce specifikací hodnot pro mnoho parametrů.

USE msdb;
GO

DECLARE @collection_set_id AS INT;
DECLARE @collection_set_uid AS UNIQUEIDENTIFIER;

SET @collection_set_uid = NEWID();

EXECUTE 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;
GO

Související obsah

  • Last updated on