擴充事件
功能性的列出擴充事件工作階段及其執行狀態與每個工作階段的詳細資訊;啟動和停止以指令碼為先。
左右並排的兩個網格:左邊列出各個工作階段及其啟動狀態、目前是否正在執行;選取其中一個, 顯示事件與目標
會把該工作階段的事件與目標填進右側網格。啟動和停止工作階段是 腳本優先: 產生啟動腳本 和 產生停止腳本
開啟精確的 ALTER EVENT SESSION … STATE = START|STOP 會在分頁中開啟陳述式讓你審核,而不是直接從對話方塊執行——頁尾也這麼寫。
範圍感知。 從資料庫開啟時,它會列出該資料庫自身範圍內的工作階段(
sys.database_event_sessions。從命令面板開啟時,它會列出該執行個體的伺服器層級工作階段;而在只有資料庫層級工作階段的 Azure SQL Database 上,則會自動改列那些。
開啟它
- 對單一資料庫: 在物件總管中對資料庫按右鍵,然後選擇 工具 › 延伸事件...。SQLly 會先把該資料庫設為使用中。對話方塊標題的結尾是 (資料庫範圍).
- 對整個執行個體: 執行 擴充事件... 來自 命令面板。標題結尾是 (伺服器範圍)。如果伺服器範圍的目錄讀不到——例如在 Azure SQL Database 上——面板會改用資料庫範圍重試,標題會標明這一點。
檢視工作階段並加以停止
假設同事留下一個執行中的追蹤工作階段,而你想在關閉它之前先確認它擷取了哪些內容:
- 開啟擴充事件。左側網格會依名稱列出每個工作階段,以及
startup_state(是否隨伺服器啟動)以及is_running(1當它目前正在使用中)。 - 選取該工作階段的資料列,然後按 顯示事件與目標。右側的網格標題為 事件和目標 - <session>,列出
event_name和target_name鍵值組,例如sql_batch_completed寫入某個event_file目標。 - 按 產生停止腳本。對話方塊關閉並開一個查詢分頁,語句就在裡面,由你自己檢查後執行:
ALTER EVENT SESSION [long_running_queries] ON SERVER STATE = STOP;
若建立在資料庫上,陳述式會改用 ON DATABASE 。
產生啟動腳本 產生相同的陳述式,但帶有 STATE = START。工作階段名稱會以方括號括起,任何 ] 會加倍,因此不尋常的名稱也安全。
按鈕
| 按鈕 | 其作用 |
|---|---|
| 重新整理 | 重新讀取工作階段清單,並清除詳細資料網格。 |
| 顯示事件與目標 | 將所選工作階段的事件與目標載入右側的網格。 |
| 產生啟動腳本 / 產生停止腳本 | 開啟 ALTER EVENT SESSION 會在新查詢分頁中開啟所選工作階段的陳述式。對話方塊本身不會執行任何操作。 |
沒有選取任何資料列時,操作會提示你先選取一個工作階段,而不是自己猜。
權限和限制
- 讀取擴充事件的中繼資料需要
VIEW SERVER STATE,或VIEW DATABASE STATE在 Azure SQL 上。如果無法讀取清單,窗格會顯示伺服器的錯誤並附上該提醒。 - 這個窗格會列出工作階段及其設定;它不會建立工作階段,也不會讀取擷取到的事件資料。請撰寫
CREATE EVENT SESSION,並使用常見的函式讀取目標,例如sys.fn_xe_file_target_read_file.
在 SQL Server 系列上,Extended Events 是 SQL Server 的功能。在其他引擎上,選單項目會註明這一點;在 ClickHouse 上,它會把你導向 system.query_log 和 system.trace_log,該 查詢洞察 已經能讀取。