ALTER sesji zdarzeń języka Transact-SQL)

Uruchamia lub zatrzymuje zdarzeniesesja lub zmieniasesja zdarzeniekonfiguracja

Ikona łącza do tematu Języka Transact-SQL składni konwencje

Składnia

ALTER EVENT SESSION event_session_name
ON SERVER
{
    [ [ {  <add_drop_event> [ ,...n] }   
       | { <add_drop_event_target> [ ,...n ] } ] 
    [ WITH ( <event_session_options> [ ,...n ] ) ]
    ]
    | [ STATE = { START | STOP } ]
}

<add_drop_event>::=
{
    [ ADD EVENT <event_specifier> 
         [ ( { 
                 [ SET { event_customizable_attribute = <value> [ ,...n ] } ]
                 [ ACTION ( { [event_module_guid].event_package_name.action_name [ ,...n ] } ) ]
                 [ WHERE <predicate_expression> ]
        } ) ]
   ] 
   | DROP EVENT <event_specifier> }

<event_specifier> ::=
{
[event_module_guid].event_package_name.event_name
}

<predicate_expression> ::= 
{
    [ NOT ] <predicate_factor> | {( <predicate_expression> ) } 
    [ { AND | OR } [ NOT ] { <predicate_factor> | ( <predicate_expression> ) } ] 
    [ ,...n ]
}
 
<predicate_factor>::= 
{
    <predicate_leaf> | ( <predicate_expression> )
}

<predicate_leaf>::=
{
      <predicate_source_declaration> { = | < > | ! = | > | > = | < | < = } <value> 
    | [event_module_guid].event_package_name.predicate_compare_name ( <predicate_source_declaration>, <value> ) 
}

<predicate_source_declaration>::= 
{
    event_field_name | ( [event_module_guid].event_package_name.predicate_source_name )
}

<value>::= 
{
    number | 'string'
}

<add_drop_event_target>::=
{
    ADD TARGET <event_target_specifier>
        [ ( SET { target_parameter_name = <value> [ ,...n] } ) ]
    | DROP TARGET <event_target_specifier>
}

<event_target_specifier>::=
{
    [event_module_guid].event_package_name.target_name
}

<event_session_options>::=
{
    [    MAX_MEMORY = size [ KB | MB ] ]
    [ [,] EVENT_RETENTION_MODE = { ALLOW_SINGLE_EVENT_LOSS | ALLOW_MULTIPLE_EVENT_LOSS | NO_EVENT_LOSS } ]
    [ [,] MAX_DISPATCH_LATENCY = { seconds SECONDS | INFINITE } ]
    [ [,] MAX_EVENT_SIZE = size [ KB | MB ] ]
    [ [,] MEMORY_PARTITION_MODE = { NONE | PER_NODE | PER_CPU } ]
    [ [,] TRACK_CAUSALITY = { ON | OFF } ]
    [ [,] STARTUP_STATE = { ON | OFF } ]
}

Argumenty

