解决 ER 配置中的性能问题

项目
03/08/2023

本文说明如何查找和解决电子报告 (ER) 配置中的性能问题。

通常，性能调查包括几个步骤。

收集数据。
分析收集的数据。
根据分析结果，使用 ER 配置进行更改，或决定收集更多数据。

疑难解答

分析执行时间

执行时间可能取决于不可预测的因素，例如在同一环境中运行的其他任务以及首次调用时使用数据的缓存。因此，您应该多次重复执行和度量。

有时，性能问题不是由用于申报的 ER 格式配置引起的。相反，它们是由用于打开该 ER 格式配置的 X++ 代码引起的。

在操作中心或事件日志中，查看报表的执行时间。
将报表的执行时间与场景中的总执行时间进行比较。
如果报表的执行时间远远小于总执行时间，则考虑报表处理的数据量：
- 如果报表处理少量数据，则问题可能涉及配置的加载时间。
- 如果报表处理大量数据，则问题可能涉及预处理 X++。使用跟踪分析程序分析此案例。
对于其他案例，请参阅后续部分。
运行涉及不同数据量的多个测试，以确定执行时间如何取决于数据量。

分析跟踪分析程序跟踪

准备一个小例子，或者在报表生成的随机部分中收集几个跟踪。

然后，在跟踪分析程序中，进行标准的自下而上分析，并回答以下问题：

在时间消耗方面，排名靠前的方法是什么？
这些方法使用了总时间的哪一部分？

回答相同的查询问题。

如果您看到方法以“ER”为前缀，请转到下一部分。

如果您看到方法或查询源自应用程序套件，请考虑通用优化（例如，创建索引）。

分析调用次数。如果数量明显高于预期，请考虑缓存配置的相应节点。

分析数据库调用

准备一个包含少量数据的示例，以便您可以收集 ER 跟踪。

然后在 ER 模型映射设计器中打开跟踪，并查看页面底部。回答以下问题：

是否有任何查询重复？如果有，请考虑以下修复之一：
- 使用缓存，如果您认为在一个父记录中有多个调用。
- 使用缓存的参数化计算字段，如果您认为在不同的记录中有对同一记录的调用。
- 使用 JOIN 数据源，如果您必须从数据库中读取大量不同的记录。
查询数和提取的记录数是否与数据总量相对应？例如，如果单据具有 10 行，统计数据显示报表提取 10 行还是 1,000 行？如果您有大量提取的记录，请考虑以下修复之一：
- 使用 FILTER 函数而不是 WHERE 函数在 Microsoft SQL Server 端处理数据。
- 使用缓存避免提取相同的数据。
- 使用收集的数据函数避免提取相同的数据进行汇总。

分析 PerfView 跟踪

PerfView 是面向经验丰富的开发人员的工具。有关以下步骤的更多详细信息，请参阅时钟时间调查基本知识。

使用线程时间收集跟踪。
仅包括使用 runUnattended 的堆栈，以仅筛选具有配置执行的线程。（将 runUnattended 添加到 IncPats 输入框。）
折叠所有 CPU、网络和阻止时间。
加载 PerfView 的 ER 预设。
选择 ER>其他预设。
查看名称：
- 您可能会看到消耗时间最多的平台代码。
- 您可以两次点击（或双击）并浏览到被调用者。
  
  如果找到前缀为“ERExpression”的类，并且如果这些函数与公式相关，您可以根据类名称猜测函数名称，并且可以查看 ER 存储库以查看属性。

修复

如果您看到查询消耗了大部分 CPU 时间，请尝试减少查询次数：
- 对于重复查询，查看 ER 跟踪。
- 查看提取了多少记录，并评估理论上应该提取多少数据。
如果您看到使用的函数消耗了大部分 CPU 时间，请尝试查找配置中消耗了大部分资源的位置。
如果您看到数据收集函数消耗了大部分 CPU 时间，请考虑在模型映射端将其替换为 SQL 分组依据。

收集数据

根据您的环境，可通过多种方法收集可用数据：

获取总运行时间：
- 通过操作中心
- 通过事件日志
分析执行：
- 通过使用 ER 工具
- 通过使用跟踪分析程序
- 通过使用 PerfView

在生产环境中收集数据

有时，问题只能在生产环境中重现。可以通过以下方式收集数据：

通过使用跟踪分析程序跟踪
通过使用 ER 执行跟踪
通过使用总执行时间

在开发环境中收集数据

除了可以在生产环境中使用的工具外，还有几种可以在开发环境中使用的工具：

事件日志 (Microsoft-Dynamics-ElectronicReporting)。此日志可以为您提供总执行时间。
常见的 .NET 工具，例如 PerfView。

此外，开发环境为您提供了更大的试验灵活性。例如，您可以关闭部分报表以查看执行时间如何受到影响。

工具

操作中心中的执行时间

ER 可以在操作中心中显示配置的执行时间。此选项仅适用于特定用户和特定公司，并且仅适用于交互式会话。若要使此功能可用，请按照下列步骤操作。

转到组织管理>电子申报>配置。
在配置页操作窗格中配置选项卡的高级设置组中，选择用户参数。
在用户参数对话框中，将显示文件生成时间选项设置为是。

事件日志中的执行时间

打开 Windows 事件查看器。
在应用程序和服务日志下，打开 Microsoft-Dynamics-ElectronicReporting/Operational。
查找其中 EventID=2 的 FormatMapingRun 事件，因为这些事件包含有关经过时间的信息。

跟踪分析程序跟踪

因为 ER 在 X++ 中实现，因此您可以使用常见的 X++ 工具分析性能。有关详细信息，请参阅使用跟踪分析程序进行跟踪。

此方法有一些限制。因为部分 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 模型映射中需要的应用程序表的那些字段值。将不会提取该表中的其他字段。因此，缓存提取的记录所需的内存量将减少。有关详细信息，请参阅通过减少运行时获取的表字段的数量来提高 ER 解决方案的性能。

使用缓存的参数化计算字段

有时，必须反复查找值。示例包括帐户名称和帐号。为了帮助节省时间，您可以创建一个在顶层具有参数的计算字段，然后将该字段添加到缓存中。

我们建议您仅在缓存的数据大小较小时使用此方法。有关详细信息，请参阅通过添加参数化的计算字段数据源提高 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) 还提供一种从调用代码发送预计算的数据的方法。应用程序套件包含此方法的许多示例。

通过