MySQL :: MySQL 8.4 參考手冊 :: 14.16.5 建立幾何值的 MySQL 特定函式

版本 8.4

8.0 日文

MySQL 8.4 參考手冊 / ... / 建立幾何值的 MySQL 特定函式

14.16.5 建立幾何值的 MySQL 特定函式

MySQL 提供一組有用的非標準函式來建立幾何值。本節所述的函式是 MySQL 對 OpenGIS 規格的擴充。

這些函式會從 WKB 值或幾何物件 (作為引數) 產生幾何物件。如果任何引數不是適當的 WKB 或適當物件類型的幾何表示法，則傳回值為 NULL。

例如，您可以將 Point() 的幾何傳回值直接插入 POINT 資料行中

INSERT INTO t1 (pt_col) VALUES(Point(1,2));

GeomCollection(g [, g] ...)
從幾何引數建構 GeomCollection 值。
GeomCollection() 會傳回引數中包含的所有適當幾何，即使存在不支援的幾何也一樣。
允許不帶引數的 GeomCollection() 作為建立空幾何的方式。此外，接受 WKT 幾何集合引數的函式 (例如 ST_GeomFromText()) 了解 OpenGIS 'GEOMETRYCOLLECTION EMPTY' 標準語法和 MySQL 'GEOMETRYCOLLECTION()' 非標準語法。
GeomCollection() 和 GeometryCollection() 是同義詞，其中 GeomCollection() 是慣用的函式。
GeometryCollection(g [, g] ...)
從幾何引數建構 GeomCollection 值。
GeometryCollection() 會傳回引數中包含的所有適當幾何，即使存在不支援的幾何也一樣。
允許不帶引數的 GeometryCollection() 作為建立空幾何的方式。此外，接受 WKT 幾何集合引數的函式 (例如 ST_GeomFromText()) 了解 OpenGIS 'GEOMETRYCOLLECTION EMPTY' 標準語法和 MySQL 'GEOMETRYCOLLECTION()' 非標準語法。
GeomCollection() 和 GeometryCollection() 是同義詞，其中 GeomCollection() 是慣用的函式。
LineString(pt [, pt] ...)
從許多 Point 或 WKB Point 引數建構 LineString 值。如果引數數量少於兩個，則傳回值為 NULL。
MultiLineString(ls [, ls] ...)
使用 LineString 或 WKB LineString 引數建構 MultiLineString 值。
MultiPoint(pt [, pt2] ...)
使用 Point 或 WKB Point 引數建構 MultiPoint 值。
MultiPolygon(poly [, poly] ...)
從一組 Polygon 或 WKB Polygon 引數建構 MultiPolygon 值。
Point(x, y)
使用其座標建構 Point。
Polygon(ls [, ls] ...)
從數個 LineString 或 WKB LineString 引數建構一個 Polygon 值。如果任何引數不代表 LinearRing（亦即，不是封閉且簡單的 LineString），則傳回值為 NULL。