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.

Convenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

• [ @collection\_set\_id = ] collection_set_id
  Identificatore univoco locale del set di raccolta. collection_set_id è int e il valore predefinito è NULL. collection_set_id deve disporre di un valore se name è NULL.

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

Valori 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

Riferimento

Stored procedure dell'agente di raccolta dati (Transact-SQL)

syscollector_collection_sets (Transact-SQL)

Concetti

Raccolta dati