sp_syscollector_run_collection_set (Transact-SQL)
Startet einen Sammlungssatz, wenn der Sammler bereits aktiviert ist und der Sammlungssatz für den Sammlungsmodus 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 Sammlungsmodus mit Zwischenspeicherung konfiguriert ist. |
sp_syscollector_run_collection_set ermöglicht dem Benutzer die bedarfsgesteuerte Aufnahme von Datenmomentaufnahmen.
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-Agenten, 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 auszuführen, der über keinen Zeitplan verfügt.
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