Delen via

sp_syscollector_create_collection_set (Transact-SQL)

Van toepassing op:SQL Server

Maakt een nieuwe verzameling aan. Je kunt deze opgeslagen procedure gebruiken om een aangepaste verzameling te maken voor gegevensverzameling.

Waarschuwing

In gevallen waarin het Windows-account dat als proxy is geconfigureerd een niet-interactieve of interactieve gebruiker is die nog niet is ingelogd, bestaat de profielmap niet en zal het aanmaken van de staging-map mislukken. Daarom moet je, als je een proxy-account gebruikt op een domeincontroller, een interactief account specificeren dat minstens één keer is gebruikt om te garanderen dat de profielmap is aangemaakt.

Transact-SQL syntaxis-conventies

Syntaxis

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 = ] Naamloos

De naam van de verzamelset. @name is sysname en kan geen lege string of NULL. zijn.

@name moet uniek zijn. Voor een lijst van de namen van de huidige collectie-sets, raadpleeg de syscollector_collection_sets systeemweergave.

[ @target = ] N'target'

Gereserveerd voor toekomstig gebruik. @target is nvarchar(128), met een standaard van NULL.

[ @collection_mode = ] collection_mode

@collection_mode is smallint, met als standaard .0

Specificeert de wijze waarop de gegevens worden verzameld en opgeslagen. @collection_mode is smallint, met als standaard 0, en kan een van de volgende waarden hebben:

  • 0: Gecachete modus. Dataverzameling en upload zijn volgens aparte schema's. Specificeer gecachede modus voor continue verzameling.

  • 1: Niet-gecachete modus. Dataverzameling en upload verlopen volgens hetzelfde schema. Specificeer niet-gecachede modus voor ad hoc verzameling of snapshotcollectie.

Wanneer @collection_mode is 0, moeten @schedule_uid of @schedule_name worden gespecificeerd.

[ @days_until_expiration = ] days_until_expiration

Het aantal dagen waarin de verzamelde gegevens worden opgeslagen in het management data warehouse. @days_until_expiration is smallint, met een standaardbedrag van 730 (twee jaar). @days_until_expiration moet een positief geheel getal zijn 0 .

[ @proxy_id = ] proxy_id

De unieke identificatie voor een SQL Server Agent proxy-account. @proxy_id is int, met als standaard .NULL Indien gespecificeerd, moet @proxy_name zijn NULL. Om @proxy_id te verkrijgen, raadpleeg de sysproxies systeemtabel. De dc_admin vaste databaserol moet toestemming hebben om toegang te krijgen tot de proxy. Voor meer informatie, zie Create a SQL Server Agent proxy.

[ @proxy_name = ] N'proxy_name'

De naam van het proxy-account. @proxy_name is systeemnaam, met als standaard .NULL Indien gespecificeerd, moet @proxy_id zijn NULL. Om @proxy_name te verkrijgen, raadpleeg je de sysproxies systeemtabel.

[ @schedule_uid = ] 'schedule_uid'

De GUID die naar een schema wijst. @schedule_uid is uniqueidentifier, met een standaard van NULL. Indien gespecificeerd, moet @schedule_name zijn NULL. Om @schedule_uid te verkrijgen, raadpleeg je de sysschedules systeemtabel.

Wanneer @collection_mode is ingesteld op 0, moet @schedule_uid of @schedule_name worden gespecificeerd. Wanneer @collection_mode is ingesteld op 1, wordt @schedule_uid of @schedule_name genegeerd als dat is gespecificeerd.

[ @schedule_name = ] N'schedule_name'

De naam van het schema. @schedule_name is een systeemnaam, met als standaard NULL. Indien gespecificeerd, moet @schedule_uid zijn NULL. Om @schedule_name te verkrijgen, raadpleeg je de sysschedules systeemtabel.

[ @logging_level = ] logging_level

Het loggingniveau. @logging_level is smallint, met als standaard 1, met een van de volgende waarden:

  • 0: log uitvoeringsinformatie en SSIS-gebeurtenissen die volgen:

    • Start/stoppende verzamelverzamelingen
    • Start/stoppen van pakketten
    • Foutinformatie

  • 1: levellogging 0 en:

    • Uitvoeringsstatistieken
    • Continu lopende verzamelingsvoortgang
    • Waarschuwingsgebeurtenissen van SSIS

  • 2: levellogging 1 en gedetailleerde gebeurtenisinformatie van SSIS.

[ @description = ] Geen beschrijving'

De beschrijving van de verzameling. @description is nvarchar(4000), met een standaard van NULL.

[ @collection_set_id = ] collection_set_id OUTPUT

De unieke lokale identificatie voor de verzamelingsset. @collection_set_id is een OUTPUT-parameter van het type int.

[ @collection_set_uid = ] 'collection_set_uid' OUTPUT

De GUID voor de collectieset. @collection_set_uid is een OUTPUT-parameter van het type uniqueidentifier.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Opmerkingen

sp_syscollector_create_collection_set moet worden uitgevoerd in de context van de msdb systeemdatabase.

Permissions

Vereist lidmaatschap van de vaste databaserol van de dc_admin (met uitvoerbare toestemming) om deze procedure uit te voeren.

Voorbeelden

Eén. Maak een verzamelingsset aan door standaardwaarden te gebruiken

Het volgende voorbeeld creëert een verzamelingsset door alleen de vereiste parameters op te geven. @collection_mode is niet vereist, maar de standaard verzamelmodus (gecachet) vereist het specificeren van een schema-ID of schemanaam.

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. Maak een verzameling aan door gebruik te maken van gespecificeerde waarden

Het volgende voorbeeld creëert een verzameling door waarden te specificeren voor veel van de parameters.

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

Verwante inhoud

  • Last updated on