共用方式為

  • 發行項

sys.server_event_sessions (Transact-SQL)

列出 SQL Server 中所存在的所有事件工作階段定義。

資料行名稱

資料類型

描述

event_session_id

int

事件工作階段的唯一識別碼。不可設為 Null。

name

sysname

用來識別事件工作階段的使用者自訂名稱。name 是唯一的。不可設為 Null。

event_retention_mode

nchar(1)

判斷如何處理事件遺失。為下列其中一項：

  • S。對應至 event_retention_mode_desc = ALLOW_SINGLE_EVENT_LOSS

  • M。對應至 event_retention_mode_desc = ALLOW_MULTIPLE_EVENT_LOSS

  • N。對應至 event_retention_mode_desc = NO_EVENT_LOSS

預設值為 S。不可設為 Null。

event_retention_mode_desc

sysname

描述如何處理事件遺失。為下列其中一項：

  • ALLOW_SINGLE_EVENT_LOSS。事件可能會從工作階段遺失。只有當所有事件緩衝區已滿時，才會卸除單一事件。當緩衝區已滿時遺失單一事件會允許可接受的 SQL Server 效能特性，同時也可讓處理之事件資料流中的遺失情形降至最低。

  • ALLOW_MULTIPLE_EVENT_LOSS。完整事件緩衝區可能會從工作階段遺失。遺失的事件數目取決於配置給工作階段的記憶體大小、記憶體的分割及緩衝區中的事件大小。當事件緩衝區被快速填滿時，這個選項可對伺服器的效能影響降至最低。但是，可能會從工作階段中遺失大量的事件數目。

  • NO_EVENT_LOSS。不允許事件遺失。這個選項可確保將會保留所有引發的事件。使用這個選項可強制引發事件的所有工作等候到事件緩衝區中有可用的空間為止。這樣可以在事件工作階段為使用中時偵測效能降低的問題。

預設值為 ALLOW_SINGLE_EVENT_LOSS。不可設為 Null。

max_dispatch_latency

int

指定事件在對工作階段目標提供服務之前，將於記憶體內緩衝處理的時間量 (以秒鐘為單位)。有效的值是從 1 到 2147483648 及 -1。-1 的值表示分派延遲為無限大。可為 Null。

max_memory

int

為了事件緩衝處理而配置給工作階段的記憶體數量。預設值為 4 MB。可為 Null。

max_event_size

int

保留給不適合事件工作階段緩衝區之事件的記憶體數量。如果 max_event_size 超出計算而來的緩衝區大小，會將 max_event_size 的兩個額外緩衝區配置給事件工作階段。可為 Null。

memory_partition_mode

nchar(1)

事件緩衝區在記憶體中的建立位置。memory_partition_mode 是下列其中一項：

  • G - NONE

  • C - PER_CPU

  • N - PER_NODE

預設的分割模式為 G。不可設為 Null。

memory_partition_mode_desc

sysname

為下列其中一項：

  • NONE。SQL Server 執行個體內會建立單一組緩衝區。

  • PER_CPU。會針對每一個 CPU 建立一組緩衝區。

  • PER_NODE。會針對每一個非統一記憶體存取 (NUMA) 節點建立一組緩衝區。

預設值是 NONE。不可設為 Null。

track_causality

bit

啟用或停用因果追蹤。如果設定為 1 (ON)，會啟用追蹤，而且不同伺服器連接上的相關事件會彼此相互關聯。預設值是 0 (OFF)。不可設為 Null。

startup_state

bit

可決定當伺服器啟動時，是否要自動啟動工作階段的值。是下列其中一項：

  • 0 (OFF)。當伺服器啟動時，此工作階段不會啟動。

  • 1 (ON)。當伺服器啟動時，會啟動此事件工作階段。

預設值為 0。不可設為 Null。

權限

需要伺服器的 VIEW SERVER STATE 權限。