参考信息:exportData Performance
要从 exportData 性能和可扩展性优化中受益,您的请求必须使用特定的 API 版本、属性和元素。
性能方面的改进会影响独立的 exportData API 调用以及调用 exportData 的以下功能:
- 发布计划。
- 在设计集成中从 Adaptive Planning 数据源中检索账户数据。
API v38 包含新的请求和响应格式,具体取决于是否存在
stream="true"
或 stream="false"
在 call
元素。支持的账户
exportData 性能和可扩展性方面的改进支持:
所有账户类型,
但以下类型除外
:
- 系统账户(包括分配、少数股东权益百分比、抵销、累计折算调整)。
- 模型工作表假设账户
所有建模功能,但以下功能
除外
:
- 加权平均折算
- 文本汇总
- 分摊查询。
- 值查询
使用方应用程序
- 发布计划。
- 在设计集成中从 Adaptive Planning 数据源中检索账户数据。
- 包括 exportData API 性能优化(具有时间层级的多维数据除外)。
- 不包括流式传输的较大导出行限制。
exportData 的性能和行为
exportData API 的行为因以下配置而异:
API v36
请求包含不受支持的账户类型或属性 | stream 属性 | 回复格式 | 导出行限制 | 性能优化 |
|---|---|---|---|---|
否 | 不可用 | 无变更 | 50 万 | 是 |
是 | 不可用 | 无变更 | 50 万 | 否 |
API v38
请求包含不受支持的账户类型或属性 | stream 属性 | 回复格式 | 导出行限制 | 性能优化 |
|---|---|---|---|---|
否 | 休假或 false | 非流式传输 | 50 万 | 是 |
否 | true | 流式传输 | 200 万 | 是 |
API v39
请求包含不受支持的账户类型或属性 | stream 属性 | 回复格式 | 导出行限制 | 性能优化 |
|---|---|---|---|---|
否 | 休假或 false | 非流式传输 | 50 万 | 是 |
否 | true | 流式传输 | 200 万 | 是 |
是 | true | 非流式传输 | 50 万 | 否 |
是 | false | 非流式传输 | 50 万 | 否 |
exportData API v36 及更高版本的更新
下表列出了在 2024R1 中为 exportData API v36 及更高版本引入的性能优化路径的增强功能,这些增强功能是 exportData API 性能优化功能的一部分。
exportData API | 非优化行为 | 优化的显示方式 |
|---|---|---|
用户无权访问 DAC 规则中某个维度的所有账户、层级组合,并且该维度未包含在 exportData API 请求中。 | 响应不会为以下多维工作表或模型化工作表中的账户返回数据:
| 回复会返回包含未分类维度值的行。 |
API 请求的以下两个位置均包含维度:
| 响应不会为维度的直接子级或维度返回任何行。 | 响应将返回包含直接子级汇总值的行,以及包含维度的未分类值的行。 |
对多维账户发出 API 请求,并在以下两个位置指定了维度:
| 响应不会为维度的直接子级或维度返回任何行。 | 响应将返回维度汇总或直接子级汇总的行,以及基于为 directChildren 以及 uncategorized 中的属性 <dimensionValue> 元素。 |
API 请求日期 directChildren 为不包含层级维度的多维工作表中的账户添加层级维度值。 | 回复不会返回计入层级维度值直接子级汇总值的层级行。 | 响应会返回层级中计入层级维度值的直接子级汇总值的行。 |