SuperAPI AI 工具集

diagnosing-failed-warehouse-syncs

数据与分析

查看项目

更新于 10-16 03:45

技能介绍

用途:当数据仓库的某个数据源或表同步失败、卡住或产出坏数据时,按“数据源→表结构→恢复动作”自上而下定位根因,并推荐合适的恢复操作,而不是一上来就全量重同步。

主要能力:可列出数据源及其连接状态与最新错误、查看单个数据源及其全部表结构、列出所有表结构及每表状态与 latest_error、取消运行中的同步、按配置方式重载、全量重同步、删除已同步表但保留表结构配置、修改 sync_type/incremental_field/cdc_table_mode、更新数据源凭据、刷新表清单、检查 Postgres CDC 前置条件、刷新候选增量字段,以及查询、创建、更新、删除 Webhook。

使用方式:先定位失败项,区分数据源级(连接本身损坏,影响所有表)与表结构级失败;再根据状态(Running、Completed、Failed、Paused、计费限制)并结合 last_synced_at 判断是否卡死;随后把 latest_error 映射到根因,如凭据过期、SSH 隧道问题、缺少主键、主键不唯一、字段漂移、表被删除、网络不可达、CDC 前置条件损坏、计费限制等;最后按根因选择恢复动作,如重载、更新凭据、刷新增量字段、刷新表清单、取消后重载、重同步、删除数据、检查 CDC 前置条件或处理 Webhook。

适用场景:用户报告某个同步变红、表长时间处于 Running、数据陈旧或缺失、最新行未出现、在 cancel/reload/resync/delete-data 之间难以抉择,或由审计技能移交的失败项。

限制:resync、delete-data、删除数据源均为破坏性且不可撤销,执行前必须获得明确批准;计费限制属于计费问题而非技术故障;Webhook 故障可能被 Completed 状态掩盖;失败也可能来自目标端而非数据源。资料未提供具体价格、平台支持范围与效果数据。