ER 設定中的效能問題故障排除

發行項
07/27/2022

本主題說明如何在電子報表 (ER) 設定中尋找和解決效能問題。

通常，效能調查包括幾個步驟。

收集資料。
分析收集的資料。
根據分析結果，使用 ER 設定做出改變，或決定收集更多資料。

疑難排解

分析執行時間

執行時間可能取決於不可預測的因素，例如在同一環境中執行的其他工作以及第一次調用時使用資料的快取。因此，您應該多次重複執行和測量。

有時，效能問題不是由用於報表的 ER 格式設定引起的。相反，它們是由用於打開該 ER 格式設定的 X++ 代碼引起的。

在動作中心或事件記錄檔中，查看報表的執行時間。
將報表的執行時間與場景中的總執行時間進行比較。
如果報表的執行時間遠小於總執行時間，請考慮報表處理的資料量：
- 如果報表處理少量資料，則問題可能涉及設定的載入時間。
- 如果報表處理大量資料，則問題可能涉及預處理 X++。採用Trace Parser來分析這個案例。
對於其他情況，請參閱下一節。
執行涉及不同資料量的多個測試，以確定執行時間如何取決於資料量。

分析 Trace Parser 追蹤

準備一個小範例，或者在報表產生的隨機部分收集幾個追蹤。

那麼，在Trace Parser，做一個標準的自下而上的分析，並回答以下問題：

就時間消耗而言，最重要的方法是什麼？
這些方法使用了總時間的哪一部分？

對查詢回答相同的問題。

如果您看到方法以「ER」為前綴，請轉到下一節。

如果您發現方法或查詢源自應用程式套件，請考慮進行通用最佳化 (例如，建立索引)。

分析調用次數。如果數量明顯高於預期，請考慮快取設定的相應節點。

分析資料庫調用

準備一個具有少量資料的範例，以便您可以收集 ER 追蹤。

然後在 ER 模型對應設計工具中打開追蹤，並查看頁面底部。回答下列問題：

是否有任何重複查詢？如果有，請考慮以下修復之一：
- 如果您認為一個父記錄中有多個調用，請使用快取。
- 如果您認為不同記錄中存在對同一記錄的調用，請使用快取的參數化計算欄位。
- 如果您必須從資料庫中讀取大量不同的記錄，請使用 JOIN 資料來源。
查詢和提取記錄的數量是否與資料總量相對應？例如，如果一個文件有 10 行，那麼統計資料是否顯示報表提取了 10 行或 1,000 行？如果您有大量提取的記錄，請考慮以下修復之一：
- 使用 FILTER 函數而不是 WHERE 函數來處理 SQL Server 端的資料。
- 使用快取來避免獲取相同的資料。
- 使用收集的資料函數以避免獲取相同的資料進行匯總。

分析 PerfView 追蹤

PerfView是資深開發人員的工具。如需以下步驟的相關詳情，請參閱掛鐘時間調查基礎。

使用線程時間收集追蹤。
僅包括使用 runUnattended 的堆疊，以僅篩選具有設定執行的線程。 (將 runUnattended 新增到 IncPats 輸入方塊。)
摺疊所有 CPU、網路和封鎖時間。
載入PerfView 的 ER 預設。
選取 ER>其他預設。
查看名稱：
- 您可能會看到消耗時間最多的平台代碼。
- 您可以點兩下 (或按兩下點選) 並向上瀏覽 被調用者。
  
  如果您找到前綴為「ERExpression」的類，並且它們是與公式相關的函數，您可以根據類名猜測函數名，您可以查看 ER repo 來查看屬性。

修復

如果您看到大部分 CPU 時間都被查詢所消耗，請嘗試減少查詢次數：
- 為重複的查詢查看 ER 追蹤。
- 查看獲取了多少記錄，並評估理論上應該獲取多少資料。
如果您看到大部分 CPU 時間都被所使用的函數所消耗，請嘗試在設定中找到消耗資源最多的位置。
如果您發現大部分 CPU 時間都被資料收集函數佔用，請考慮在模型對應方面將它們替換為 SQL 分組依據。

收集資料

根據您的環境，有幾種方法可以收集可用資料：

獲取總執行階段間：
- 從動作中心
- 從事件記錄檔
分析執行：
- 透過使用 ER 工具
- 透過使用 Trace Parser
- 透過使用 PerfView

在生產環境中收集資料

有時，只有在生產環境中才能重現問題。可以透過以下方式收集資料：

透過使用Trace Parser追蹤
透過使用ER 執行追蹤
透過使用總執行時間

在開發環境中收集資料

除了可以在生產環境中使用的工具之外，還有一些工具可以在開發環境中使用：

事件記錄檔 (Microsoft-Dynamics-ElectronicReporting)。該記錄可以為您提供總執行時間。
通用 .NET 工具，例如 PerfView。

