用途:调整已连接数据表(ExternalDataSchema)的同步配置,例如切换 sync_type、更换 incremental_field、设置 primary_key_columns、修改同步频率,或把表切到/切离 CDC、webhook。若是在搭建全新数据源,应改用 setting-up-a-data-warehouse-source。
主要能力与工具:external-data-schemas-retrieve 查看当前 sync_type、incremental_field、主键、频率;incremental-fields-create 重新从源读取候选增量字段与可用同步类型;external-data-schemas-partial-update 应用改动;reload 立即触发同步;resync 清空并重新导入;delete-data 删除已同步表但保留 schema;check-cdc-prerequisites-create 做 Postgres CDC 预检;webhook 相关工具用于注册、轮换签名密钥和注销 webhook。
必要用法:先 retrieve 读取当前配置与状态(不要在 Running 时改动);改 sync_type 或 incremental_field 前先用 incremental-fields-create 确认目标字段存在且对应类型可用,返回中会含 incremental_available、append_available、cdc_available、full_refresh_available、detected_primary_keys 等。再用 partial-update 只提交要变的字段,例如 {"sync_frequency": "1hour"} 或 {"sync_type": "incremental", "incremental_field": "updated_at", "incremental_field_type": "datetime"}。非破坏性改动可 reload 立即生效,最后 retrieve 确认状态。
适用场景:诊断指出增量字段或主键有误、同步过频或过疏、incremental 与 CDC 互切、源表结构漂移导致同步失败、修改 CDC 主键、切换 full_refresh 与 append、把 schema 切到或切离 webhook、轮换 webhook 签名密钥、暂停 schema。
限制与风险:切换增量字段、改主键、full_refresh 与 append 互切、切到或切离 CDC 可能使已有数据失效,需要 resync 或 delete-data 后再 reload,这些操作会清空数据,须先告知用户。CDC 切换前必须通过 check-cdc-prerequisites-create(仅 Postgres)。切到 webhook 仅适用于实现 WebhookSource 的源(目前 Stripe)且表 supports_webhooks: true,建议保留 sync_frequency 作为兜底。webhook 注册在源级别,多个 webhook schema 共享,仅在最后一个切换走时才注销。不要在同步运行中修改配置。