用途:查找缓存是 Celigo 托管的内存键值存储,用于集成处理中的快速查找、去重、交叉引用解析与状态跟踪,相比逐条查询外部系统的导出式查找,可实现亚毫秒级访问且不消耗 API 调用。
主要能力:缓存元数据(名称、集成范围、是否随模板/克隆携带数据);数据管理(通过专用数据端点加载、读取、更新、清除键值对);容量治理(单个缓存上限 50 MB,单环境所有缓存合计上限 1 GB)。缓存由导入/导出映射的 lookups[] 数组消费,条目通过 _lookupCacheId 引用缓存,可用 extract JSON 路径提取对象字段。
使用方式:最少需 name 字段;常用可选字段有 description、_integrationId、includeDataInTemplatesAndCloning。数据操作均以缓存 ID 为参数,键与值均为字符串,复杂对象需 JSON 序列化。常用 CLI 命令:celigo lookup-caches list、get <id>、create < cache.json、update <id> < cache.json、set <id> key=value、delete <id> [-y];数据操作如 echo '{"data":[{"key":"k","value":"v"}]}' | celigo lookup-caches put-data <id>、get-data <id>、delete-data <id>、purge-data <id>。在导入/导出资源上通过 lookups[] 引用,并在 Handlebars 中用 {{lookup 'lookupName' record.fieldName}} 调用。
适用场景:外部 ID 到内部 ID 的映射、去重/防抖、跨流程运行的状态跟踪、较稳定的参考数据表。
限制:缓存不会自动刷新,需手动、流程驱动或清空重载;get-data 每次最多返回 1000 个键;无自动 TTL;put 会抹除未提供字段,应先 GET 再改再 PUT;数据 upsert 用 POST 而非 PUT;缓存与沙箱/生产环境相互独立;删除为软删除,保留 30 天。若引用多匹配查找的首个结果写入更新,可能造成静默数据损坏,应配置多匹配时失败/跳过或在写入前校验结果数唯一。启用查找缓存功能需相应许可证。