sp_syscollector_run_collection_set (Transact-SQL)

Avvia un set di raccolta se l'agente di raccolta è già abilitato e il set di raccolta è configurato per la modalità di raccolta non in cache.

Nota

Questa procedura avrà esito negativo se eseguita in un set di raccolta configurato per la modalità di raccolta in modalità memorizzata nella cache.

sp_syscollector_run_collection_set consente a un utente di acquisire snapshot dei dati su richiesta.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • [ @collection_set_id = ] collection_set_id
    Identificatore locale univoco per il set di raccolta. collection_set_id è int e deve avere un valore se name è NULL.

  • [ @name = ] 'name'
    Nome del set di raccolta. name è sysname e deve avere un valore se collection_set_id è NULL.

Codici restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

È necessario che o collection_set_id o name abbia un valore. Non possono essere entrambi NULL.

Questa procedura consente di avviare i processi di raccolta e di caricamento per il set di raccolta specificato e di avviare immediatamente il processo dell'agente di raccolta se per il set di raccolta l'opzione @collection_mode è impostata come non memorizzata nella cache (1). Per ulteriori informazioni, vedere sp_syscollector_create_collection_set (Transact-SQL).

È possibile utilizzare sp_sycollector_run_collection_set anche per eseguire un set di raccolta senza una pianificazione.

Autorizzazioni

Per eseguire questa procedura è richiesta l'appartenenza al ruolo predefinito del database dc_operator (con autorizzazione EXECUTE).

Esempio

Avviare un set di raccolta utilizzandone l'identificatore.

USE msdb;
GO
EXEC sp_syscollector_run_collection_set @collection_set_id = 1

Vedere anche

Riferimento

Altre risorse