sp_syscollector_update_collection_set (języka Transact-SQL)
Używane do modyfikowania właściwości zdefiniowane przez użytkownika kolekcja,zestaw lub zmienić nazwę zdefiniowane przez użytkownika kolekcja,zestaw.
.gif "Ikona łącza do tematu")
Składnia
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
Jest unikatowy identyfikator lokalny dla kolekcja zestaw.collection_set_idjest int i musi mieć wartość, jeśli name ma wartość NULL.[ @name = ] 'name'
Jest to nazwa kolekcja zestaw.namejest sysname i musi mieć wartość, jeśli collection_set_id ma wartość NULL.[ @new_name = ] 'new_name'
To nowa nazwa kolekcja zestaw.new_namejest sysname, i jeśli używana, nie może być pustym ciąg.new_namemusi być unikatowa.Lista nazwy bieżącegozestaw kolekcjakwerendy syscollector_collection_sets systemu widoku.[ @target = ] 'target'
Zarezerwowane do użytku w przyszłości.[ @collection_mode = ] collection_mode
Jest to typ danych kolekcja używać.collection_modejest smallint i może mieć jedną z następujących wartości:0 - Tryb buforowany.kolekcja danych i przekazywania znajdują się na osobne harmonogramy.Określ tryb pamięci podręcznej dla stałego kolekcja.
1 - Tryb niebuforowany.kolekcja danych i przekazywania jest według tego samego harmonogramu.Określić tryb ad hoc kolekcja lub migawka kolekcja-buforowane.
Jeśli zmiany trybu buforowanego tryb buforowany (0), należy również określić albo schedule_uid lub schedule_name.
[ @days_until_expiration= ] days_until_expiration
To liczba dni, w których zebrane dane są zapisywane w zarządzanie magazyn danych.days_until_expirationis smallint.days_until_expirationmusi być dodatnią liczbą całkowitą lub 0.[ @proxy_id = ] proxy_id
Jest identyfikator unikatowy dla SQL Server konto proxyagenta.proxy_idis int.[ @proxy_name = ] 'proxy_name'
Jest nazwą serwera proxy.proxy_namejest sysname oraz nullable.[ @schedule_uid = ] 'schedule_uid'
To identyfikator GUID, który wskazuje na harmonogram.schedule_uidis uniqueidentifier.Aby uzyskać schedule_uid, kwerenda sysschedules tabela systemowa.
Gdy collection_mode jest zestaw na 0, schedule_uid lub schedule_name musi być określony.Gdy collection_mode jest zestaw na 1, schedule_uid lub schedule_name jest ignorowane, jeśli określono.
[ @schedule_name = ] 'schedule_name'
Jest to nazwa harmonogramu.schedule_namejest sysname oraz nullable.Jeśli określony, schedule_uid musi mieć wartość NULL.Aby uzyskać schedule_name, kwerenda sysschedules tabela systemowa.[ @logging_level = ] logging_level
Jest poziomrejestrowania.logging_leveljest smallint z jedną z następujących wartości:0 - Informacje wykonanie dziennika i SSIS zdarzenia, które śledzą:
Uruchamianie zatrzymywania kolekcja zestawów
Uruchamianie zatrzymania pakietów
Informacje o błędach
1 - Rejestrowanie poziom 0 i:
Wykonanie statystyki
Stale uruchomiony postępu kolekcja
Zdarzenia ostrzegawcze zSSIS
2 - Level 1 rejestrowania i informacje szczegółowe zdarzenie z SSIS.
Wartość domyślna dla logging_level 1.
[ @description = ] 'description'
Jest opis kolekcja zestaw.descriptionis nvarchar(4000).
Wartości kodów powrotnych
0(sukces) lub 1 (błąd)
Uwagi
sp_syscollector_update_collection_setmusi być uruchamiany w kontekście msdb systemu bazy danych.
Albo collection_set_id lub name musi mieć wartość, nie może być NULL.Aby uzyskać te wartości, kwerenda syscollector_collection_sets systemu widoku.
Jeśli kolekcja zestaw jest uruchomiony, można zaktualizować tylko schedule_uid i description.Aby zatrzymać kolekcja zestaw, sp_syscollector_stop_collection_set.
Uprawnienia
Wymaga członkostwa w dc_admin lub dc_operator (z uprawnieniem Wykonywanie) ustalony rola bazy danych do wykonać tej procedury.Chociaż dc_operator można uruchomić tę procedura składowana, Członkowie tej roli są ograniczone właściwości umożliwiających im zmiany.Następujące właściwości mogą być zmieniane tylko przez dc_admin:
@new_name
@target
@proxy_id
@description
@collection_mode
@days_until_expiration
Przykłady
A.Zmiana nazwy kolekcja,zestaw
Poniższy przykład zmienia nazwy zdefiniowane przez użytkownika kolekcja,zestaw.
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 trybu kolekcja z niebuforowana do pamięci podręcznej
Poniższy przykład zmienia tryb kolekcja z trybu buforowanego tryb buforowany.Zmiana ta wymaga określenia identyfikator 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.Zmiana innych parametrówzestaw kolekcja
Poniższy przykład aktualizuje różne właściwości kolekcjazestaw o nazwie 'prosty kolekcja,zestaw test 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
Zobacz także