【Cypher】POINT 索引（Point Index）：用于地理空间数据（Spatial Data）的索引类型

本文链接：https://blog.youkuaiyun.com/u013172930/article/details/146877471

Cypher 中的 POINT 索引（Point Index）详解

一、什么是 POINT 索引？

POINT 索引（Point Index） 是 Neo4j 提供的一种专门用于地理空间数据（Spatial Data） 的索引类型，可有效处理点坐标、地理位置和空间计算。

POINT 索引使用 R-Tree 数据结构来存储和查询地理空间数据。
POINT 索引支持的空间数据包括：
- 二维坐标（Cartesian）：point({x, y})
- 三维坐标（Cartesian 3D）：point({x, y, z})
- 地理坐标（WGS 84）：point({latitude, longitude})

二、POINT 索引的特点

2.1 支持的数据类型

Cartesian 坐标系：
- 二维点：point({x, y})
- 三维点：point({x, y, z})
WGS 84 坐标系（地理坐标）：
- point({latitude, longitude})
- point({latitude, longitude, height})

2.2 支持的查询操作

精确匹配： =
范围查询： <, >, <=, >=
距离计算： distance()

2.3 适用场景

地理空间查询，例如附近的地点、计算距离、范围筛选等场景。
处理地图数据、位置数据、路径规划等场景。

三、创建 POINT 索引

3.1 基本语法

CREATE POINT INDEX FOR (n:Label) ON (n.property)

n:Label：指定标签 Label 的节点。
n.property：指定需要创建 POINT 索引的属性。

3.2 创建二维 Cartesian 坐标的 POINT 索引

CREATE POINT INDEX FOR (n:Location) ON (n.coordinates)

创建 Location 节点的 coordinates 属性上的 POINT 索引。
coordinates 存储的是 Cartesian 坐标（例如：point({x: 12.5, y: 45.8})）。

3.3 创建 WGS 84 地理坐标的 POINT 索引

CREATE POINT INDEX FOR (n:City) ON (n.location)

创建 City 节点 location 属性的 POINT 索引，使用 WGS 84 坐标系。
location 存储的是地理坐标（例如：point({latitude: 40.7128, longitude: -74.0060})）。

3.4 为关系属性创建 POINT 索引

CREATE POINT INDEX FOR ()-[r:LOCATED_AT]-() ON (r.position)

创建 LOCATED_AT 关系的 position 属性的 POINT 索引。

四、查看和管理 POINT 索引

4.1 查看当前数据库中的所有索引

SHOW INDEXES

返回当前数据库中所有的索引，包括 BTREE、TEXT、POINT 和 FULLTEXT 等索引。

4.2 查看特定 POINT 索引的信息

SHOW INDEXES YIELD name, type, labelsOrTypes, properties

YIELD 关键字筛选返回指定索引的详细信息。
POINT 索引的 type 字段会显示为 POINT。

4.3 删除 POINT 索引

DROP INDEX myPointIndex

删除 myPointIndex 索引。

DROP INDEX FOR (n:Location) ON (n.coordinates)

删除 Location 标签的 coordinates 属性上的 POINT 索引。

五、使用 POINT 索引进行查询

5.1 使用精确匹配进行查询

MATCH (n:Location)
WHERE n.coordinates = point({x: 12.5, y: 45.8})
RETURN n

使用 POINT 索引对 coordinates 进行精确匹配，返回匹配的 Location 节点。

5.2 查询特定地理位置

MATCH (c:City)
WHERE c.location = point({latitude: 40.7128, longitude: -74.0060})
RETURN c

使用 POINT 索引匹配 City 节点的 location 属性，查找指定经纬度的城市。

5.3 使用 `distance()` 计算距离

MATCH (a:Location), (b:Location)
WHERE distance(a.coordinates, b.coordinates) < 1000
RETURN a, b

distance() 计算两点之间的距离，并筛选出距离小于 1000 的 Location 节点。

5.4 查询距离某个点一定范围内的节点

MATCH (n:Location)
WHERE distance(n.coordinates, point({x: 12.5, y: 45.8})) < 500
RETURN n

查询 Location 节点中距离 point({x: 12.5, y: 45.8}) 小于 500 米的节点。

5.5 使用 `WHERE` 进行范围查询

MATCH (n:Location)
WHERE n.coordinates.x > 10 AND n.coordinates.y < 50
RETURN n

使用 POINT 索引进行范围查询。

5.6 查询距离某个位置最近的节点

