Documentation Home
MySQL 8.0 参考手册
MySQL 8.0 参考手册  / 第 12 章函数和运算符  / 12.17空间分析函数  / 12.17.7 几何属性函数  /  12.17.7.5 GeometryCollection 属性函数

12.17.7.5 GeometryCollection 属性函数

这些函数返回 GeometryCollection值的属性。

除非另有说明，本节中的函数按如下方式处理它们的几何参数：

  • 如果任何参数是NULL或任何几何参数是空几何，则返回值为 NULL。

  • 如果任何几何参数不是语法上格式正确的几何， ER_GIS_INVALID_DATA则会发生错误。

  • 如果任何几何参数是未定义空间参考系统 (SRS) 中语法上格式正确的几何， ER_SRS_NOT_FOUND则会发生错误。

  • 否则，返回值为非NULL。

这些函数可用于获取几何集合属性：

  • ST_GeometryN(gc, N)

    返回值 中的N第 - 个几何 。几何图形从 1 开始编号。 GeometryCollectiongc

    ST_GeometryN()如本节介绍中所述处理其参数。 

    mysql> SET @gc = 'GeometryCollection(Point(1 1),LineString(2 2, 3 3))';
mysql> SELECT ST_AsText(ST_GeometryN(ST_GeomFromText(@gc),1));
+-------------------------------------------------+
| ST_AsText(ST_GeometryN(ST_GeomFromText(@gc),1)) |
+-------------------------------------------------+
| POINT(1 1)                                      |
+-------------------------------------------------+

  • ST_NumGeometries(gc)

    GeometryCollection返回value 中的几何数量 gc。

    ST_NumGeometries()如本节介绍中所述处理其参数。 

    mysql> SET @gc = 'GeometryCollection(Point(1 1),LineString(2 2, 3 3))';
mysql> SELECT ST_NumGeometries(ST_GeomFromText(@gc));
+----------------------------------------+
| ST_NumGeometries(ST_GeomFromText(@gc)) |
+----------------------------------------+
|                                      2 |
+----------------------------------------+