sp_syscollector_start_collection_set (Transact-SQL)
Si applica a: SQL Server
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, abilitare l'agente di raccolta eseguendo sp_syscollector_enable_collector e quindi usare questa stored procedure per avviare un set di raccolta.
Convenzioni relative alla sintassi Transact-SQL
Sintassi
sp_syscollector_start_collection_set
[ [ @collection_set_id = ] collection_set_id ]
[ , [ @name = ] N'name' ]
[ ; ]
Argomenti
[ @collection_set_id = ] collection_set_id
Identificatore locale univoco per il set di raccolta. @collection_set_id è int, con il valore predefinito NULL
. @collection_set_id deve avere un valore se @name è NULL
.
[ @name = ] N'name'
Nome del set di raccolta. @name è sysname, con un valore predefinito .NULL
@name deve avere un valore se @collection_set_id è NULL
.
Valori del codice restituito
0
(esito positivo) o 1
(errore).
Osservazioni:
sp_syscollector_create_collection_set
deve essere eseguito nel contesto del msdb
database di sistema e è necessario abilitare SQL Server Agent.
Questa procedura ha esito negativo quando viene eseguita su un set di raccolta che non ha una pianificazione. Se il set di raccolta non ha una pianificazione ,perché la modalità raccolta è impostata su non memorizzata nella cache, ad esempio, utilizzare la stored procedure sp_syscollector_run_collection_set per avviare il set di raccolta.
Questa procedura abilita i processi di raccolta e caricamento per il set di raccolta specificato e avvia immediatamente il processo dell'agente di raccolta se il set di raccolta ha la modalità raccolta impostata su memorizzata nella cache (0
). Per altre informazioni, vedere sp_syscollector_create_collection_set.
Se il set di raccolta non contiene elementi di raccolta, questa operazione non ha alcun effetto. Viene restituito l'errore 14685 come avviso.
Autorizzazioni
Per eseguire questa procedura, è richiesta 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;