SuperAPI AI 工具集

tuning-incremental-sync-config

数据与分析

查看项目

更新于 10-16 03:45

技能介绍

用途:调整已连接数据表的同步方式,例如切换 sync_type、更换 incremental_field、设置 primary_key_columns、修改 sync_frequency,或暂停某个 schema。若用户是新建数据源,应改用 setting-up-a-data-warehouse-source。

主要能力:通过 external-data-schemas-retrieve 读取当前 sync_type、incremental_field、主键与频率;用 external-data-schemas-incremental-fields-create 刷新候选增量字段并确认可用的同步类型;用 external-data-schemas-partial-update 应用变更;用 external-data-schemas-reload 立即触发同步;必要时用 external-data-schemas-resync 或 delete-data 清空重导。涉及 CDC 时需先运行 external-data-sources-check-cdc-prerequisites-create;涉及 webhook 时用 webhook-info-retrieve、create-webhook-create、update-webhook-inputs-create、delete-webhook-create 管理注册与密钥。

使用方式:先读取当前配置,确认状态不是 Running;若改 sync_type 或 incremental_field,先刷新候选字段;只提交要变更的字段做部分更新;判断变更是否会使已有数据失效,必要时重同步;最后 reload 并确认状态与 last_synced_at。

限制:并非所有 schema 都支持全部 sync_type;CDC 仅适用于 Postgres 且需通过前置检查;webhook 目前仅支持实现 WebhookSource 的源(如 Stripe);切换 sync_type、更换增量字段或主键通常需要重同步,属破坏性操作,需先告知用户;不要在同步运行中修改配置。