sp_syscollector_update_collection_set (Transact-SQL)

Syntax

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' ]

Argumente

• [ @collection\_set\_id = ] collection_set_id
  Der eindeutige lokale Bezeichner für den Auflistsatz. collection_set_id ist vom Datentyp int und muss über einen Wert verfügen, wenn name NULL ist.

• [ @name = ] 'name'
  Der Name des Auflistsatzes. name ist vom Datentyp sysname und muss über einen Wert verfügen, wenn collection_set_id NULL ist.

• [ @new\_name = ] 'new_name'
  Der neue Name des Auflistsatzes. new_name ist vom Datentyp sysname und darf, wenn verwendet, keine leere Zeichenfolge sein. new_name muss eindeutig sein. Wenn Sie eine Liste der aktuellen Namen von Auflistsätzen abrufen möchten, fragen Sie die syscollector_collection_sets-Systemsicht ab.

• [ @target = ] 'target'
  Reserviert für zukünftige Verwendung.

• [ @collection\_mode = ] collection_mode
  Der Typ der zu verwendenden Datenauflistung. collection_mode ist vom Datentyp smallint. Die folgenden Werte sind möglich:

  0 - Modus mit Zwischenspeicherung. Für Datenauflistung und -upload werden separate Zeitpläne verwendet. Geben Sie den Modus mit Zwischenspeicherung für eine fortlaufende Auflistung an.

  1 - Modus ohne Zwischenspeicherung. Für Datenauflistung und -upload wird der gleiche Zeitplan verwendet. Geben Sie den Modus ohne Zwischenspeicherung für eine Ad-hoc-Auflistung oder eine Snapshotauflistung an.

  Wenn Sie aus dem Modus ohne Zwischenspeicherung in den Modus mit Zwischenspeicherung (0) wechseln, müssen Sie entweder schedule_uid oder schedule_name angeben.

• [ @days\_until\_expiration= ] days_until_expiration
  Die Anzahl der Tage, die die gesammelten Daten im Management Data Warehouse gespeichert werden. days_until_expiration ist vom Datentyp smallint. days_until_expiration muss 0 (null) oder eine positive Ganzzahl sein.

• [ @proxy\_id = ] proxy_id
  Der eindeutige Bezeichner für ein SQL Server-Agent-Proxykonto. proxy_id ist vom Datentyp int.

• [ @proxy\_name = ] 'proxy_name'
  Der Name des Proxys. proxy_name ist vom Datentyp sysname und lässt NULL-Werte zu.

• [ @schedule\_uid = ] 'schedule_uid'
  GUID, der auf einen Zeitplan zeigt. schedule_uid ist vom Datentyp uniqueidentifier.

  Um schedule_uid abzurufen, fragen Sie die sysschedules-Systemtabelle ab.

  Wenn collection_mode auf 0 festgelegt ist, muss schedule_uid oder schedule_name angegeben werden. Wenn collection_mode auf 1 festgelegt ist, wird schedule_uid oder schedule_name ignoriert, wenn angegeben.

• [ @schedule\_name = ] 'schedule_name'
  Name des Zeitplans. schedule_name ist vom Datentyp sysname und lässt NULL-Werte zu. Wenn angegeben, muss schedule_uid NULL sein. Um schedule_name abzurufen, fragen Sie die sysschedules-Systemtabelle ab.

• [ @logging\_level = ] logging_level
  Die Protokollierungsstufe. logging_level ist vom Datentyp smallint. Die folgenden Werte sind möglich:

  0 - Informationen zur Protokollausführung und zu den SSIS-Ereignissen, die Folgendes nachverfolgen:

  • Starten/Beenden von Auflistsätzen

  • Starten/Beenden von Paketen

  • Fehlerinformationen

  1 - Protokollierung Stufe 0 und:

  • Ausführungsstatistiken

  • Kontinuierliche Ausführung der Auflistung

  • Warnungsereignisse von SSIS

  2 - Protokollierung Stufe 1 sowie ausführliche Ereignisinformationen von SSIS.

  Der Standardwert für logging_level ist 1.

• [ @description = ] 'description'
  Die Beschreibung für den Auflistsatz. description ist vom Datentyp nvarchar(4000).

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_syscollector_update_collection_set muss im Kontext der msdb-Systemdatenbank ausgeführt werden.

Entwedercollection_set_id oder name muss über einen Wert verfügen; es können nicht beide NULL lauten. Um diese Werte abzurufen, fragen Sie die syscollector_collection_sets-Systemsicht ab.

Wenn der Auflistsatz ausgeführt wird, können Sie nur schedule_uid und description aktualisieren. Um den Auflistsatz zu beenden, verwenden Sie sp_syscollector_stop_collection_set.

Berechtigungen

Zum Ausführen dieser Prozedur ist die Mitgliedschaft in der festen Datenbankrolle dc_admin oder dc_operator (mit EXECUTE-Berechtigung) erforderlich. Obwohl die dc_operator-Rolle diese gespeicherte Prozedur ausführen kann, können die Eigenschaften von den Mitgliedern dieser Rolle nur begrenzt geändert werden. Die folgenden Eigenschaften können nur von dc_admin geändert werden:

• @new\_name

• @target

• @proxy\_id

• @description

• @collection\_mode

• @days\_until\_expiration

Beispiele

A. Umbenennen eines Auflistsatzes

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. Wechseln vom Auflistmodus ohne Zwischenspeicherung in den Modus mit Zwischenspeicherung

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. Ändern von anderen Auflistsatzparametern

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

Änderungsverlauf

Siehe auch

Verweis

Andere Ressourcen