Lindorm时空函数中的构造函数 - 云原生多模数据库 Lindorm

本文介绍时空函数中的构造函数。

引擎与版本

构造函数仅适用于宽表引擎。
宽表引擎为2.6.5及以上版本。如何查看或升级当前版本，请参见宽表引擎版本说明和升级小版本。

重要

要求Lindorm SQL为2.6.8及以上版本。如何查看Lindorm SQL的版本，请参见SQL版本说明。

函数列表

Lindorm GanosBase支持的构造函数如下表所示。

函数	说明
ST_GeomFromText	返回与指定WKT字符串对应的Geometry对象。
ST_LineFromMultiPoint	返回与指定MultiPoint对象对应的LineString对象。
ST_MakePoint	构建一个Point对象。

ST_GeomFromText

返回与指定WKT字符串对应的Geometry对象。

语法

geometry ST_GeomFromText(string wkt)

参数说明

参数	描述
wkt	指定WKT字符串。

说明

Geometry对象支持Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon、GeometryCollection类型。
如果WKT格式中带有SRID，不支持WKT带有空间参考系信息，SRID（默认为4326）可以单独建列存储，仅作为标识。
可以创建任意数据类型的EMPTY。

示例

示例1：Geometry对象为Point类型。

SELECT ST_GeomFromText('POINT(1 1)') as geom;

返回结果：

+-------------+
|    geom     |
+-------------+
| POINT (1 1) |
+-------------+

示例2：Geometry对象为Polygon类型。

SELECT ST_GeomFromText('POLYGON (( 1 1, 1 2, 2 2, 2 1, 1 1))') AS poly;

返回结果：

+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|                                                                                                poly                                                                                                |
+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 0020000003000010E600000001000000053FF00000000000003FF00000000000003FF000000000000040000000000000004000000000000000400000000000000040000000000000003FF00000000000003FF00000000000003FF0000000000000 |
+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

示例3：Geometry对象为EMPTY。

SELECT ST_GeomFromText('POLYGON EMPTY') as geom;

返回结果：

+---------------+
|     geom      |
+---------------+
| POLYGON EMPTY |
+---------------+

ST_LineFromMultiPoint

返回与指定MultiPoint对象对应的LineString对象。

语法

geometry ST_LineFromMultiPoint(geometry aMultiPoint)

参数说明

参数	描述
aMultiPoint	指定MultiPoint对象，可以使用`ST_Collect`函数将Point对象组合成MultiPoint对象。

示例

SELECT ST_AsText(ST_LineFromMultiPoint(ST_Collect(ST_MakePoint(1,2),ST_MakePoint(3,4),ST_MakePoint(5,6)))) AS astext;

返回结果：

+-------------------------+
|         astext          |
+-------------------------+
| LINESTRING(1 2,3 4,5 6) |
+-------------------------+

ST_MakePoint

构建一个Point对象。

语法

geometry ST_MakePoint(double x, double y)

参数说明

参数	描述
x	经度x值。DOUBLE类型，如果输入的数据类型为INTEGER或者LONG会自动转换为DOUBLE类型。
y	纬度y值。DOUBLE类型，如果输入的数据类型为INTEGER或者LONG会自动转换为DOUBLE类型。

说明

不支持设定空间参考系和三维对象。

示例

SELECT ST_AsText(ST_MakePoint(1, 2)) as text;

返回结果：

+-------------+
|    text     |
+-------------+
| POINT (1 2) |
+-------------+