使用查询活动监视正在运行的 T-SQL 查询和已完成的 T-SQL 查询

适用于:✅ SQL 分析端点和 Microsoft Fabric 中的仓库

监视 SQL 查询对于监视 Fabric 仓库的性能和排查其问题以及维护仓库效率至关重要。 使用查询活动,可以一站式查看所有正在运行的 T-SQL 查询和历史 T-SQL 查询,以及长时间运行和频繁运行的查询列表,而无需运行任何 T-SQL 代码。 可以使用查询活动来确保查询的执行时间不会超过预期,并且能够成功完成。

先决条件

  • 必须是工作区中的管理员才能访问查询活动。 成员、参与者和查看者无权访问此视图。

开始使用

有两种方法可以启动查询活动体验。

  • 在工作区视图中,选择要监视的仓库旁边的“更多选项(...)”,然后选择“查询活动”。

    工作区关联菜单中查询活动入口点的屏幕截图。

  • 在要监视的仓库的查询编辑器中,选择功能区中的“查询活动”。

    功能区中查询活动入口点的屏幕截图。

查询运行

在“查询运行”页上,可以看到过去 30 天内正在运行、成功、取消和失败的查询列表。

  • 使用下拉列表来筛选状态、提交者或提交时间。
  • 使用搜索栏来筛选查询文本或其他列中的特定关键字。

对于每个查询,提供以下详细信息:

列名 说明
分布式语句 ID 每个查询的唯一 ID
查询文本 已执行查询的文本(最多 8,000 个字符)
提交时间 (UTC) 请求到达时的时间戳
Duration 执行查询所花费的时间
Status 查询状态(正在运行、成功、失败或已取消)
“提交者” 发送查询的用户或系统的名称
会话 ID 将查询链接到特定用户会话的 ID
运行源 启动会话的客户端程序的名称

如果要重新加载页面上显示的查询,请选择功能区中的“刷新”按钮。 如果看到要立即停止执行的查询,请使用复选框选择查询,然后选择“取消”按钮。 在取消查询之前,系统将提示一个对话框进行确认。 属于你选择的同一 SQL 会话的任何未选择的查询也将被取消。

查询运行取消对话框的屏幕截图。

还可以使用动态管理视图找到有关运行查询的相同信息。

查询见解

在“查询见解”页上,可以看到长期运行的查询和频繁运行的查询列表,以帮助确定仓库查询中的任何趋势。

对于长期查询见解中的每个查询,提供以下详细信息:

列名 说明
查询文本 已执行查询的文本(最多 8,000 个字符)
运行持续时间中值 跨运行的查询执行时间中值(毫秒)
运行计数 执行查询的总次数
上次运行持续时间 上次执行所用的时间(毫秒)
上次运行分布式语句 ID 上次查询执行的唯一 ID
上次运行会话 ID 上次执行的会话 ID

对于频繁运行的查询见解中的每个查询,提供以下详细信息:

列名 说明
查询文本 已执行查询的文本(最多 8,000 个字符)
平均运行持续时间 跨运行的平均查询执行时间(毫秒)
最大持续时间 最长查询执行时间(毫秒)
最短持续时间 最短查询执行时间(毫秒)
上次运行分布式语句 ID 上次查询执行的唯一 ID
运行计数 执行查询的总次数
成功运行计数 成功执行查询的次数
失败的运行计数 失败的查询执行数
已取消的运行计数 已取消的查询执行数

有关查询运行中已完成、失败和已取消的查询以及聚合见解的相同信息,也可以在 Fabric 数据仓库中的查询见解中找到。

限制

  • 历史查询可能需要长达 15 分钟才能显示在查询活动中,具体取决于正在执行的并发工作负载。
  • 对于给定的筛选器选择,“查询运行”和“查询见解”选项卡中只能显示前 10,000 行。
  • 如果在创建新仓库后立即打开查询活动,则可能会发生“无效的对象名称 queryinsights.exec_requests_history”错误,原因是尚未生成基础系统视图。 解决方法是等待两分钟,然后刷新页面。