同步报表

什么是同步报表?

同步报表是指生成速度必须非常快的小报表。 在收到要生成同步报表的请求之后,DCM 报表平台会立即开始为您生成相应报表。您最好在急需少量数据时使用此类报表 - 例如,当您在图形界面中显示指标时。

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

异步生成报表通常至少需要几分钟,即使您请求的是少量数据也如此。同步报表可以更加快速地返回此类数据,但系统生成报表的超时期限会缩短。您应该在出现以下情况时异步生成报表:无法在同步超时期限内生成报表;或者您未处于一个对时间比较敏感的环境(例如界面)。

什么是同步报表超时期限?

如果报表小到足以在 10 秒之内生成,则系统会根据您的初始生成请求返回一个完整的报表文件。否则,DCM 的报表生成操作会在 50 秒后超时。

如果同步报表所花费的时间过长,会出现什么情况?

如果没有在超时期限内生成同步报表,系统会中断该过程并会将该报表转移到异步报表生成队列中。如果您的报表生成操作没有失败或返回错误,但进入了异步报表队列,则意味着您的报表至少需要几分钟时间才能生成。

如果您的报表生成操作超出了同步报表超时期限(而非报表生成时间),则不会收到任何指示。报表可能会在 50 秒之内同步生成,也可能会进入异步队列并需要几分钟才能生成。

哪种报表支持同步生成?

除以下几种报表之外,其他所有报表类型均支持同步生成:

其他报表类型都支持同步生成。不过,如果您使用的数据过多或指标和维度组合的处理需要耗用大量资源的话,这些报表仍会出现超时。

如何生成同步报表?

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

我是否应该请求同步生成我的所有报表?

不应该。只有当您预计报表可在超时期限内生成完毕时,才应该请求同步生成。如果您的报表开始是同步生成并且达到了超时限制,那么该报表将会进入异步队列,而且报表的总生成时间将是异步生成报表所需的时间加上同步超时期限。因此,如果您异步请求报表,则可以避免同步超时期限这一额外延迟。

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

是的,会有所影响。有些指标和维度相较于其他指标和维度需要更多时间进行编制,其中部分指标和维度还会导致同步报表总是出现超时。地理维度就属于此类维度。这类维度一般不会快到足以包含在同步报表中,即使有这种情况,也非常罕见。

我可以如何缩短报表生成时间以允许同步生成报表?

有很多因素会对速度造成影响,例如所含广告系列的规模和报表覆盖的时间范围。要想让系统更快速地生成报表,最好的方法就是通过稍做手动调整使报表的块头变得足够小 - 先确定您希望能够快速显示的所有内容,然后尝试削减相应报表,直到它能够成功地同步完成为止。