sp_syscollector_update_collection_set (Transact-SQL)
Służy do modyfikowania właściwości użytkownika zdefiniowane zestaw kolekcji lub zmienić nazwy użytkownika zdefiniowane zestaw kolekcji.
.gif "Topic link icon")
sp_syscollector_update_collection_set
[ [ @collection_set_id = ] collection_set_id ]
, [ [ @name = ] 'name' ]
, [ [ @new_name = ] 'new_name' ]
, [ [ @target = ] 'target' ]
, [ [ @collection_mode = ] collection_mode ]
, [ [ @days_until_expiration = ] days_until_expiration ]
, [ [ @proxy_id = ] proxy_id ]
, [ [ @proxy_name = ] 'proxy_name' ]
,[ [ @schedule_uid = ] 'schedule_uid' ]
,[ [ @schedule_name = ] 'schedule_uid' ]
, [ [ @logging_level = ] logging_level ]
, [ [ @description = ] 'description' ]
Argumenty
[ @collection\_set\_id = ] collection_set_id
Is the unique local identifier for the collection set.collection_set_id is int and must have a value if name is NULL.[ @name = ] 'name'
Is the name of the collection set.name is sysname and must have a value if collection_set_id is NULL.[ @new\_name = ] 'new_name'
Is the new name for the collection set.new_name is sysname, and if used, cannot be an empty string.new_name must be unique.Aby wyświetlić listę bieżących zestaw kolekcja widoku systemu syscollector_collection_sets kwerendy nazwy.[ @target = ] 'target'
Zarezerwowane do wykorzystania w przyszłości.[ @collection\_mode = ] collection_mode
Is the type of data collection to use.collection_mode is smallint and can have one of the following values:0 - Tryb buforowany.Dane kolekcja i przekazywanie znajdują się na osobne harmonogramy.Określ tryb buforowany ciągłego kolekcja.
1 Tryb nie buforowane.Dane kolekcja i przekazywanie jest na tym samym harmonogramie.Określ tryb ad hoc kolekcja lub w kolekcja migawka nie są buforowane.
Jeśli zmiana z trybu nie są buforowane na tryb buforowany (0), można również wybrać albo schedule_uid lub schedule_name.
[ @days\_until\_expiration= ] days_until_expiration
Is the number of days that the collected data is saved in the management data warehouse.days_until_expiration is smallint.days_until_expiration must be 0 or a positive integer.[ @proxy\_id = ] proxy_id
Is the unique identifier for a SQL Server Agent proxy account.proxy_id is int.[ @proxy\_name = ] 'proxy_name'
Is the name of the proxy.proxy_name is sysname and is nullable.[ @schedule\_uid = ] 'schedule_uid'
Is the GUID that points to a schedule.schedule_uid is uniqueidentifier.Aby uzyskać schedule_uid, tabela systemowa sysschedules kwerendy.
Kiedy collection_mode jest zestaw na 0, schedule_uid lub schedule_name musi być określona. Kiedy collection_mode jest zestaw na 1, schedule_uid lub schedule_name jest ignorowana, jeśli określony.
[ @schedule\_name = ] 'schedule_name'
Is the name of the schedule.schedule_name is sysname and is nullable.Jeśli określono, schedule_uid musi mieć wartość NULL. Aby uzyskać schedule_name, tabela systemowa sysschedules kwerendy.[ @logging\_level = ] logging_level
Is the logging level.logging_level is smallint with one of the following values:0 - Wykonanie informacje i SSIS zdarzenia śledzenia:
Zestawy uruchamiania/zatrzymywania kolekcja
Pakiety uruchamiania/zatrzymywania
Informacje o błędach
1 Poziom-0 rejestrowania oraz:
Wykonanie statystyk
Stale uruchomiony postęp pobierania
Zdarzenia ostrzegawcze SSIS
2 Poziom-1, rejestrowania i szczegółowe informacje o zdarzeniach z SSIS.
Wartość domyślna logging_level wynosi 1.
[ @description = ] 'description'
Is the description of the collection set.description is nvarchar(4000).
Wartości kodów powrotnych
0 (sukces) lub 1 (brak)
Remarks
sp_syscollector_update_collection_set musi być uruchamiane w kontekście systemu bazy danych msdb.
Albo collection_set_id lub name musi mieć wartość, nie może jednocześnie mieć wartości NULL. Aby uzyskać te wartości, kwerendy widoku syscollector_collection_sets systemu.
Jeśli zestaw kolekcja jest uruchomiony, można aktualizować jedynie wówczas schedule_uid i description. Aby zatrzymać zestaw kolekcja, za pomocą sp_syscollector_stop_collection_set.
Uprawnienia
Wymaga członkostwo w roli dc_operator (z uprawnienie wykonać) stałej bazy danych lub dc_admin do wykonać tej procedury.Mimo że dc_operator można uruchomić tę procedura przechowywana, Członkowie tej roli są ograniczone właściwości, które mogą zmieniać.Następujące właściwości mogą być zmieniane tylko przez dc_admin:
@ nowa_nazwa
@ miejsce docelowe
@ proxy_id
Opis @
@ collection_mode
@ days_until_expiration
Przykłady
A.Zmiana nazwy zestaw kolekcja
W poniższym przykładzie zmienia nazwę użytkownika zdefiniowane zestaw kolekcji.
USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Simple collection set test 1',
@new_name = N'Collection set test 1 in cached mode';
GO
B.Zmiana tryb kolekcja bez buforowania do pamięci podręcznej
W poniższym przykładzie zmienia tryb kolekcja z trybu bez buforowania do trybu buforowanego.Zmiana ta wymaga, określ nazwę harmonogramu lub nazwa harmonogramu.
USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Collection set test 1 in cached mode',
@collection_mode = 0,
@schedule_uid = 'C7022AF3-51B8-4011-B159-64C47C88FF70';
-- alternatively, use @schedule_name.
-- @schedule_name = N'CollectorSchedule_Every_15min;
GO
C.Zmienianie innych zestaw kolekcja parametrów
W poniższym przykładzie aktualizuje różne właściwości kolekcja, ustaw o nazwie "Simple kolekcja zestaw przetestować 2 '.
USE msdb;
GO
EXEC dbo.sp_syscollector_update_collection_set
@name = N'Simple collection set test 2',
@collection_mode = 1,
@days_until_expiration = 5,
@description = N'This is a test collection set that runs in noncached mode.',
@logging_level = 0;
GO
Historia zmian
Microsoft Learning |
|---|
Poprawiono identyfikatora GUID dla argumentu @ schedule_uid w przykładzie "" B". |
See Also