Documentation Home
MySQL 8.4 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 39.8Mb
PDF (A4) - 39.9Mb
Man Pages (TGZ) - 257.9Kb
Man Pages (Zip) - 364.9Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 8.4 Reference Manual  /  ...  /  GeometryCollection Property Functions

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

    返回 GeometryCollection 值<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 |
    +----------------------------------------+