SuperAPI AI 工具集

sync-guide

数据与分析

查看项目

更新于 10-16 00:04

技能介绍

用途:这是一份构建 Notion Workers sync 的综合指南。sync 是一个循环执行的 execute 函数,返回数据变更以填充 Notion 数据库;每次调用返回 { changes, hasMore, nextState },hasMore 为 true 时继续执行,直至 false 完成一个 cycle,下个 cycle 按调度间隔从上次状态开始。

主要能力:给出架构决策框架。小数据源(<1k 记录)或 API 无变更追踪时,用单一 replace 模式同步,末次 hasMore:false 后未见记录会被自动删除;其余情况用 backfill+delta 双同步共用一个数据库,backfill 用 replace、schedule:"manual",delta 用 incremental、高频调度。delta 需在 backfill 之前初始化游标,重叠写入时加 upstreamUpdatedAt 防旧数据覆盖。还涵盖分页策略(opaque cursor、page/offset、keyset、时间戳游标、事件流)、一致性缓冲(游标滞后 10-60 秒,示例 bufferMs = 15_000)、删除策略(replace 自动删除;有删除 API 则发 { type: "delete", key },或用 flip-flop 切换主流与删除流)、Schema 与 Builder 类型对照(title、richText、number、date、select、multiSelect、relation、people、place 等),以及常见错误(未用 pacer、缺缓冲、不分页、游标不前进导致死循环、忽略首次 state 为 undefined 等)。

用法:文中给出 CLI 命令,如 ntn workers deploy、ntn workers sync trigger <key>(可加 --preview)触发、ntn workers sync status 查看状态、ntn workers runs list 查看日志、ntn workers sync state reset <key> 重置状态、ntn workers env set KEY=value 管理密钥。

限制:文档本身未提供计费、价格、平台支持范围等信息;具体 API 分页细节需参考随附的 api-pagination-patterns.md。