使用 Spanner Graph 可视化图表

本页介绍了如何使用 Spanner 图可视化结果。Spanner Graph 可视化图表可以显示查询返回的图元素或图架构的元素。可视化图表有助于您了解数据点（节点）之间的关联方式（边）。虽然包含数百个数据点的表格可能难以解读，但其图表可视化结果可以揭示模式、依赖项和异常。

直观呈现 Spanner Graph 查询结果

如需在 Spanner Studio 中直观呈现 Spanner 图查询结果，查询必须使用 SAFE_TO_JSON 或 TO_JSON 函数以 JSON 格式返回图元素。此外，我们建议返回图形路径，而不是单独返回节点和边。返回路径的好处包括：

  • 路径包含节点和边的完整数据。如果您返回单个节点和边，复杂查询的可视化图表中可能无法显示某些中间节点和边。

  • 与单独返回节点和边相比，如果返回路径，RETURN 语句会更简单。

以下示例查询会返回可直观呈现的账号转移路径：

GRAPH FinGraph
MATCH result_paths = (account:Account {is_blocked: True})-[:Transfers]->(dest_account:Account)
RETURN SAFE_TO_JSON(result_paths) AS result_paths

运行查询后，可视化结果会显示在查询结果区域中。详细信息面板会显示节点和边标签的摘要，以及每个标签的计数。点击某个节点或边缘可浏览图表并查看属性、邻居和连接，如以下屏幕截图所示。或者，您也可以以表格的形式查看查询结果，或切换到底层图表架构的可视化结果。

查询结果切换按钮。

如需了解详情，请参阅以 JSON 格式返回图表元素。

选择 Spanner 图表可视化布局

可视化面板中的菜单提供了以下布局选项：

  • 力图布局（默认）：将节点显示为彼此排斥的点，而连接的节点会相互吸引，模拟磁力等物理力，以创建直观的视觉布局
  • 分层：根据连接情况放置节点，以生成视觉层次结构
  • 顺序：根据连接性来定位节点，以生成视觉序列
  • 显示标签：无论缩放级别如何，都会在图表上显示所有节点和边标签

排查可视化图表问题

以下内容可帮助您排查和了解 Spanner 图可视化问题和行为。

Spanner Graph 查询不显示可视化图表

问题：您运行 Spanner 图查询，但该查询仅以表格格式显示。

可能的原因：查询未以 JSON 格式返回图表元素。例如：

  • 以下查询无法可视化，因为它会返回节点和边标识符：
GRAPH FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN person.id as person_id, account.id as account_id
  • 以下查询无法可视化，因为它会返回房源值：
GRAPH FinGraph
MATCH (person:Person {name: "Dana"})-[owns:Owns]->(account:Account)
RETURN owns.create_time, account.nick_name

推荐的解决方案：

使用 SAFE_TO_JSON 或 TO_JSON 以 JSON 格式返回图表元素。如需了解详情，请参阅可视化 Spanner 图查询结果。

部分查询结果可直观呈现

问题：查询结果可视化结果仅显示部分查询结果。

可能的原因：查询返回的数据量超过 10 MB。查询可视化图表最多可显示 10 MB 的数据。

推荐解决方案：简化查询，使其返回的数据量不超过 10 MB。

节点或边显示了意外的标签

问题：图表可视化中的节点或边显示意外标签。

可能的原因：节点或边具有多个标签。Spanner 图可视化显示每个节点和边缘各一个标签。如果节点或边有多个标签，则可视化图表中会显示第一个标签。

推荐的解决方案：无。您无法更改显示的标签。

可视化图表中不显示某些图表元素

问题：可视化图表包含所有返回的节点和边，但缺少一些图表元素。

可能的原因：用于创建可视化图表的查询会返回单个节点和边，而不是图表路径。

建议的解决方案：更新查询以返回图表路径。

后续步骤