数据选取

确定商品主表与标识

每条主表记录输出一条商品。请选择代表正式商品的唯一标识列，确认后作为字符串 id 输出。

关联使用数据库实际列。JSON 提取字段用于输出，当前不能用作连接键。

匹配关联字段

商品输出字段

此处汇总各表已确认采用的字段。修改请返回对应表重新编辑并确认；之后统一核对合并结果。

读取最多 5 条商品，预览与全量输出使用同一转换规则。样本通过不代表全量数据均有效。

点击刷新预览，可直接预览当前编辑。

按需输出

使用已确认的配置读取来源，D1 不保留商品正文或历史文件。

读取完成后在当前页面下载。单个商品失败会单独列出；连接中断不会产生完整下载。结果只保留在当前页面内存中。

点击“读取并下载 JSONL”获取当前数据。

按所选表轮询变更，重新生成受影响商品，提供可续读的新增、更新及删除事件。字段与 JSON 解析沿用已确认的设置。

这是查询轮询，时效取决于查询间隔及执行耗时。物理删除、迟到提交和未监测表由定期完整核对补查；无法捕获两次读取之间已经消失的中间状态。D1 状态表示已完成本地差异核对，不表示外部插件已接收；正文从来源按需读取。

数据接口

D1 只负责读取、整理和输出。Typesense 或其他消费方自行管理目标数据、索引和读取进度。

1. 全量调用 export，接收 begin、record、record_error、end 帧。只有 end.scan_complete 为 true 才表示扫描完成；存在失败商品时 complete 为 false，不得将缺失商品直接删除。
2. 消费方保存 begin 中的 feed_id 与 change_cursor。全量导入后，以该游标读取 changes，处理成功后保存 next_cursor。
3. 变更只含标识；对 upsert 和 delete 都按 ID 读取 products 的当前状态。仅 missing_ids 或 deleted_ids 表示当前应删除；errors 表示失败，保留消费方原数据并重试。
4. CURSOR_EXPIRED 表示配置变化或游标过期，重新全量读取。没有配置监测时，D1 只提供按需读取，不承诺持续通知。

接口只允许本机调用。完整读取采用一次只读快照，跨请求获取的是来源当前状态，不提供历史正文回放。没有保留上次成功结果；来源离线时请由消费方保留自己的已成功数据。