Udostępnij za pośrednictwem


sp_syscollector_run_collection_set (Transact-SQL)

Dotyczy:programu SQL Server

Uruchamia zestaw kolekcji, jeśli moduł zbierający jest już włączony, a zestaw kolekcji jest skonfigurowany dla trybu kolekcji niebuforowanej.

Nuta

Ta procedura kończy się niepowodzeniem, jeśli jest uruchamiana względem zestawu kolekcji skonfigurowanego na potrzeby trybu zbierania w pamięci podręcznej.

sp_syscollector_run_collection_set umożliwia użytkownikowi wykonywanie migawek danych na żądanie.

Transact-SQL konwencje składni

Składnia

sp_syscollector_run_collection_set
    [ [ @collection_set_id = ] collection_set_id ]
    [ , [ @name = ] N'name' ]
[ ; ]

Argumenty

[ @collection_set_id = ] collection_set_id

Unikatowy identyfikator lokalny zestawu kolekcji. @collection_set_id jest int z wartością domyślną NULLi musi mieć wartość, jeśli @name jest NULL.

[ @name = ] N'name'

Nazwa zestawu kolekcji. @name jest nazwa systemuz wartością domyślną NULLi musi mieć wartość, jeśli @collection_set_id jest NULL.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Uwagi

Zarówno @collection_set_id, jak i @name muszą mieć wartość, nie można NULL.

Ta procedura uruchamia zadania zbierania i przekazywania dla określonego zestawu kolekcji, a natychmiast uruchamia zadanie agenta kolekcji, jeśli zestaw kolekcji ma ustawioną @collection_mode na niebuforowaną (1). Aby uzyskać więcej informacji, zobacz sp_syscollector_create_collection_set.

sp_syscollector_run_collection_set można również użyć do uruchomienia zestawu kolekcji, który nie ma harmonogramu.

Uprawnienia

Wymaga członkostwa w dc_operator (z uprawnieniem EXECUTE) stałej roli bazy danych w celu wykonania tej procedury.

Przykłady

Uruchom zestaw kolekcji przy użyciu jego identyfikatora.

USE msdb;
GO
EXEC sp_syscollector_run_collection_set
    @collection_set_id = 1;