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

版本 9.0

8.4 目前版本
8.0
5.7

8.0 日文

MySQL 9.0 參考手冊 / ... / 建立幾何值的 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() 來建立空的幾何。此外，諸如 ST_GeomFromText() 之類的函數接受 WKT 幾何集合引數，並且理解 OpenGIS 'GEOMETRYCOLLECTION EMPTY' 標準語法和 MySQL 'GEOMETRYCOLLECTION()' 非標準語法。
GeomCollection() 和 GeometryCollection() 是同義詞，其中 GeomCollection() 是慣用的函數。
GeometryCollection(g [, g] ...)
從幾何引數建構 GeomCollection 值。
GeometryCollection() 會傳回引數中包含的所有正確幾何，即使存在不支援的幾何也一樣。
允許使用沒有引數的 GeometryCollection() 來建立空的幾何。此外，諸如 ST_GeomFromText() 之類的函數接受 WKT 幾何集合引數，並且理解 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。