文档首页
MySQL 8.4 参考手册
相关文档 下载本手册
PDF (US Ltr) - 39.9Mb
PDF (A4) - 40.0Mb
手册页 (TGZ) - 258.5Kb
手册页 (Zip) - 365.5Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 8.4 参考手册  /  ...  /  几何集合属性函数

14.16.7.5 几何集合属性函数

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

除非另有说明,本节中的函数处理其几何参数的方式如下

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

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

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

  • 否则,返回值为非 NULL

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

  • ST_GeometryN(gc, N)

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

    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)

    返回 GeometryCollectiongc 中的几何数量。

    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 |
    +----------------------------------------+