扩展事件
功能的列出扩展事件会话及其运行状态和每个会话的详细信息;启动和停止以脚本为先。
两个并排的网格:左侧列出各个会话、其启动状态以及当前是否正在运行;选中一个, 显示事件和目标
右侧网格将显示该会话的事件和目标。启动和停止会话是 以脚本为先: 生成启动脚本 和 生成停止脚本
打开确切的 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 系列中,扩展事件是 SQL Server 的一个功能。在其他引擎中,菜单项会提示这一点;在 ClickHouse 上,它会指向 system.query_log 和 system.trace_log,这 查询洞察 已经可以读取。