此外，開發環境為您提供了更大的實驗靈活性。例如，您可以關閉部分報表以查看執行時間如何受到影響。

工具

動作中心的執行時間

ER 可以在動作中心顯示設定的執行時間。此選項僅適用於特定使用者和特定公司，並且僅適用於互動式工作階段。若要提供此功能，請按照以下步驟動作。

進入 組織管理>電子報表>設定。
在設定頁面上，在動作窗格上，在設定索引標籤上，在 進階設定 組中，選取 使用者參數。
在 使用者參數 對話方塊中，將 顯示檔案產生時間 選項設定為是。

事件記錄檔中的執行時間

開啟視窗事件檢視器。
在 應用程式和服務記錄 下面，開啟 Microsoft-Dynamics-ElectronicReporting/Operational。
查詢 FormatMapingRun 事件，其中 EventID=2，因為這些事件包含有關經過時間的資訊。

Trace Parser 追蹤

因為 ER 是在 X++ 中實作，所以您可以使用常用的 X++ 工具來分析效能。如需相關資訊，請參閱使用 Trace Parser 進行追蹤。

這種方法有一些限制。由於部分 ER 是用 C# 實作的，因此並非所有細節都可用。但是，您可以查看資料使用詳情。此外，長時間執行的報表可能會超出追蹤儲存空間限制。

ER 追蹤

ER 可以收集自己的追蹤，並為這些追蹤提供視覺效果和分析工具。如需相關資訊，請參閱跟踪 ER 格式的執行以解決效能問題。

PerfView

因為 X++ 和 ER 都是在 .NET 平台之上實作，所以您可以使用常用的 .NET 工具。例如，您可以使用免費的PerfView工具。

您還可以從命令列收集資料。例如，以下 Windows PowerShell 指令碼收集執行時間，直到電腦上停止任何格式執行。

c:\programs\PerfView collect "e:\traces\$(date -format "ddMMyyyy_hhmm").etl" `
    -CircularMB:20000 -ThreadTime `
    -NoNGenRundown `
    -StopOnEtwEvent:Microsoft-Dynamics-ElectronicReporting/FormatMappingRun/Stop

這種方法有一些限制。您必須具有對電腦的管理存取權限。此外，您必須是經驗豐富的開發人員，因為學習曲線陡峭。

做出改變

使用快取

儘管快取減少了再次獲取資料所需的時間，但它會消耗記憶體。在獲取的資料量不是很大的情況下使用快取。如需相關資訊和說明如何使用快取的範例，請參閱根據來自執行追蹤的資訊改進模型對應。

使用快取的參數化導出欄位

有時，必須反複查詢值。範例包括帳戶名稱和帳號。為了幫助節省時間，您可以建立一個在頂層具有參數的導出欄位，然後將該欄位新增到快取中。

我們建議您僅在快取資料較小的情況下使用此方法。如需相關資訊，請參閱透過新增參數化的導出欄位資料來源來提高 ER 解決方案的效能。

使用 JOIN 資料來源

JOIN 資料來源使一個查詢可以獲取多個連線的記錄。不必使用單獨的查詢來獲取每個連線的記錄。例如，如果您有 1,000 行，並且您按關係獲取每行的項目資料，那麼您將有 1,001 個查詢 (= 1,000 + 1)。如果您使用 JOIN 資料來源，您將只使用一個查詢來獲取相同的資料。如需相關資訊，請參閱在 ER 模型對應中使用 JOIN 資料來源從多個應用程式表中獲取資料。

使用 FILTER 函數而不是 WHERE 函數

FILTER 函數在 SQL Server 上執行條件，而 WHERE 函數從清單中獲取所有資料，一次一條記錄，並為每條記錄套用條件。例如，您想從 1,000 條記錄中選取一條記錄。如果您使用 WHERE，將獲取所有 1,000 條記錄。但是，如果您使用 FILTER，只會獲取一條記錄。 FILTER 也可以在資料庫端使用索引。

使用收集的資料函數或累積的資料資料來源

如果您的設定有一個 分組依據 組件，該組件按報表匯總先前獲取的資料，則該組件將再次獲取所有資料。透過使用收集的資料函數，您可以使 ER 在第一次擷取期間累積資料。如需相關資訊，請參閱ER 設定格式以進行計數和求和。

在 X++ 中重寫部分設定

ER 支援調用資料表和分類的方法，包括擴充功能。考慮在 X++ 中重寫部分模型對應以幫助提高效能。

ER 可以使用來自以下來源的資料：

分類 (物件和分類資料來源)
資料表 (資料表 和 資料表記錄 資料來源)

ER API還提供了一種從調用代碼發送預先計算的資料的方法。應用程式套件包含許多這種方法的範例。

共用方式為