Condividi tramite


sp_syscollector_start_collection_set (Transact-SQL)

Avvia un insieme di raccolta se l'agente di raccolta è già abilitato e l'insieme 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 insieme di raccolta.

Icona di collegamento a un argomentoConvenzioni 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 locale univoco per l'insieme 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 dell'insieme 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 insieme di raccolta che non include una pianificazione. Se l'insieme di raccolta non include una pianificazione, ad esempio perché la raccolta è impostata sulla modalità non in cache, utilizzare la stored procedure sp_syscollector_run_collection_set per avviare l'insieme di raccolta.

Questa procedura abilita i processi di raccolta e di caricamento per l'insieme di raccolta specificato e avvia immediatamente il processo dell'agente di raccolta se l'insieme di raccolta è impostato sulla modalità cache (0). Per ulteriori informazioni, vedere sp_syscollector_create_collection_set.

Se l'insieme 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 all'insieme di raccolta non è associato un account proxy, è richiesta l'appartenenza al ruolo predefinito del server sysadmin.

Esempi

Nell'esempio seguente viene avviato un insieme di raccolta utilizzando il relativo identificatore.

USE msdb;
GO
EXEC sp_syscollector_start_collection_set @collection_set_id = 1;