# 管理工作流产物和数据血缘

查询产物、文件和处理节点之间的链路，查看输出块及其修订，并按需要切换修订或重新运行处理节点。本页不启动或恢复整个工作流作业；相关操作请参阅[运行、恢复和重试工作流作业](workflow-jobs-recovery.md)。

## 前提条件

准备可访问目标工作区的凭据，以及待追溯的产物、文件或处理节点标识。有关服务地址、认证和通用请求格式，请参阅[调用前准备](../../api-call-basics.md)。

创建修订、设置生效修订或重新运行节点前，先查询相应的链路、节点、输出块和修订记录，确认目标对象。

## 调用顺序

1. 从产物或文件开始查询处理链路，定位需要检查的处理节点。
2. 查询节点详情以及产物、节点的输出块和修订记录，确认需要查看或调整的输出。
3. 需要保留新版本时创建相应输出块修订；需要改变当前使用的修订时设置生效修订。
4. 需要重新处理时，按当前节点或指定修订重新运行节点，并再次查询链路和输出块确认结果。

## API 操作

### 查询链路和节点

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询产物处理链路 | [查看处理结果链路](../../../../reference/api/ai-studio/data-processing/workflow-lineage/get-artifact-lineage.md) | 从产物追溯处理过程时使用。 |
| 查询文件处理链路 | [查看文件处理链路](../../../../reference/api/ai-studio/data-processing/workflow-lineage/get-file-lineage.md) | 从文件追溯处理过程时使用。 |
| 查询产物处理节点详情 | [查看处理节点详情](../../../../reference/api/ai-studio/data-processing/workflow-lineage/get-lineage-node.md) | 已定位节点后查看其详情时使用。 |

### 查看和修订输出块

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询产物输出块 | [查看处理结果输出内容列表](../../../../reference/api/ai-studio/data-processing/workflow-lineage/list-artifact-output-blocks.md) | 查看产物关联的输出块时使用。 |
| 查询节点输出块 | [查看节点输出内容列表](../../../../reference/api/ai-studio/data-processing/workflow-lineage/list-artifact-node-output-blocks.md) | 查看指定节点的输出块时使用。 |
| 查询输出块修订记录 | [查看处理结果输出版本列表](../../../../reference/api/ai-studio/data-processing/workflow-lineage/list-artifact-block-revisions.md) | 查看输出块已有修订时使用。 |
| 查询节点输出块修订 | [查看节点输出版本列表](../../../../reference/api/ai-studio/data-processing/workflow-lineage/list-artifact-node-block-revisions.md) | 查看节点输出块修订时使用。 |
| 创建输出块修订 | [创建处理结果输出版本](../../../../reference/api/ai-studio/data-processing/workflow-lineage/create-artifact-block-revision.md) | 需要为输出块新增修订时使用。 |
| 创建节点输出块修订 | [创建节点输出版本](../../../../reference/api/ai-studio/data-processing/workflow-lineage/create-artifact-node-block-revision.md) | 需要为节点输出块新增修订时使用。 |
| 设置生效修订 | [设为处理结果生效版本](../../../../reference/api/ai-studio/data-processing/workflow-lineage/switch-artifact-effective-revisions.md) | 需要切换产物使用的修订时使用。 |
| 设置节点生效修订 | [设为节点生效版本](../../../../reference/api/ai-studio/data-processing/workflow-lineage/switch-artifact-node-effective-revisions.md) | 需要切换节点使用的修订时使用。 |

### 重新运行节点

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 重新运行处理节点 | [重新运行处理节点](../../../../reference/api/ai-studio/data-processing/workflow-lineage/rerun-artifact-node.md) | 需要按当前配置重新处理节点时使用。 |
| 使用指定修订重新运行节点 | [使用指定输出版本重新运行处理节点](../../../../reference/api/ai-studio/data-processing/workflow-lineage/rerun-artifact-node-with-revisions.md) | 需要用选定修订重新处理节点时使用。 |

## 结果确认

创建或切换修订后，查询相应的输出块和修订记录确认当前内容；重新运行节点后，重新查询[查看处理结果链路](../../../../reference/api/ai-studio/data-processing/workflow-lineage/get-artifact-lineage.md)或[查看处理节点详情](../../../../reference/api/ai-studio/data-processing/workflow-lineage/get-lineage-node.md)确认处理节点信息。

## 限制和注意事项

- 修订、节点和产物是不同层级的对象；执行切换或重新运行前，先通过链路和节点详情确认目标层级。
- 设置生效修订和重新运行会影响后续使用的输出；先在对应动作页确认适用条件和范围。

## 下一步

- [运行、恢复和重试工作流作业](workflow-jobs-recovery.md)