ST_ 收集 - Amazon Redshift

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

ST_ 收集

ST_Collect 有兩個變體。一個接受兩個幾何,一個接受聚合表達式。

ST_Collect 的第一個變體會從輸入幾何建立幾何。傳回幾何的順序會保留下來。此變體運作方式如下:

  • 如果兩個輸入幾何都是點,則MULTIPOINT返回兩個點。

  • 如果兩個輸入幾何都是線串,則MULTILINESTRING返回兩個線串。

  • 如果兩個輸入幾何都是面,則MULTIPOLYGON返回兩個多邊形。

  • 否則會發生GEOMETRYCOLLECTION返回兩個輸入幾何。

ST_Collect 的第二個變體根據幾何列中的幾何創建幾何。沒有確定幾何的返回順序。指定內部組 (ORDER BY...) 子句以指定返回幾何的順序。此變體運作方式如下:

  • 如果輸入聚合表達式中的所有非 NULL 行都是點,則返回包含聚合表達式中所有點的多點。

  • 如果聚合表達式中的所有非 NULL 行都是線串,則返回包含聚合表達式中所有線串的多線串。

  • 如果聚合表達式中的所有非 NULL 行都是面,則返回包含聚合表達式中所有面的多面。

  • 否則會發生GEOMETRYCOLLECTION包含聚合表達式中的所有幾何。

ST_Collect 返回與輸入幾何相同尺寸的幾何。所有輸入幾何必須具有相同的尺寸。

Syntax (語法)

ST_Collect(geom1, geom2)
ST_Collect(aggregate_expression) [WITHIN GROUP (ORDER BY sort_expression1 [ASC | DESC] [, sort_expression2 [ASC | DESC] ...])]

引數

geom1

GEOMETRY 資料類型的值,或是評估為 GEOMETRY 類型的表達式。

geom2

GEOMETRY 資料類型的值,或是評估為 GEOMETRY 類型的表達式。

aggregate_expression

數據類型的列GEOMETRY或評估為GEOMETRY

[組內部(排序依據排序表達式 1[ASC | 經驗] [,順序表達式 2[ASC | 協議]...]]]

指定聚合值的排序順序的可選子句。ORDER BY 子句包含排序表達式的列表。排序表達式是與查詢選擇列表中的有效排序表達式類似的表達式,如列名。您可以指定升序(ASC) 或降序 (DESC)順序。預設為 ASC

傳回類型

GEOMETRY子類型的MULTIPOINTMULTILINESTRINGMULTIPOLYGON, 或GEOMETRYCOLLECTION

傳回幾何的空間參考系統識別符 (SRID) 值是輸入幾何的 SRID 值。

如果兩者皆是geom1或者geom2為 Null,則會傳回 Null。

如果所有列aggregate_expression為 Null,則會傳回 Null。

如果geom1為空,那麼geom2返回。同樣,如果geom2為空,那麼geom1返回。

如果 geom1geom2 具有不同的 SRID 值,則會傳回錯誤。

如果兩個幾何aggregate_expression具有不同的 SRID 值,則會傳回錯誤。

如果返回的幾何大於GEOMETRY,則會傳回錯誤。

如果geom1geom2的維度不同,則會傳回錯誤。

如果兩個幾何aggregate_expression的維度不同,則會傳回錯誤。

範例

以下 SQL 返回包含兩個輸入幾何的幾何集合。

SELECT ST_AsText(ST_Collect(ST_GeomFromText('LINESTRING(0 0,1 1)'), ST_GeomFromText('POLYGON((10 10,20 10,10 20,10 10))')));
st_astext ----------- GEOMETRYCOLLECTION(LINESTRING(0 0,1 1),POLYGON((10 10,20 10,10 20,10 10)))

以下 SQL 將表中的所有幾何收集到幾何集閤中。

WITH tbl(g) AS (SELECT ST_GeomFromText('POINT(1 2)', 4326) UNION ALL SELECT ST_GeomFromText('LINESTRING(0 0,10 0)', 4326) UNION ALL SELECT ST_GeomFromText('MULTIPOINT(13 4,8 5,4 4)', 4326) UNION ALL SELECT NULL::geometry UNION ALL SELECT ST_GeomFromText('POLYGON((0 0,10 0,0 10,0 0))', 4326)) SELECT ST_AsEWKT(ST_Collect(g)) FROM tbl;
st_astext ----------- SRID=4326;GEOMETRYCOLLECTION(POINT(1 2),LINESTRING(0 0,10 0),MULTIPOINT((13 4),(8 5),(4 4)),POLYGON((0 0,10 0,0 10,0 0)))

