sp_syscollector_start_collection_set (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Startet einen Sammlungssatz, wenn der Collector bereits aktiviert ist und der Sammlungssatz nicht ausgeführt wird. Wenn der Sammelvorgang nicht aktiviert ist, aktivieren Sie den Collector, indem Sie sp_syscollector_enable_collector ausführen und dann diese gespeicherte Prozedur verwenden, um einen Sammlungssatz zu starten.

Transact-SQL-Syntaxkonventionen

Syntax

sp_syscollector_start_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. @collection_set_id muss einen Wert aufweisen, wenn @name istNULL.

[ @name = ] N'name'

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

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Hinweise

sp_syscollector_create_collection_setmuss im Kontext der msdb Systemdatenbank ausgeführt werden, und SQL Server-Agent müssen aktiviert sein.

Diese Prozedur schlägt fehl, wenn sie für einen Sammlungssatz ausgeführt wird, der keinen Zeitplan hat. Wenn der Sammlungssatz keinen Zeitplan hat (da der Sammlungsmodus beispielsweise auf "nicht zwischengespeichert" festgelegt ist), verwenden Sie die sp_syscollector_run_collection_set gespeicherte Prozedur, um den Sammlungssatz zu starten.

Dieses Verfahren aktiviert die Sammlungs- und Uploadaufträge für den angegebenen Sammlungssatz und startet sofort den Sammlungs-Agent-Auftrag, wenn der Sammlungssatz seinen Sammlungsmodus auf zwischengespeichert (0) festgelegt hat. Weitere Informationen finden Sie unter sp_syscollector_create_collection_set.

Wenn der Sammlungssatz keine Sammlungselemente enthält, hat dieser Vorgang keine Auswirkung. Fehler 14685 wird als Warnung zurückgegeben.

Berechtigungen

Erfordert die Mitgliedschaft in der dc_operator festen Datenbankrolle, um diese Prozedur auszuführen. Wenn der Sammlungssatz nicht über ein Proxykonto verfügt, ist die Mitgliedschaft in der festen Serverrolle "sysadmin " erforderlich.

Beispiele

Im folgenden Beispiel wird ein Sammlungssatz mithilfe seines Bezeichners gestartet.

USE msdb;
GO
EXEC sp_syscollector_start_collection_set @collection_set_id = 1;

Zugehöriger Inhalt