用途:优化 BambooHR 数据同步吞吐,在保证完整性与隐私的前提下,从可测量的请求图出发进行调优。首要目标通常是消除按员工逐个请求的扇出,而非在未知租户限制下盲目提高并发。
主要能力:使用 dataset v2 返回选定字段,支持 links 与 meta 分页,审查过的 OpenAPI 允许 pageSize 最大 1000,请求使用 filter、orderBy、page、pageSize。dataset v1 数据检索与自定义报表路径已带弃用提示,不应作为新优化基础。
使用方式:先建立基线,记录 p50/p95 延迟、按操作的请求数、页数、接收记录与字节、重试、错误率、CPU/内存、目标端耗时与端到端新鲜度。绘制请求图,用 dataset v2 投影替换 N+1 员工读取。最小化字段,添加确定性 orderBy,并根据负载、内存、延迟与 413 行为把 pageSize 调到文档上限以下。流式或分页处理数据,仅在目标端持久化后提交检查点,默认不把全部员工加载进内存。对数据集/字段定义等稳定元数据使用有界 TTL 缓存,不缓存令牌或无限制员工负载。加入按租户并发控制并复用安全 HTTP 连接,仅在可测量金丝雀中提高并行度并观察 429 与尾延迟。前后比较精确记录标识与对账计数,若新鲜度、完整性、权限或内存回退则回滚。
限制:需在获批测试租户或脱敏负载中,以与生产相同的认证模式和有效字段权限进行基准测试,并记录凭据别名与权限集。查询生产、更改字段选择或缓存保留、提高并发、替换源端点均需审批。性能不得成为静默省略非活跃或未来日期记录的理由。错误处理:更快但不完整则拒绝变更并恢复最后检查点;413 则降低页大小/字段数并重新测量;429 或尾延迟上升则降低并发并打开熔断;模式漂移则隔离该页而非跳过字段或记录。该技能不授权生产基准测试或 HR 数据导出。