sp_syscollector_start_collection_set (Transact-SQL)
Avvia un set di raccolta se l'agente di raccolta è già abilitato e il set di raccolta non è in esecuzione. Se l'agente di raccolta non è abilitato, abilitarlo eseguendo sp_syscollector_enable_collector, quindi utilizzare la stored procedure per avviare un set di raccolta.
.gif "Icona di collegamento a un argomento")
Sintassi
sp_syscollector_start_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 è di tipo int e il valore predefinito è NULL. collection_set_id deve avere un valore se name è NULL.[ @name = ] 'name'
Nome del set di raccolta. name è di tipo sysname e il valore predefinito è NULL. name deve avere un valore se collection_set_id è NULL.
Valori dei codici restituiti
0 (esito positivo) o 1 (esito negativo)
Osservazioni
È necessario eseguire sp_syscollector_create_collection_set nel contesto del database di sistema msdb e SQL Server Agent deve essere abilitato.
Questa procedura ha esito negativo se viene eseguita in un set di raccolta che non include una pianificazione. Se al set di raccolta non è associata una pianificazione, ad esempio poiché la raccolta è impostata sulla modalità non in cache, utilizzare la stored procedure sp_syscollector_run_collection_set per avviare il set di raccolta.
Questa procedura abilita i processi di raccolta e di caricamento per il set di raccolta specificato e avvierà immediatamente il processo dell'agente di raccolta se il set di raccolta è impostato sulla modalità cache (0). Per ulteriori informazioni, vedere sp_syscollector_create_collection_set.
Se il set di raccolta non contiene alcun elemento della raccolta, questa operazione non ha alcun effetto. Viene restituito l'errore 14685 come avviso.
Autorizzazioni
Per eseguire questa procedura, è necessaria l'appartenenza al ruolo predefinito del database dc_operator. Se al set di raccolta non è associato un account proxy, è richiesta l'appartenenza al ruolo predefinito del server sysadmin.
Esempi
Nell'esempio seguente viene avviato un set di raccolta utilizzando il relativo identificatore.
USE msdb;
GO
EXEC sp_syscollector_start_collection_set @collection_set_id = 1;
Vedere anche