Termin	Definicja
event_session_name	Jest nazwą istniejącejsesja zdarzenie.
Państwo = START \| ZATRZYMAJ	Uruchamia lub zatrzymuje zdarzenie sesja.Ten argument jest prawidłowy tylko w sesji ALTER zdarzeń jest stosowany do obiektusesja zdarzenie.
Dodawanie zdarzeń <event_specifier>	zdarzenie identyfikowane przez <event_specifier>z zdarzeniesesja.
[event_module_guid].event_package_name.event_name	Jest nazwą zdarzenie w zdarzenie pakiet, gdzie: event_module_guidto identyfikator GUID dla modułu, który zawiera zdarzenie. event_package_nameto pakiet , który zawiera obiekt akcja . event_namejest to obiekt zdarzenie . Zdarzenia są wyświetlane w sys.dm_xe_objects Widok jako object_type "zdarzenie".
SET { event_customizable_attribute = <value > ,...n] }	Określa atrybuty można dostosowywać dla zdarzenie.Można dostosować atrybuty pojawiają się w sys.dm_xe_object_columns Widok jako column_type "można dostosowywać" and object_name = event_name.
ACTION ( { event_module_guid.event_package_name.action_name,...n] } )	akcja Aby skojarzyć zdarzeniesesjaw przypadku gdy: event_module_guidto identyfikator GUID dla modułu, który zawiera zdarzenie. event_package_nameto pakiet , który zawiera obiekt akcja . action_namejest to obiekt akcja . Akcje są wyświetlane w sys.dm_xe_objects Widok jako object_type "akcja".
W przypadku gdy <predicate_expression>	Określa predykatu wyrażenie używane do określania zdarzenie powinno być przetworzone.Jeśli <predicate_expression> ma wartość true, zdarzenie jest przetwarzany przez akcje i cele dla sesja.Jeśli <predicate_expression> ma wartość false, zdarzenie zostało porzucone przez sesja przed przetwarzanych przez akcje i cele dla sesja.Predykatu wyrażenia są ograniczone do 3000 znaków, które ogranicza argumentów w ciąg .
event_field_name	Jest nazwą zdarzenie pole identyfikuje źródłopredykatu.
.event_package_name.predicate_source_name [event_module_guid]	Nazwa globalnego predykatu źródło jest w przypadku gdy: event_module_guidto identyfikator GUID dla modułu, który zawiera zdarzenie. event_package_nameto pakiet , który zawiera obiekt predykatu. predicate_source_namezdefiniowane w sys.dm_xe_objects Widok jako object_type "pred_source"
[event_module_guid].event_package_name.predicate_compare_name	Jest nazwą predykatu obiekt ze zdarzenie, gdzie: event_module_guidto identyfikator GUID dla modułu, który zawiera zdarzenie. event_package_nameto pakiet , który zawiera obiekt predykatu. predicate_compare_nameglobalne źródło jest zdefiniowany w sys.dm_xe_objects Widok jako object_type "pred_compare".
UPUŚĆ zdarzenia <event_specifier>	Krople zdarzenie , identyfikowane przez <event_specifier>.<event_specifier> musi być prawidłowa w zdarzenie sesja.
Dodawanie obiektu docelowego <event_target_specifier>	Kojarzy miejsce docelowe identyfikowanego przez <event_target_specifier>z zdarzenie sesja.
[event_module_guid].event_package_name.target_name	Jest to nazwa miejsce docelowe w zdarzenie sesjaw przypadku gdy: event_module_guidto identyfikator GUID dla modułu, który zawiera zdarzenie. event_package_nameto pakiet , który zawiera obiekt akcja . target_namejest to akcja.Akcje są wyświetlane w sys.dm_xe_objects Widok jako object_type "miejsce docelowe".
SET { target_parameter_name = <value > ,...n] }	Ustawia parametr miejsce docelowe .Parametry Target pojawiają się w sys.dm_xe_object_columns Widok jako column_type "można dostosowywać" and object_name = target_name. Ważne: Jeśli używasz bufor dzwonienia miejsce docelowe, zaleca się tego zestaw max_memoryparametrmiejsce docelowe do 2048 kilobajtów (KB), aby uniknąć obcięcia możliwe dane wyjściowe XML. Aby uzyskać więcej informacji o tym, kiedy używać typów różnych miejsce docelowe , zobacz Rozszerzone cele zdarzeń programu SQL Server.
AUTOODTWARZANIE <event_target_specifier>	Krople miejsce docelowe identyfikowanego przez <event_target_specifier>.<event_target_specifier> musi być prawidłowa w zdarzenie sesja.
Z ()<event_session_options > ,... n )	Określa opcje za pomocą zdarzenie sesja.
MAX_MEMORY = size KB \|MB	Określa maksymalną ilość pamięci, aby przydzielić sesja dla buforowania zdarzenie .Wartość domyślna to 4 MB.sizejest liczbą całkowitą, i może być kilobajtów (KB) lub wartość megabajt (MB).Pamięć przydzielona dla celów asynchronicznej jest niezależna od tej wartości.

