sp_syscollector_start_collection_set (Transact-SQL)

  • Articolo

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 di 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 il set di raccolta non ha un account proxy, è necessaria 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;

Contenuto correlato