跳至主要内容
Administrator Guide
上次更新时间 :2026-04-03
问题排查:通过 API 的自定义报告

问题排查:通过 API 的自定义报告

应用程序编程接口 (API)调用超时。

如果应用程序编程接口 (API)调用未在 60 秒内得到处理,则调用将超时,您将收到一个错误“”。
原因
解决方案
各个数据集之间的联接过多。
限制跨数据集使用的联接数量。
您正在检索一个包含超过 20 个字段的报告。
请将报告中的字段数量限制为最多 10 到 20 个。如果字段计数超过 20,请使用 SFTP 检索报告。
您有一个不规则的数据形状。示例:您有大量嵌套的组织。
避免检索异常大的数据集。
您有一个不带筛选器的报告
使用适当的筛选器来控制数据大小的增长。示例:检索使用定义了较小时间段“” (例如
“昨天”
“今天”)
的筛选器修改的数据。
您在发起请求,申请后的 分钟内发起了请求,申请,上一次请求出现了 。对于返回大量数据或具有多个联接的报告尤其如此。
避免在短时间内发出多个应用程序编程接口 (API)请求,申请。
您正在检索具有多页数据的报告。
报告 API 专门用于返回分页数据集。这是一项标准限制,适用于所有基于 VNDLY HTTP 的 API。为避免出现此问题,请执行以下操作:
  • 使用 Limit(要返回的行数)和抵销 (起始行数)检索单页数据。
  • 限制报告中包含的字段数量。
  • 使用 SFTP 代替报告应用程序编程接口 (API) ,无需分页即可检索大型报告。

从上线租户检索数据时,您会遇到性能问题,但从测试租户不会。

性能问题在测试租户中可能不太明显,因为测试租户中的数据加载量小于上线租户中的数据加载量。
解决方案:
  • 请在上线后验证报告性能,以验证结果是否与测试租户中的类似。
  • 使用可代表性生产负载规模的测试数据加载“测试”租户。
  • 为上线环境中的扩展制定计划。将包含上线数据的报告的预期加载大小和复杂性考虑在内。在方案成熟或上线后,在接近阈值时执行的报告很可能会超过该阈值。