EVENT_RETENTION_MODE = { ALLOW_SINGLE_EVENT_LOSS \| ALLOW_MULTIPLE_EVENT_LOSS \| NO_EVENT_LOSS}	Określa tryb przechowywania zdarzenie do obsługi zdarzenie utraty. ALLOW_SINGLE_EVENT_LOSS zdarzenie mogą być utracone z sesja.Pojedynczego zdarzenie tylko zostanie usunięte po zapełnieniu buforów zdarzenie .Utraty pojedynczego zdarzenie po zapełnieniu buforów zdarzenie umożliwia dopuszczalne SQL Server charakterystyki wydajności, minimalizując utraty danych w strumieniu przetworzonych zdarzenie . ALLOW_MULTIPLE_EVENT_LOSS Bufory pełnego zdarzenie zawierających wiele zdarzeń mogą zostać utracone z sesja.Liczba utraconych zdarzeń jest zależna od rozmiaru pamięci przydzielonej do sesja, partycjonowanie pamięci i rozmiar zdarzenia w buforze.Opcja ta minimalizuje wpływ na wydajność na serwerze buforów zdarzenie szybko są wypełnione, ale dużej liczby zdarzeń mogą zostać utracone z sesja. NO_EVENT_LOSS Bez utraty zdarzenie jest dozwolone.Ta opcja zapewnia, że zostaną zachowane wszystkie zdarzenia wywoływane.Użycie tej opcji wymusza wszystkie zadania, które ognia zdarzenia poczekać, aż miejsca jest dostępna w buforze zdarzenie .Może to spowodować problemy z wydajnością wykrywalnych podczas zdarzenie sesja jest aktywny.Połączenia użytkownik może się zawiesić podczas oczekiwania na zdarzenia opróżniany z bufora.
MAX_DISPATCH_LATENCY = { seconds SEKUND \| NIESKOŃCZONE }	Określa czas zdarzenia są buforowane w pamięci przed są wysyłane do celówsesja zdarzenie. Minimalny opóźnienie wartość 1 sekunda.Jednakże 0 można określić NIESKOŃCZONY opóźnienie.Domyślnie wartość ta wynosi 30 sekund. secondsSEKUND czas, w sekundach, przed rozpoczęciem opróżnienia buforów do elementów docelowych.secondsjest liczbą całkowitą. NIEOGRANICZONY Opróżnienia buforów do obiektów docelowych, tylko po zapełnieniu buforów lub zamyka zdarzenie sesja . Uwaga: MAX_DISPATCH_LATENCY = 0 SEKUND jest równoważne MAX_DISPATCH_LATENCY = bez ZATRZYMANIA.
MAX_EVENT_SIZE = sizeKB \|MB	Określa maksymalny rozmiar dozwolony dla zdarzeń.MAX_EVENT_SIZE powinien być tylko zestaw na pojedynczego zdarzenia większych niż MAX_MEMORY; ustawienie jej na wartość mniejszą niż MAX_MEMORY podniesie błąd.sizejest liczbą całkowitą, i może być kilobajtów (KB) lub wartość megabajt (MB).Jeśli size określonych w kilobajtach, minimalny dozwolony rozmiar to 64 KB.Gdy MAX_EVENT_SIZE jest zestaw, dwa bufory size są tworzone w uzupełnieniu do MAX_MEMORY.Oznacza to, że całkowita pamięć używana do buforowania zdarzenie jest MAX_MEMORY + 2 * MAX_EVENT_SIZE.
MEMORY_PARTITION_MODE ={ Brak \| PER_NODE \| PER_CPU}	Określa lokalizację, w których są tworzone buforów zdarzenie . BRAK Pojedynczy zestaw buforów jest tworzony w SQL Server wystąpienie. PER_NODEzestaw buforów jest tworzony dla każdego węzeł NUMA.Aby uzyskać więcej informacji, zobacz Opis niejednolity dostęp do pamięci. PER_CPUzestaw buforów jest tworzony dla każdego Procesora.
TRACK_CAUSALITY ={ON \| OFF }	Określa, czy jest śledzona związku przyczynowego.Włączenie przyczynowości pozwala na innym serwerze połączenia skorelowane ze sobą powiązane z nimi zdarzenia.
STARTUP_STATE ={ON \| OFF }	Określa, czy zdarzenie sesja automatycznego uruchamiania podczas SQL Server uruchomieniu. Uwaga: Jeśli STARTUP_STATE = ON, start tylko zdarzenie sesja będzie, jeśli SQL Server jest zatrzymana, a następnie uruchomić ponownie. TerminDefinicja NAzdarzeniesesja jest uruchomiona podczas uruchamiania. WYŁĄCZANIEzdarzeniesesja nie jest uruchomiona podczas uruchamiania.

Uwagi

Argumenty Dodaj i UPUSZCZANIA nie można używać w tej samej instrukcja.

Uprawnienia

Wymaga uprawnień sterowania serwera.

Przykłady

Poniższy przykład uruchamia zdarzenie sesja, uzyskuje niektórych statystyk żywych sesja i następnie dodaje dwa zdarzenia do istniejącej sesja.

-- Start the event session
ALTER EVENT SESSION test_session
ON SERVER
STATE = start
GO
-- Obtain live session statistics 
SELECT * FROM sys.dm_xe_sessions
SELECT * FROM sys.dm_xe_session_events
GO

-- Add new events to the session
ALTER EVENT SESSION test_session ON SERVER
ADD EVENT sqlserver.database_transaction_begin,
ADD EVENT sqlserver.database_transaction_end
GO