sp_syscollector_run_collection_set (Transact-SQL)

Startet einen Sammlungssatz, wenn der Sammler bereits aktiviert ist und der Sammlungssatz für den Auflistmodus ohne Zwischenspeicherung konfiguriert ist.

Hinweis
Bei dieser Prozedur tritt ein Fehler auf, wenn sie für einen Sammlungssatz ausgeführt wird, der für den Auflistmodus mit Zwischenspeicherung konfiguriert ist.

sp_syscollector_run_collection_set ermöglicht es Benutzern, bedarfsgesteuerte Datenmomentaufnahmen zu erstellen.

Transact-SQL-Syntaxkonventionen

Syntax

sp_syscollector_run_collection_set [[ @collection_set_id = ] collection_set_id ]
          , [[ @name = ] 'name' ] 

Argumente

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

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

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

Entweder collection_set_id oder name muss über einen Wert verfügen; es können nicht beide NULL lauten.

Diese Prozedur startet die Sammlungs- und Uploadaufträge für den angegebenen Sammlungssatz und startet umgehend den Auftrag des Sammlungs-Agent, wenn für den Sammlungssatz der zugehörige @collection_mode-Satz auf den Modus ohne Zwischenspeicherung (1) festgelegt ist. Weitere Informationen finden Sie unter sp_syscollector_create_collection_set (Transact-SQL).

sp_sycollector_run_collection_set kann auch verwendet werden, um einen Sammlungssatz ohne Zeitplan auszuführen.

Berechtigungen

Damit diese Prozedur ausgeführt werden kann, ist die Mitgliedschaft in der festen Datenbankrolle dc_operator (mit EXECUTE-Berechtigung) erforderlich.

Beispiel

Starten Sie einen Sammlungssatz unter Verwendung des zugehörigen Bezeichners.

USE msdb;
GO
EXEC sp_syscollector_run_collection_set @collection_set_id = 1

Siehe auch

Verweis

Gespeicherte Systemprozeduren (Transact-SQL)

Konzepte

Datensammlung