參照︰exportData 效能

若要從 exportData 效能和可擴充性最佳化中受益，您的要求必須使用特定的 API 版本、屬性內容和元素。

效能改善會影響獨立的 exportData API 呼叫，以及以下呼叫 exportData 的功能︰

發布計畫

從設計整合的 Adaptive Planning 資料來源擷取科目資料。

請參閱「」 exportData。

API v38 包含新的要求和回應格式，具體取決於

stream="true"

或

stream="false"

在

call

元素

支援的科目

exportData 效能和可擴充性改善支援︰

所有科目分類， 但下列科目除外
︰

系統科目 (包括分配、少數股權百分比、銷除、累計換算調整)。

模型工作表假設科目

所有建模功能， 但以下除外
︰

加權平均換算

文字彙總

攤分查詢

值查詢

使用 API 的應用程式

發布計畫

從設計整合的 Adaptive Planning 資料來源擷取科目資料。

包含 exportData API 效能最佳化，具有時間級別的 Cube 資料除外。

不包含串流的較大匯出列限制。

exportData 效能與行為

exportData API 的行為會因下列配置而有所不同︰

API v36

要求包含不支援的科目分類或屬性	stream 屬性內容	回覆格式	匯出列數限制	效能最佳化
否	無法使用	不變	500K	是
是	無法使用	不變	500K	否

API v38

要求包含不支援的科目分類或屬性	stream 屬性內容	回覆格式	匯出列數限制	效能最佳化
否	休假或 false	非串流	500K	是
否	true	串流	200 萬	是

API v39

要求包含不支援的科目分類或屬性	stream 屬性內容	回覆格式	匯出列數限制	效能最佳化
否	休假或 false	非串流	500K	是
否	true	串流	200 萬	是
是	true	非串流	500K	否
是	false	非串流	500K	否

exportData API v36 及更高版本的更新

下表列出了在 2024R1 中針對 exportData API v36 及更高版本引入的效能最佳化路徑的增強功能，做為 exportData API 效能最佳化功能的一部分。

exportData API	未最佳化的行為	最佳化的行為
使用者無權存取 DAC 規則中某個維度的所有科目、層級組合，且該維度未包含在 exportData API 要求中。	回應不會傳回 Cube 工作表或模型工作表中科目的資料，這些科目︰包含維度。有針對使用者有權存取的維度值和未分類維度值的資料。	回應會傳回具有維度未分類值的列。
維度包含在以下兩個位置的 API 要求︰ <dimensions> 區塊 (例如，通過 <dimension> 或 <dimensionIds> 元素)。做為以下項目的值 directChildrenofDimension 的屬性 <dimensionValue> 中的元素 <dimensionValues> 區塊。	回應不會傳回維度的直接子系或維度的任何列。	回應會傳回直接子系的匯總值列，以及維度未分類值的列。
針對在以下兩個位置指定維度的 Cube 科目提出 API 要求︰ <dimensions> 區塊 (例如，通過 <dimension> 或 <dimensionIds> 元素)。做為以下項目的值 dimName 的屬性 <dimensionValue> 元素，該元素的值為空 name 屬性內容，位於 <dimensionValues> 區塊。	回應不會傳回維度的直接子系或維度的任何列。	回應會傳回維度匯總或直接子系匯總的列，以及依據為 directChildren 和 uncategorized 內的屬性內容 <dimensionValue> 元素
API 要求時間 directChildren 在不包含層級維度的 Cube 工作表中，科目的層級維度值	回應不會傳回計入層級維度值的直接子系匯總值的層級的列。	回應會傳回計入層級維度值直接子系匯總值的層級列。