📣
TiDB Cloud Premium 开放公测中。为企业级工作负载提供无限扩展、即时弹性伸缩和高级安全保障。此页面由 AI 自动翻译,英文原文请见此处。

REFRESH LINEAGE



为 default catalog 中的现有视图回填或协调 lineage。在已包含视图的部署上启用 data lineage 后,请使用此命令。启用 lineage 后新创建的视图会被自动跟踪。

此命令需要全局 SUPER 权限,并且必须已启用 lineage。参见数据 lineage。

语法

REFRESH LINEAGE FOR ALL VIEWS [ DRY RUN ]

DRY RUN 会计算并报告变更,但不会将其写入。建议先运行它,以查看执行 refresh 时将进行的操作。

输出列

列描述
object_domain对象域;当前为 VIEW。
catalog包含该视图的 catalog;当前为 default。
database包含该视图的数据库。
object_name视图名称。
statusDRY_RUN、REFRESHED 或 ERROR。
edge_count在当前视图定义中找到的 lineage 边数量。
upsert_count需要新增或修改的缺失或已变更边数量。
delete_count需要删除的过期边数量。
error当 status 为 ERROR 时的错误详情;否则为 NULL。

对于成功且无变更的视图,结果中不会显示。

示例

预览现有视图所需的变更:

REFRESH LINEAGE FOR ALL VIEWS DRY RUN;

应用这些变更:

REFRESH LINEAGE FOR ALL VIEWS;

命令完成后,可使用 GET_LINEAGE 查询某个视图的上游 lineage:

SELECT distance, source_object_database, source_object_name, target_object_database, target_object_name FROM GET_LINEAGE( 'lineage_demo.sales_view', 'VIEW', 'UPSTREAM', 1 );

文档内容是否有帮助?