sp_syscollector_run_collection_set (Transact-SQL)

Gilt für:SQL Server

Startet einen Sammlungssatz, wenn der Sammelsammler bereits aktiviert ist und der Sammlungssatz für den Modus nicht zwischengespeicherter Auflistung konfiguriert ist.

Hinweis

Diese Prozedur schlägt fehl, wenn sie für einen Sammlungssatz ausgeführt wird, der für den Cachesammlungsmodus konfiguriert ist.

sp_syscollector_run_collection_setermöglicht es einem Benutzer, On-Demand-Daten Momentaufnahme zu übernehmen.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @collection_set_id = ] collection_set_id

Der eindeutige lokale Bezeichner für den Sammlungssatz. @collection_set_id ist int, mit einem Standardwert von NULL, und muss einen Wert aufweisen, wenn @name ist NULL.

[ @name = ] N'name'

Der Name des Sammlungssatzes. @name ist "sysname" mit einem Standardwert und NULLmuss einen Wert aufweisen, wenn @collection_set_id istNULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Hinweise

Entweder @collection_set_id oder @name müssen einen Wert aufweisen, beide können nicht sein NULL.

Diese Prozedur startet die Sammlungs- und Uploadaufträge für den angegebenen Sammlungssatz und startet sofort den Sammlungs-Agent-Auftrag, wenn der Sammlungssatz seine @collection_mode auf nicht zwischengespeichert (1) festgelegt hat. 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 nicht über einen Zeitplan verfügt.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Datenbankrolle dc_operator (mit EXECUTE-Berechtigung), um dieses Verfahren auszuführen.

Beispiele

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

USE msdb;
GO
EXEC sp_syscollector_run_collection_set
    @collection_set_id = 1;