MATCH (n:Location)
WITH n, distance(n.coordinates, point({x: 12.5, y: 45.8})) AS dist
ORDER BY dist ASC
RETURN n LIMIT 1

通过 distance() 计算距离，使用 ORDER BY 排序，返回距离最近的 Location 节点。

六、POINT 索引的优化建议

6.1 为经常使用的地理位置属性创建 POINT 索引

如果经常对某个属性进行地理位置匹配或距离计算，应创建 POINT 索引，提高查询性能。

6.2 使用 `distance()` 和 `WITH` 进行距离计算优化

计算距离时，先使用 WITH 语句计算距离，然后过滤结果。

MATCH (n:Location)
WITH n, distance(n.coordinates, point({x: 12.5, y: 45.8})) AS dist
WHERE dist < 1000
RETURN n, dist

6.3 使用 `EXPLAIN` 和 `PROFILE` 查看查询计划

EXPLAIN MATCH (n:Location) WHERE distance(n.coordinates, point({x: 12.5, y: 45.8})) < 500 RETURN n

EXPLAIN 显示查询计划，确认是否使用了 POINT 索引。

PROFILE MATCH (n:Location) WHERE distance(n.coordinates, point({x: 12.5, y: 45.8})) < 500 RETURN n

PROFILE 执行查询并返回详细信息，包括查询过程中使用的索引。

6.4 避免 `OR` 逻辑触发索引失效

MATCH (n:Location)
WHERE n.coordinates.x > 10 OR n.coordinates.y < 50
RETURN n

OR 查询通常无法触发索引，应避免在空间查询中使用 OR 逻辑。

七、POINT 索引的使用案例

7.1 查询特定位置的节点

MATCH (n:City)
WHERE n.location = point({latitude: 40.7128, longitude: -74.0060})
RETURN n

查找 City 节点中位于纽约市的节点。

7.2 查询距离某点 500 米以内的节点

MATCH (n:Location)
WHERE distance(n.coordinates, point({x: 12.5, y: 45.8})) < 500
RETURN n

返回距离指定坐标 500 米以内的 Location 节点。

7.3 查询最近的地点

MATCH (n:Location)
WITH n, distance(n.coordinates, point({x: 12.5, y: 45.8})) AS dist
ORDER BY dist ASC
RETURN n LIMIT 1

查找距离某点最近的 Location 节点。

7.4 按距离排序查询地点

MATCH (n:Location)
WITH n, distance(n.coordinates, point({x: 12.5, y: 45.8})) AS dist
RETURN n, dist
ORDER BY dist ASC
LIMIT 10

返回距离指定点最近的前 10 个 Location 节点。

八、删除 POINT 索引

8.1 删除单个 POINT 索引

DROP INDEX FOR (n:Location) ON (n.coordinates)

删除 Location 节点的 coordinates 属性上的 POINT 索引。

8.2 删除所有 POINT 索引

SHOW INDEXES YIELD name
CALL {
  WITH name
  DROP INDEX name
}

删除数据库中所有 POINT 索引。

九、常见错误与注意事项

9.1 索引未生效

MATCH (n:Location)
WHERE n.coordinates = point({x: 12.5, y: 45.8})
RETURN n

问题：索引未生效。
解决：使用 EXPLAIN 或 PROFILE 查看查询计划，确认是否使用了 POINT 索引。

9.2 删除不存在的索引

DROP INDEX FOR (n:Location) ON (n.coordinates)

错误：索引不存在时删除会报错，应先使用 SHOW INDEXES 查看现有索引。

9.3 避免使用不支持的比较操作

MATCH (n:Location)
WHERE n.coordinates CONTAINS point({x: 12.5, y: 45.8})
RETURN n

POINT 索引不支持 CONTAINS 操作，应使用 = 进行匹配。

十、总结

POINT 索引 主要用于处理地理空间数据，适用于位置匹配、距离计算和范围查询。
通过 CREATE POINT INDEX 可以创建 POINT 索引，提升地理数据查询性能。
distance() 函数可用于计算两个点之间的距离，并结合 WITH 和 ORDER BY 进行距离排序查询。
EXPLAIN 和 PROFILE 可以帮助确认查询是否使用了 POINT 索引。
POINT 索引不支持 OR 查询逻辑，应避免在空间查询中使用 OR。

掌握 POINT 索引的使用方法，可以帮助你在 Neo4j 中优化空间数据的查询性能，提高地理数据分析的效率。