使用 “版本 ”下拉列表切换服务。 了解有关导航的详细信息。
适用于:✅ 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 提供作中失败步骤中的特定错误消息,帮助确定故障的确切原因。
注释
- 结果中仅包含失败的快照创建尝试
- 如果不存在故障,该命令将返回空结果集
- 如果指定的图形模型不存在,该命令将失败