sp_syscollector_run_collection_set (Transact-SQL)
Avvia un insieme di raccolta se l'agente di raccolta è già abilitato e l'insieme di raccolta è configurato per la modalità di raccolta non in cache.
[!NOTA]
Questa procedura avrà esito negativo se eseguita in un insieme 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.
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 l'insieme di raccolta. collection_set_id è int e deve avere un valore se name è NULL.[ @name = ] 'name'
Nome dell'insieme 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 l'insieme di raccolta specificato e di avviare immediatamente il processo dell'agente di raccolta se per l'insieme 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 insieme 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 insieme di raccolta utilizzandone l'identificatore.
USE msdb;
GO
EXEC sp_syscollector_run_collection_set @collection_set_id = 1