迁移准备报告

迁移准备报告仅适用于 Neo4j 版本 4 上的实例。

您可以通过实例和控制台页面上“推荐迁移”标签的链接,访问任何版本 4 实例的报告。

概述

此工具建议如何准备 AuraDB v4 实例以迁移到 AuraDB v5。它报告当前的应用程序查询、驱动程序和数据库对象,这些对象会阻止您迁移到 AuraDB v5,方法是根据您最近的使用历史记录提供信息。此外,您还可以查看在 Aura 中升级到 Neo4j 5,了解每个已识别问题的详细信息以及如何解决这些问题。

迁移准备报告处理的主要问题类别是

  • Cypher 弃用

  • 弃用的驱动程序使用

  • 弃用的索引类型

报告页面为每个类别都设有一个部分,顶部有一个名为“弃用和查询时间线”的图表。本文档解释了每个部分,但第一个部分对于控制其他部分至关重要,将在下一节中详细介绍。请注意,该报告仅突出显示需要解决的问题,以使您的代码和查询与 AuraDB v5 兼容。解决这些问题为学习版本 5 中新功能的优势提供了良好的机会。=== 控制时间窗口

mrr deprecation query timeline

在“弃用和查询时间线”部分,您将看到一个图表,显示弃用 Cypher 功能和结构的使用情况,以及该系统上查询负载的一般度量(查询速率)。您可以通过单击图例来禁用和启用数据系列。如果您想暂时专注于特定内容,这将非常有用。时间范围可以通过两种方式控制

  • 通过单击图表区域(开始时间)并按住鼠标按钮向下拖动,直到您想要选择结束时间,从而放大。然后,图表将放大到所需时间范围。

  • 使用图表右上角的时间选择器。图表将根据所需时间范围更新。最大时间范围为 7 天的历史记录。

要返回到之前选择的时间范围,请双击图表区域。请注意,虽然图表可以显示最多 7 天,但 Cypher 弃用和弃用驱动程序使用情况的详细信息最多可以检索 24 小时的历史记录。

Cypher 弃用

mrr fetch logs

选择最多 24 小时的时间范围后,使用该按钮以获取此部分的弃用日志。在以下弹出窗口中设置过滤器是可选的,但如果您只想查看特定条目,则会很有用。您可以过滤以下内容:

  • 弃用的名称

  • 执行查询的用户

  • 用于执行查询的驱动程序

  • 执行查询的应用程序名称(如果已设置)

  • 查询的启动类型

  • 查询文本或其部分

使用弹出窗口中的该按钮以获取适用的数据来填充报告的表格。

mrr deprecation table

表格中的每一行都表示在选择的时间范围内必须更改的查询,以无缝迁移到最新的 Aura 版本。您必须重写这些查询,以仅使用 v5 支持的 Cypher。

同一查询的所有执行都汇总到一行(另请参阅“计数”列)。使用每一行开头的放大镜可访问包含有关该查询的更多信息的弹出窗口,以及有关处理每个问题的建议。它还提供了指向每个弃用文档的相关链接。

mrr resolution guide

Cypher 弃用表格中的最后一列链接到 Aura 查询日志分析器工具中该特定查询的视图,该工具可以提供有关选定查询每个执行的信息。该工具可以查看所有数据库上的查询,除了system数据库。

mrr show query log button

弃用的驱动程序使用

mrr fetch driver stats

选择最多 24 小时的时间范围后,使用该按钮以获取此部分的驱动程序统计信息。默认情况下,弹出窗口中的过滤器设置为仅显示在任何数据库(包括系统数据库)中可能存在问题的驱动程序使用情况。您可以随意更改这些设置,例如查看所有驱动程序使用情况。

使用弹出窗口中的该按钮以获取适用的数据来填充报告的表格。根据访问 Neo4j 数据库的客户端类型,“最新版本”列中提供了链接以帮助您进行升级。

mrr driver table

与 Cypher 弃用表格类似,最后一列链接到 Aura 查询日志工具中该特定驱动程序执行查询的视图。该工具可以提供有关使用选定驱动程序的每个查询执行的信息。该工具可以查看所有数据库上的查询,除了system数据库。

弃用的索引类型

本节提供有关如何处理在版本 4 中可能使用但在迁移到版本 5 之前或期间需要处理的弃用索引的信息。

这部分涉及手动在您的数据库上运行提供的 Cypher 查询以识别弃用索引,然后决定如何最好地处理它们。将来将提供此功能的进一步改进。

下一步

在实施报告中所有推荐的修复程序后,您现在可以测试迁移。使用页面底部的“测试迁移”按钮,然后按照文档中概述的步骤操作。