MySQL :: MySQL 8.3 Reference Manual :: 14.16.12 Spatial Aggregate Functions

version 8.3

8.0 current

8.0 Japanese

MySQL 8.3 Reference Manual / ... / Spatial Aggregate Functions

14.16.12 空间聚合函数

MySQL 支持聚合函数，它们对一组值执行计算。有关这些函数的常规信息，请参阅第 14.19.1 节，“聚合函数描述”。本节描述 ST_Collect() 空间聚合函数。

ST_Collect() 可以用作窗口函数，如语法描述中的 [over_clause] 所示，表示可选的 OVER 子句。over_clause 在第 14.20.2 节，“窗口函数概念和语法” 中有描述，也包括其他窗口函数使用信息。

ST_Collect([DISTINCT] g) [over_clause]

聚合几何值并返回单个几何集合值。使用 DISTINCT 选项，返回distinct 几何参数的聚合。

与其他聚合函数一样，GROUP BY 可以用于将参数分组为子集。ST_Collect() 对每个子集返回聚合值。

如果存在 over_clause，则该函数作为窗口函数执行。over_clause 在第 14.20.2 节，“窗口函数概念和语法” 中有描述。与大多数支持窗口的聚合函数不同的是，ST_Collect() 允许使用 over_clause 与 DISTINCT 一起。

ST_Collect() 按照以下方式处理其参数：

NULL 参数被忽略。
如果所有参数都是 NULL 或聚合结果为空，则返回值为 NULL。
如果任何几何参数不是语法正确的几何体，则出现 ER_GIS_INVALID_DATA 错误。
如果任何几何参数是未定义的空间参考系统（SRS）中的语法正确的几何体，则出现 ER_SRS_NOT_FOUND 错误。
如果有多个几何参数且这些参数在同一个 SRS 中，则返回值在该 SRS 中。如果这些参数不在同一个 SRS 中，则出现 ER_GIS_DIFFERENT_SRIDS_AGGREGATION 错误。
结果是可能的最窄的 MultiXxx 或 GeometryCollection 值，结果类型根据非 NULL 几何参数确定如下：
- 如果所有参数都是 Point 值，则结果是一个 MultiPoint 值。
- 如果所有参数都是 LineString 值，则结果是一个 MultiLineString 值。
- 如果所有参数都是 Polygon 值，则结果是一个 MultiPolygon 值。
- 否则，参数是几何类型的混合，结果是一个 GeometryCollection 值。

以下示例数据集显示了按年份和制造地点的产品：

CREATE TABLE product (
  year INTEGER,
  product VARCHAR(256),
  location Geometry
);

INSERT INTO product
(year,  product,     location) VALUES
(2000, "Calculator", ST_GeomFromText('point(60 -24)',4326)),
(2000, "Computer"  , ST_GeomFromText('point(28 -77)',4326)),
(2000, "Abacus"    , ST_GeomFromText('point(28 -77)',4326)),
(2000, "TV"        , ST_GeomFromText('point(38  60)',4326)),
(2001, "Calculator", ST_GeomFromText('point(60 -24)',4326)),
(2001, "Computer"  , ST_GeomFromText('point(28 -77)',4326));

以下是一些使用 ST_Collect() 在数据集上的示例查询：

mysql> SELECT ST_AsText(ST_Collect(location)) AS result
       FROM product;
+------------------------------------------------------------------+
| result                                                           |
+------------------------------------------------------------------+
| MULTIPOINT((60 -24),(28 -77),(28 -77),(38 60),(60 -24),(28 -77)) |
+------------------------------------------------------------------+

mysql> SELECT ST_AsText(ST_Collect(DISTINCT location)) AS result
       FROM product;
+---------------------------------------+
| result                                |
+---------------------------------------+
| MULTIPOINT((60 -24),(28 -77),(38 60)) |
+---------------------------------------+

mysql> SELECT year, ST_AsText(ST_Collect(location)) AS result
       FROM product GROUP BY year;
+------+------------------------------------------------+
| year | result                                         |
+------+------------------------------------------------+
| 2000 | MULTIPOINT((60 -24),(28 -77),(28 -77),(38 60)) |
| 2001 | MULTIPOINT((60 -24),(28 -77))                  |
+------+------------------------------------------------+

mysql> SELECT year, ST_AsText(ST_Collect(DISTINCT location)) AS result
       FROM product GROUP BY year;
+------+---------------------------------------+
| year | result                                |
+------+---------------------------------------+
| 2000 | MULTIPOINT((60 -24),(28 -77),(38 60)) |
| 2001 | MULTIPOINT((60 -24),(28 -77))         |
+------+---------------------------------------+

# selects nothing
mysql> SELECT ST_Collect(location) AS result
       FROM product WHERE year = 1999;
+--------+
| result |
+--------+
| NULL   |
+--------+

mysql> SELECT ST_AsText(ST_Collect(location)
         OVER (ORDER BY year, product ROWS BETWEEN 1 PRECEDING AND CURRENT ROW))
         AS result
       FROM product;
+-------------------------------+
| result                        |
+-------------------------------+
| MULTIPOINT((28 -77))          |
| MULTIPOINT((28 -77),(60 -24)) |
| MULTIPOINT((60 -24),(28 -77)) |
| MULTIPOINT((28 -77),(38 60))  |
| MULTIPOINT((38 60),(60 -24))  |
| MULTIPOINT((60 -24),(28 -77)) |
+-------------------------------+

PREV HOME UP NEXT