.show graph_snapshots 失败(预览版)

使用 “版本 ”下拉列表切换服务。 了解有关导航的详细信息
适用于:✅ Azure Data Explorer

注释

此功能目前处于公开预览状态。 正式发布之前,功能和语法可能会更改。

显示有关失败的图形快照创建尝试的信息,包括失败原因、错误详细信息和资源消耗统计信息。

Permissions

必须至少具有 Database 用户、数据库查看器或数据库监视器权限才能运行此命令。

Syntax

.show graph_snapshots GraphModelNamefailures

.show graph_snapshots * failures

详细了解语法约定

参数

姓名 类型 必选 Description
GraphModelName string 要为其显示失败快照的图形模型的名称。 如果未指定,则用于 * 显示所有图形模型的故障。

退货

此命令返回具有以下列的表:

类型 Description
OperationId guid 失败作的唯一标识符。
DatabaseName string 包含图形模型的数据库的名称。
ModelName string 图形模型的名称。
ModelId guid 图形模型的唯一标识符。
名称 string 未能创建的快照的名称。
SnapshotTime datetime 尝试创建快照的时间。
TotalCpu timespan 发生故障之前消耗的总 CPU 时间。
MemoryPeak long 发生故障前的峰值内存使用率(以字节为单位)。
持续时间 timespan 作失败之前的持续时间。
FailureReason string 详细的错误消息,说明快照创建失败的原因。
FailureKind string 发生的故障类别或类型。
详细信息 string 包含到故障点的详细分步统计信息的 JSON 对象。

例子

显示图形模型的所有失败快照

.show graph_snapshots MyGraphModel failures

输出

OperationId DatabaseName 模型名 ModelId 姓名 SnapshotTime TotalCpu MemoryPeak 持续时间 失败原因 FailureKind 详细信息
f47ac10b-58cc-4372-a567-0e02b2c3d479 MyDatabase MyGraphModel a1b2c3d4-e5f6-7890-abcd-ef1234567890 failed_snapshot1 2025-09-10T12:15:00.000Z 00:00:08.250 67108864 00:00:12.500 .make graph_snapshot“MyGraphModel”命令的“failed_snapshot1”在处理步骤 3 期间失败,并出现错误... 永久性 {“Steps”:\}
e58bd11c-69dd-5483-b678-1f13c3d4e580 MyDatabase MyGraphModel a1b2c3d4-e5f6-7890-abcd-ef1234567890 failed_snapshot2 2025-09-10T16:30:00.000Z 00:00:05.000 33554432 00:00:07.750 .make graph_snapshot“MyGraphModel”命令的“failed_snapshot2”在处理步骤 17 期间失败,并出现错误... Transient {“Steps”:\}
a9c8d7e6-1234-5678-9abc-def012345678 MyDatabase MyGraphModel a1b2c3d4-e5f6-7890-abcd-ef1234567890 failed_snapshot2 2025-09-10T16:30:00.000Z 00:00:03.125 25165824 00:00:05.250 .make graph_snapshot“MyGraphModel”命令中的“failed_snapshot2”在处理步骤 20 期间失败,并出现错误... 永久性 {“Steps”:\}

显示所有图形模型的失败

.show graph_snapshots * failures

此命令将返回数据库中所有图形模型的所有失败快照创建尝试,这对于系统范围的故障排除和故障模式分析非常有用。

分析失败详细信息

Details 列提供有关已完成和失败步骤的信息。 每个步骤可以有多个状态之一:

  • 已完成:已成功执行的步骤
  • 失败:该步骤遇到错误且无法完成
  • 已恢复:此步骤已在上一次作尝试中完成,且在未重新执行的情况下恢复

初始失败示例

{
  "Steps": [
    {
      "Kind": "AddEdges",
      "StepNumber": 0,
      "Status": "Completed",
      "Duration": "00:00:00.4027208",
      "StartTime": "2025-09-04T12:15:34.0846894Z",
      "AddedElementsCount": 2,
      "AddedElementsSizeDelta": 2688,
      "TotalCpu": "00:00:00.3906250",
      "MemoryPeak": 3789792
    },
    {
      "Kind": "AddNodes",
      "StepNumber": 1,
      "Status": "Failed",
      "Duration": "00:00:00.2027214",
      "StartTime": "2025-09-04T12:15:34.4882548Z",
      "TotalCpu": "00:00:00.2031250",
      "MemoryPeak": 0
    }
  ]
}

重试作示例

如果重试,将恢复之前作的完成步骤,不会再次执行。

重要

只有在以下的情况下才能恢复步骤:

  • 自上一次尝试以来,图形模型定义没有更改
  • is FailureKindTransient (指示如果重试失败可能会成功)

如果图形模型已修改或失败 Permanent,则必须从头重新执行所有步骤。

{
  "Steps": [
    {
      "Kind": "AddNodes",
      "StepNumber": 0,
      "Status": "Resumed",
      "Duration": "00:00:00.0003329",
      "StartTime": "2025-09-04T12:15:39.2846214Z",
      "TotalCpu": "00:00:00",
      "MemoryPeak": 0
    },
    {
      "Kind": "AddEdges",
      "StepNumber": 1,
      "Status": "Completed",
      "Duration": "00:00:00.4027208",
      "StartTime": "2025-09-04T12:15:34.0846894Z",
      "AddedElementsCount": 2,
      "AddedElementsSizeDelta": 2688,
      "TotalCpu": "00:00:00.3906250",
      "MemoryPeak": 3789792
    },
    {
      "Kind": "AddNodes",
      "StepNumber": 2,
      "Status": "Failed",
      "Duration": "00:00:00.2027214",
      "StartTime": "2025-09-04T12:15:34.4882548Z",
      "TotalCpu": "00:00:00.2031250",
      "MemoryPeak": 0
    }
  ]
}

请注意步骤 0 在最短持续时间和零资源消耗的情况下如何显示 Status: "Resumed" ,指示它已从以前的成功执行中还原,而不是重新执行。

排查故障

使用作标识符(ID)进行详细调查

每个失败的作都有一个唯 OperationId 一的,可用于获取有关失败的更多详细信息:

.show operations f47ac10b-58cc-4372-a567-0e02b2c3d479

此命令提供有关作执行的全面详细信息,包括详细的错误消息和执行时间线。

了解故障分类

FailureKind 指示失败的性质:

  • 永久:如果重试而不发生更改,则失败不太可能成功(例如缺少表、架构不匹配)
  • 暂时性:如果重试,则失败可能会成功(例如临时资源约束、网络问题)

FailureReason 提供作中失败步骤中的特定错误消息,帮助确定故障的确切原因。

注释

  • 结果中仅包含失败的快照创建尝试
  • 如果不存在故障,该命令将返回空结果集
  • 如果指定的图形模型不存在,该命令将失败