Freigeben über

  • Artikel

sp_syscollector_start_collection_set (Transact-SQL)

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

Themenlink (Symbol)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 Auflistsatz. collection_set_id ist vom Datentyp int mit dem Standardwert NULL. collection_set_id muss über einen Wert verfügen, wenn name gleich NULL ist.

  • [ @name = ] 'name'
    Der Name des Auflistsatzes. name ist sysname mit dem Standardwert NULL. name muss über einen Wert verfügen, wenn collection_set_id gleich 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 SQL Server-Agent muss aktiviert sein.

Bei dieser Prozedur tritt ein Fehler auf, wenn sie für einen Auflistsatz ohne Zeitplan ausgeführt wird. Wenn der Auflistsatz ü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 Auflistsatz zu speichern.

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

Wenn der Auflistsatz keine Auflistelemente 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 Auflistsatz über kein Proxykonto verfügt, ist die Mitgliedschaft in der festen Serverrolle sysadmin erforderlich.

Beispiele

Im folgenden Beispiel wird ein Auflistsatz mithilfe seines Bezeichners gestartet.

USE msdb;
GO
EXEC sp_syscollector_start_collection_set @collection_set_id = 1;