|| apoc.convert.fromJsonMap - APOC 核心文档 - Neo4j 文档

apoc.convert.fromJsonMap

详情
语法	`apoc.convert.fromJsonMap(map [, path, pathOptions ])`
描述	将给定的 JSON map 转换为 Cypher `MAP`。
参数	名称	类型	描述
	`map`	`STRING`	一个 JSON 字符串化的 map。
	`path`	`STRING`	用于从 map 中提取特定部分的 JSON 路径表达式。默认值为：``。
	`pathOptions`	`LIST<STRING>`	JSON 路径选项：('ALWAYS_RETURN_LIST', 'AS_PATH_LIST', 'DEFAULT_PATH_LEAF_TO_NULL', 'REQUIRE_PROPERTIES', 'SUPPRESS_EXCEPTIONS') 默认值为：`null`。
返回	`MAP`

使用示例

以下将 JSON map 转换为 Cypher map

RETURN apoc.convert.fromJsonMap('{"name": "Graph Data Science Library"}') AS output;

结果
输出
{name: "Graph Data Science Library"}

我们还可以使用 JSON 路径表达式来提取 JSON map 的一部分。例如，以下从 JSON map 中提取 product 属性并返回一个 map

RETURN apoc.convert.fromJsonMap('{"product": {"name": "Bloom"}}', '$.product') AS output;

结果
输出
{name: "Bloom"}

如果尝试转换非 map 结构，将得到一个异常。例如

RETURN apoc.convert.fromJsonMap('[{"name": "Neo4j"}]') AS output;

结果
调用函数 `apoc.convert.fromJsonMap` 失败：原因：com.fasterxml.jackson.databind.exc.MismatchedInputException: 无法从 START_ARRAY token 反序列化 `java.util.LinkedHashMap<java.lang.Object,java.lang.Object>` 实例，位置在 [Source: (String)"[{"name": "Neo4j"}]"; line: 1, column: 1]

在这种情况下，我们应该使用 apoc.convert.fromJsonList。

此外，我们可以自定义 JSON 路径选项，将字符串列表作为第三个参数 (pathOptions) 添加，其中字符串基于 Enum<Option>。默认值为 ["SUPPRESS_EXCEPTIONS", "DEFAULT_PATH_LEAF_TO_NULL"]。请注意，我们也可以插入 []，即“无选项”。因此我们可以执行 (使用默认 pathOptions)

RETURN apoc.convert.fromJsonMap('{ "columns": {
      "col2": {
        "_id": "772col2"
      }
    }
}', '$.columns.col2') AS output;

结果
输出
{ "_id": "772col2" }

或者，使用自定义路径选项

RETURN apoc.convert.fromJsonMap('{ "columns": {
      "col2": {
        "_id": "772col2"
      }
    }
}', '$.columns.col2', ['ALWAYS_RETURN_LIST']) AS output;

结果
调用函数 `apoc.convert.getJsonPropertyMap` 失败：原因：com.fasterxml.jackson.databind.exc.MismatchedInputException: 无法从 START_ARRAY token 反序列化 `java.util.LinkedHashMap<java.lang.Object,java.lang.Object>` 实例，位置在 [Source: UNKNOWN; line: -1, column: -1]