sp_syscollector_run_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 è 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 relative alla 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 , NULL
e deve avere un valore se @name è NULL
.
[ @name = ] N'name'
Nome del set di raccolta. @name è sysname, con un valore predefinito , NULL
e 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.
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;