擴充事件

功能性的

列出擴充事件工作階段及其執行狀態與每個工作階段的詳細資訊;啟動和停止以指令碼為先。

左右並排的兩個網格:左邊列出各個工作階段及其啟動狀態、目前是否正在執行;選取其中一個, 顯示事件與目標 會把該工作階段的事件與目標填進右側網格。啟動和停止工作階段是 腳本優先: 產生啟動腳本 和 產生停止腳本 開啟精確的 ALTER EVENT SESSION … STATE = START|STOP 會在分頁中開啟陳述式讓你審核,而不是直接從對話方塊執行——頁尾也這麼寫。

範圍感知。 從資料庫開啟時,它會列出該資料庫自身範圍內的工作階段(sys.database_event_sessions。從命令面板開啟時,它會列出該執行個體的伺服器層級工作階段;而在只有資料庫層級工作階段的 Azure SQL Database 上,則會自動改列那些。
SQLly
SQLly 擴充事件窗格
擴充事件:含執行狀態的工作階段清單、每個工作階段的事件/目標詳細資料,以及以指令碼為先的啟動/停止。

開啟它

  • 對單一資料庫: 在物件總管中對資料庫按右鍵,然後選擇 工具 › 延伸事件...。SQLly 會先把該資料庫設為使用中。對話方塊標題的結尾是 (資料庫範圍).
  • 對整個執行個體: 執行 擴充事件... 來自 命令面板。標題結尾是 (伺服器範圍)。如果伺服器範圍的目錄讀不到——例如在 Azure SQL Database 上——面板會改用資料庫範圍重試,標題會標明這一點。

檢視工作階段並加以停止

假設同事留下一個執行中的追蹤工作階段,而你想在關閉它之前先確認它擷取了哪些內容:

  1. 開啟擴充事件。左側網格會依名稱列出每個工作階段,以及 startup_state (是否隨伺服器啟動)以及 is_running (1 當它目前正在使用中)。
  2. 選取該工作階段的資料列,然後按 顯示事件與目標。右側的網格標題為 事件和目標 - <session>,列出 event_name 和 target_name 鍵值組,例如 sql_batch_completed 寫入某個 event_file 目標。
  3. 按 產生停止腳本。對話方塊關閉並開一個查詢分頁,語句就在裡面,由你自己檢查後執行:
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,該 查詢洞察 已經能讀取。