MySQL ST_NumPoints 与 ST_NumGeometries 怎样区分线段点数和几何成员数

MySQL 的 ST_NumPoints 用来统计 LineString 中的点，ST_NumGeometries 用来统计几何集合中的成员。一个集合里即使放着含有很多坐标点的折线，这条折线在外层也只是一个几何成员。迁移空间统计 SQL 时，先确定统计层级，再选函数。

官方文档：https://dev.mysql.com/doc/refman/8.4/en/gis-property-functions.html

先明确统计的是哪个层级

例如旧报表把某条路线的字段叫作 count，后来导入的数据变成了集合，开发者可能把两个计数函数当成同义写法替换。问题通常出在字段含义没有说清：要数折线的坐标位置，还是数容器里有几个几何对象？本文以 MySQL 8.4 文档范围解释，不把这种 SQL 调整描述成某次版本新增行为。

用一条折线和一个集合分别计数

以下 SQL 使用 SRID 0 的演示几何，不涉及真实经纬度数据和坐标轴顺序。它们只创建会话变量，便于观察两个统计对象。

-- 折线包含四个坐标位置，统计的是线内点数。
SET @route = ST_GeomFromText(
    'LINESTRING(0 0, 2 1, 4 1, 6 3)'
);
SELECT ST_GeometryType(@route) AS geometry_type,
       ST_NumPoints(@route) AS line_vertex_count;

-- 外层集合放入一个点和一条折线，成员数不是坐标点总数。
SET @bundle = ST_GeomFromText(
    'GEOMETRYCOLLECTION(POINT(9 9),LINESTRING(0 0,2 1,4 1,6 3))'
);
SELECT ST_NumGeometries(@bundle) AS geometry_member_count;

按这份示例数据，折线的点数应为4，外层集合的成员数应为2。这里给出的是数据结构对应的预期，未将其包装成实际数据库执行记录。两种结果不矛盾，也不应该为了让结果相等而修改函数。

此外，四个按顺序连接的点通常描述三段相邻线段，点数也不是线段数量。标题中的“线段点数”在 SQL 对象层面应理解为 LineString 的点记录数量。

需要线内点数时先取出目标成员

若已知集合的第二个成员是目标折线，可以先用 ST_GeometryN 取出成员，再查询其点数。成员编号从1开始，不是0。

-- 本示例已知第二个成员是折线；实际数据应先确认成员类型。
SET @member = ST_GeometryN(@bundle, 2);
SELECT ST_GeometryType(@member) AS member_type,
       ST_NumPoints(@member) AS line_vertex_count;

通用导入任务不能假设每个集合的第二项都是折线。若业务需要把所有线成员的点数加总，应遍历相关成员、判断类型，并定义嵌套集合是否继续展开。ST_NumGeometries 本身不是“递归数遍所有坐标”的快捷入口。

不要用字符串逗号数量来代替空间类型函数。集合嵌套、多个几何对象以及其他类型的表示方式都会让文本计数偏离业务含义。

迁移统计字段时分开命名

把原先含糊的 point_count 或 count 拆成具有明确含义的字段，例如 line_vertex_count 与 geometry_member_count，并保留 geometry_type。前者明确限定折线点数，后者明确限定集合成员数；读报表的人不必再从数值猜测来源。

迁移时先保留旧值，再用代表性样本解释新字段差异。若两条 SQL 的结果不同，应优先核对统计对象，而不是把差异全部归因于数据库升级。空间函数是否支持某种输入类型，应查看对应版本的参数说明，不能把其他数据库的同名函数行为直接搬过来。

区分空值、空几何与无效输入

集合属性函数文档说明，NULL 或空几何输入可能返回 NULL；不符合空间数据语法的输入、未定义的空间参考系统则可能触发错误。NULL 不能不加区分地当作零个成员写进报表，否则会掩盖缺失或异常数据。

能用 ST_NumPoints 统计任意几何的全部点吗？不要这样设计，它针对 LineString 的点数需求。集合中的一条折线算几个成员？在该层级算一个成员，其内部点数另行统计。点数能表示路线长度吗？不能，采样密度不同会改变点数，长度应使用适合对象和坐标系的长度计算。

集合属性参考：https://dev.mysql.com/doc/refman/8.4/en/gis-geometrycollection-property-functions.html