sp_syscollector_run_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 è configurato per la modalità di raccolta non memorizzata nella cache.

Nota

Questa procedura ha esito negativo se viene eseguita su un set di raccolta configurato per la modalità di raccolta memorizzata nella cache.

sp_syscollector_run_collection_set consente a un utente di acquisire snapshot di dati su richiesta.

Convenzioni di sintassi Transact-SQL

Sintassi

sp_syscollector_run_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 un valore predefinito , NULLe deve avere un valore se @name è NULL.

[ @name = ] N'name'

Nome del set di raccolta. @name è sysname, con un valore predefinito , NULLe deve avere un valore se @collection_set_id è NULL.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

Sia @collection_set_id che @name devono avere un valore, entrambi non possono essere NULL.

Questa procedura avvia 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 il relativo @collection_mode impostato su non memorizzato nella cache (1). Per altre informazioni, vedere sp_syscollector_create_collection_set (Transact-SQL).

sp_sycollector_run_collection_set può essere usato anche per eseguire un set di raccolta che non ha una pianificazione.

Autorizzazioni

Per eseguire questa procedura, è richiesta l'appartenenza al ruolo predefinito del database dc_operator (con autorizzazione EXECUTE).

Esempi

Avviare un set di raccolta utilizzandone l'identificatore.

USE msdb;
GO
EXEC sp_syscollector_run_collection_set
    @collection_set_id = 1;

Contenuto correlato