sp_syscollector_start_collection_set (Transact-SQL)

Startet einen Sammlungssatz, wenn der Sammler bereits aktiviert ist und der Sammlungssatz nicht ausgeführt wird. Wenn der Sammler nicht aktiviert ist, aktivieren Sie ihn, indem Sie sp_syscollector_enable_collector ausführen und anschließend mit dieser gespeicherten Prozedur einen Sammlungssatz starten.

Transact-SQL-Syntaxkonventionen

Syntax

sp_syscollector_start_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 hat den Standardwert NULL. collection_set_id muss über einen Wert verfügen, wenn name NULL ist.

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

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_syscollector_create_collection_set muss im Kontext der msdb -Systemdatenbank ausgeführt werden, und der SQL Server-Agent muss aktiviert sein.

Bei dieser Prozedur tritt ein Fehler auf, wenn sie für einen Sammlungssatz ohne Zeitplan ausgeführt wird. Wenn der Sammlungssatz über keinen Zeitplan verfügt (weil für ihn beispielsweise der Modus ohne Zwischenspeicherung festgelegt ist), verwenden Sie die gespeicherte sp_syscollector_run_collection_set-Prozedur, um den Sammlungssatz zu speichern.

Diese Prozedur aktiviert die Sammlungs- und Uploadaufträge für den angegebenen Sammlungssatz und startet umgehend den Auftrag des Sammlungs-Agents, wenn für den Sammlungssatz der zugehörige Sammlungsmodus auf die Zwischenspeicherung (0) festgelegt ist. Weitere Informationen finden Sie unter sp_syscollector_create_collection_set.

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

Berechtigungen

Damit diese Prozedur ausgeführt werden kann, ist die Mitgliedschaft in der festen Datenbankrolle dc_operator erforderlich. Wenn der Sammlungssatz über kein 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;

Siehe auch

Verweis

Gespeicherte Prozeduren für den Datensammler (Transact-SQL)

syscollector_collection_sets (Transact-SQL)

Konzepte

Datensammlung