12.17.3 从 WKT 值创建几何值的函数

MySQL 8.0 参考手册 / 第 12 章函数和运算符 / 12.17空间分析函数 / 12.17.3 从 WKT 值创建几何值的函数

12.17.3 从 WKT 值创建几何值的函数

这些函数将 Well-Known Text (WKT) 表示和可选的空间参考系统标识符 (SRID) 作为参数。他们返回相应的几何图形。

ST_GeomFromText()接受任何几何类型的 WKT 值作为其第一个参数。其他函数提供特定于类型的构造函数，用于构造每种几何类型的几何值。

有关 WKT 格式的说明，请参阅 Well-Known Text (WKT) 格式。

GeomCollFromText(wkt [, srid]), GeometryCollectionFromText(wkt [, srid])
ST_GeomCollFromText(), ST_GeometryCollectionFromText(), ST_GeomCollFromTxt(), GeomCollFromText()和 GeometryCollectionFromText() 是同义词。有关详细信息，请参阅的说明 ST_GeomCollFromText()。
GeomCollFromText()并被 GeometryCollectionFromText() 弃用；希望它们在未来的 MySQL 版本中被删除。使用 ST_GeomCollFromText()and ST_GeometryCollectionFromText() 代替。
GeomFromText(wkt [, srid]), GeometryFromText(wkt [, srid])
ST_GeomFromText(), ST_GeometryFromText(), GeomFromText()和 GeometryFromText() 是同义词。有关详细信息，请参阅的说明 ST_GeomFromText()。
GeomFromText()并被 GeometryFromText() 弃用；希望它们在未来的 MySQL 版本中被删除。使用ST_GeomFromText() and ST_GeometryFromText() 代替。
LineFromText(wkt [, srid]), LineStringFromText(wkt [, srid])
ST_LineFromText(), ST_LineStringFromText(), LineFromText()和 LineStringFromText() 是同义词。有关详细信息，请参阅的说明 ST_LineFromText()。
LineFromText()并被 LineStringFromText() 弃用；希望它们在未来的 MySQL 版本中被删除。使用ST_LineFromText() and ST_LineStringFromText() 代替。
MLineFromText(wkt [, srid]), MultiLineStringFromText(wkt [, srid])
ST_MLineFromText(), ST_MultiLineStringFromText(), MLineFromText()和 MultiLineStringFromText() 是同义词。有关详细信息，请参阅的说明 ST_MLineFromText()。
MLineFromText()并被 MultiLineStringFromText() 弃用；希望它们在未来的 MySQL 版本中被删除。使用ST_MLineFromText() and ST_MultiLineStringFromText() 代替。
MPointFromText(wkt [, srid]), MultiPointFromText(wkt [, srid])
ST_MPointFromText(), ST_MultiPointFromText(), MPointFromText()和 MultiPointFromText() 是同义词。有关详细信息，请参阅的说明 ST_MPointFromText()。
MPointFromText()并被 MultiPointFromText() 弃用；希望它们在未来的 MySQL 版本中被删除。使用 ST_MPointFromText()and ST_MultiPointFromText() 代替。
MPolyFromText(wkt [, srid]), MultiPolygonFromText(wkt [, srid])
ST_MPolyFromText(), ST_MultiPolygonFromText(), MPolyFromText()和 MultiPolygonFromText() 是同义词。有关详细信息，请参阅的说明 ST_MPolyFromText()。
MPolyFromText()并被 MultiPolygonFromText() 弃用；希望它们在未来的 MySQL 版本中被删除。使用ST_MPolyFromText() and ST_MultiPolygonFromText() 代替。
PointFromText(wkt [, srid])
ST_PointFromText()并且 PointFromText()是同义词。有关详细信息，请参阅的说明 ST_PointFromText()。
PointFromText()已弃用；希望在未来的 MySQL 版本中将其删除。改用 ST_PointFromText()。
PolyFromText(wkt [, srid]), PolygonFromText(wkt [, srid])
ST_PolyFromText(), ST_PolygonFromText(), PolyFromText()和 PolygonFromText() 是同义词。有关详细信息，请参阅的说明 ST_PolyFromText()。
PolyFromText()并被 PolygonFromText() 弃用；希望它们在未来的 MySQL 版本中被删除。使用ST_PolyFromText() and ST_PolygonFromText() 代替。
ST_GeomCollFromText(wkt [, srid]), , ST_GeometryCollectionFromText(wkt [, srid])ST_GeomCollFromTxt(wkt [, srid])
GeometryCollection使用其 WKT 表示和 SRID 构造一个值。
如果 geometry 参数是NULL或不是语法上格式正确的几何图形，或者如果 SRID 参数是 NULL，则返回值为 NULL。
```
mysql> SET @g = "MULTILINESTRING((10 10, 11 11), (9 9, 10 10))";
mysql> SELECT ST_AsText(ST_GeomCollFromText(@g));
+--------------------------------------------+
| ST_AsText(ST_GeomCollFromText(@g))         |
+--------------------------------------------+
| MULTILINESTRING((10 10,11 11),(9 9,10 10)) |
+--------------------------------------------+
```
ST_GeomCollFromText(), ST_GeometryCollectionFromText(), ST_GeomCollFromTxt(), GeomCollFromText()和 GeometryCollectionFromText() 是同义词。
ST_GeomFromText(wkt [, srid]), ST_GeometryFromText(wkt [, srid])
使用其 WKT 表示和 SRID 构造任何类型的几何值。
如果 geometry 参数是NULL或不是语法上格式正确的几何图形，或者如果 SRID 参数是 NULL，则返回值为 NULL。
ST_GeomFromText(), ST_GeometryFromText(), GeomFromText()和 GeometryFromText() 是同义词。
ST_LineFromText(wkt [, srid]), ST_LineStringFromText(wkt [, srid])
LineString使用其 WKT 表示和 SRID 构造一个值。
如果 geometry 参数是NULL或不是语法上格式正确的几何图形，或者如果 SRID 参数是 NULL，则返回值为 NULL。
ST_LineFromText(), ST_LineStringFromText(), LineFromText()和 LineStringFromText() 是同义词。
ST_MLineFromText(wkt [, srid]), ST_MultiLineStringFromText(wkt [, srid])
MultiLineString使用其 WKT 表示和 SRID 构造一个值。
如果 geometry 参数是NULL或不是语法上格式正确的几何图形，或者如果 SRID 参数是 NULL，则返回值为 NULL。
ST_MLineFromText(), ST_MultiLineStringFromText(), MLineFromText()和 MultiLineStringFromText() 是同义词。
ST_MPointFromText(wkt [, srid]), ST_MultiPointFromText(wkt [, srid])
MultiPoint使用其 WKT 表示和 SRID 构造一个值。
如果 geometry 参数是NULL或不是语法上格式正确的几何图形，或者如果 SRID 参数是 NULL，则返回值为 NULL。
诸如 ST_MPointFromText()和之类的函数ST_GeomFromText()接受 WKT 格式的MultiPoint 值表示，允许值中的各个点用括号括起来。例如，以下两个函数调用都是有效的：
```
ST_MPointFromText('MULTIPOINT (1 1, 2 2, 3 3)')
ST_MPointFromText('MULTIPOINT ((1 1), (2 2), (3 3))')
```
ST_MPointFromText(), ST_MultiPointFromText(), MPointFromText()和 MultiPointFromText() 是同义词。
ST_MPolyFromText(wkt [, srid]), ST_MultiPolygonFromText(wkt [, srid])
MultiPolygon使用其 WKT 表示和 SRID 构造一个值。
如果 geometry 参数是NULL或不是语法上格式正确的几何图形，或者如果 SRID 参数是 NULL，则返回值为 NULL。
ST_MPolyFromText(), ST_MultiPolygonFromText(), MPolyFromText()和 MultiPolygonFromText() 是同义词。
ST_PointFromText(wkt [, srid])
Point使用其 WKT 表示和 SRID 构造一个值。
如果 geometry 参数是NULL或不是语法上格式正确的几何图形，或者如果 SRID 参数是 NULL，则返回值为 NULL。
ST_PointFromText()并且 PointFromText()是同义词。
ST_PolyFromText(wkt [, srid]), ST_PolygonFromText(wkt [, srid])
Polygon使用其 WKT 表示和 SRID 构造一个值。
如果 geometry 参数是NULL或不是语法上格式正确的几何图形，或者如果 SRID 参数是 NULL，则返回值为 NULL。
ST_PolyFromText(), ST_PolygonFromText(), PolyFromText()和 PolygonFromText() 是同义词。