同步报表

什么是同步报表？

同步报表是指生成速度必须非常快的小报表。 在收到要生成同步报表的请求之后，DCM 报表平台会立即开始为您生成相应报表。如果您需要快速获取少量数据，例如在图形界面中显示指标，那么此类报告最适合用于。

同步生成报表和异步生成报表之间有何区别？

即使您请求少量数据，异步生成报表也始终需要至少几分钟时间。同步报表可以更快地返回此类数据，但报表的生成所需时间会因此缩短。当报表在同步超时时间段内无法运行，或者您没有在对时间敏感的环境（例如界面）中生成报告时，您应该使用异步报告生成功能。

同步报表超时期限是多久？

如果报告小到足以在 10 秒内生成，那么系统会将初始报告文件返回到初始运行请求。 否则，DCM 报表会在超时前 50 秒内生成您的报表。

如果同步报表所需时间过长，会出现什么情况？

如果同步报告的生成未在超时期内完成，则系统会停止生成同步报告，并将报告故障切换到异步报告队列。您的报告不会失败或返回错误，但进入异步报告队列意味着，您的报告现在至少需要几分钟才能生成。

除了报表生成时间之外，您不会获得关于您的报表超出了同步报表超时期限的指示。通知可能会在 50 秒内同步完成，也可能会变成异步请求并需要几分钟才能完成。

哪些报表类型支持同步执行？

除以下几种报表之外，其他所有报表类型都支持同步生成：

所有其他报告类型都支持同步执行，但如果使用的数据过多或指标和维度组合使用的资源密集型设置过多，则这些报告仍会超时。

如何运行同步报表？

默认情况下，所有报告均为异步生成。请求生成新的报告文件时，可以将可选的 synchronous 参数设置为 true，以请求同步生成报告。请参阅我们文档中的 示例代码。

我是否应通过同步执行请求所有报告？

否，只有在预计报表会在超时期限内完成时，才应请求同步执行。如果您的报告从同步生成时开始，并达到超时限制，则系统会将报告移至异步队列，即报告的总执行时间将是异步生成报告所需的时间加上同步超时期限。因此，如果您以异步方式请求报告，则应避免同步超时期限会出现额外的延迟。

我请求的指标和维度是否会影响报告的生成时间？

会。某些指标和维度的编译时间比其他指标和维度要长，其中一些指标甚至可能导致同步报告总是超时。地理位置维度就属于这类维度，很少会因为速度足够快而无法将其包含在同步报表中。

如何缩短生成报告所需的时间以允许同步生成报告？

有很多因素（例如报告中包含的广告系列的大小以及报告所涵盖的时间范围）会影响速度。通过手动调整，报表通常能够将报表压缩成足够小的分块，先从您想要快速显示的所有数据开始，然后再逐步缩小报表，直到成功完成同步。