以下 SQL 收集表中按 id 列分組並按此 ID 排序的所有幾何。在此示例中,生成的幾何按 ID 分組,如下所示:

  • id 1 — 多點中的點。

  • id 2 — 多線串中的線串。

  • id 3 — 幾何集合中的混合子類型。

  • id 4 — 多面中的多邊形。

  • id 5 — Null,結果為 Null。

WITH tbl(id, g) AS (SELECT 1, ST_GeomFromText('POINT(1 2)', 4326) UNION ALL SELECT 1, ST_GeomFromText('POINT(4 5)', 4326) UNION ALL SELECT 2, ST_GeomFromText('LINESTRING(0 0,10 0)', 4326) UNION ALL SELECT 2, ST_GeomFromText('LINESTRING(10 0,20 -5)', 4326) UNION ALL SELECT 3, ST_GeomFromText('MULTIPOINT(13 4,8 5,4 4)', 4326) UNION ALL SELECT 3, ST_GeomFromText('MULTILINESTRING((-1 -1,-2 -2),(-3 -3,-5 -5))', 4326) UNION ALL SELECT 4, ST_GeomFromText('POLYGON((0 0,10 0,0 10,0 0))', 4326) UNION ALL SELECT 4, ST_GeomFromText('POLYGON((20 20,20 30,30 20,20 20))', 4326) UNION ALL SELECT 1, NULL::geometry UNION ALL SELECT 2, NULL::geometry UNION ALL SELECT 5, NULL::geometry UNION ALL SELECT 5, NULL::geometry) SELECT id, ST_AsEWKT(ST_Collect(g)) FROM tbl GROUP BY id ORDER BY id;
id | st_asewkt ----+----------------------------------------------------------------------------------------------------------- 1 | SRID=4326;MULTIPOINT((1 2),(4 5)) 2 | SRID=4326;MULTILINESTRING((0 0,10 0),(10 0,20 -5)) 3 | SRID=4326;GEOMETRYCOLLECTION(MULTIPOINT((13 4),(8 5),(4 4)),MULTILINESTRING((-1 -1,-2 -2),(-3 -3,-5 -5))) 4 | SRID=4326;MULTIPOLYGON(((0 0,10 0,0 10,0 0)),((20 20,20 30,30 20,20 20))) 5 |

以下 SQL 會從幾何集合中的表中收集所有幾何。結果按降序排序id,然後根據它們的最小和最大 x 座標按字典順序排列。

WITH tbl(id, g) AS ( SELECT 1, ST_GeomFromText('POINT(4 5)', 4326) UNION ALL SELECT 1, ST_GeomFromText('POINT(1 2)', 4326) UNION ALL SELECT 2, ST_GeomFromText('LINESTRING(10 0,20 -5)', 4326) UNION ALL SELECT 2, ST_GeomFromText('LINESTRING(0 0,10 0)', 4326) UNION ALL SELECT 3, ST_GeomFromText('MULTIPOINT(13 4,8 5,4 4)', 4326) UNION ALL SELECT 3, ST_GeomFromText('MULTILINESTRING((-1 -1,-2 -2),(-3 -3,-5 -5))', 4326) UNION ALL SELECT 4, ST_GeomFromText('POLYGON((20 20,20 30,30 20,20 20))', 4326) UNION ALL SELECT 4, ST_GeomFromText('POLYGON((0 0,10 0,0 10,0 0))', 4326) UNION ALL SELECT 1, NULL::geometry UNION ALL SELECT 2, NULL::geometry UNION ALL SELECT 5, NULL::geometry UNION ALL SELECT 5, NULL::geometry) SELECT ST_AsEWKT(ST_Collect(g) WITHIN GROUP (ORDER BY id DESC, ST_XMin(g), ST_XMax(g))) FROM tbl;
st_asewkt --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- SRID=4326;GEOMETRYCOLLECTION(POLYGON((0 0,10 0,0 10,0 0)),POLYGON((20 20,20 30,30 20,20 20)),MULTILINESTRING((-1 -1,-2 -2),(-3 -3,-5 -5)),MULTIPOINT((13 4),(8 5),(4 4)),LINESTRING(0 0,10 0),LINESTRING(10 0,20 -5),POINT(1 2),POINT(4 5)