ITPub博客

ST_LINEFROMTEXT函数根据给定的wkt（Well-Known Text）和srid返回一个ST_GEOMETRY类型数据，如果传入的WKT不是LINESTRING，则返回NULL。入参wkt和srid的规格与ST_GEOMFROMTEXT函数相同。当输入的参数存在NULL时，函数返回NULL，空串作为NULL处理。示例（单机HEAP表）SELECT ST_AsText(ST_

ST_LENGTH函数根据输入的geometry，返回对应的长度数据。geometry通用表达式，其值必须为有效的ST_GEOMETRY类型的数据，遵循如下规则：geometry是LINESTRING、MULTILINESTRING或GEOMETRY COLLECTION类型会返回对应的长度，其它的geometry类型会返回0。geometry的空间参考系标识号（SRID）必须在spatial_r

ST_ISVALID函数根据输入的geometry，返回该geometry是否有效，如该geometry是有效的，则返回TRUE，否则返回FALSE。ST_GEOMETRY类型数据是否有效须遵循OGC SFS规范，按照如下规则判断该数据是否有效：POINT：均为有效。MULTIPOINT：均为有效。LINESTRING：均为有效。MULTILINESTRING：均为有效。POLYGON：有效的PO

ST_ISSIMPLE函数根据输入的geometry，返回该geometry是否简单，如该geometry符合简单定义，则返回TRUE，否则返回FALSE。ST_GEOMETRY类型数据的简单定义遵循OGC SFS规范，按照如下规则判断该数据是否简单：POINT：均为简单。MULTIPOINT：所有点唯一时，该数据为简单；否则不为简单。LINESTRING：除端点之外的所有点唯一时，该数据为简单；

ST_ISEMPTY函数根据输入的geometry，返回该geometry是否为空，即EMPTY，如该geometry均为EMPTY，则返回TRUE，否则返回FALSE。geometry通用表达式，其值必须为有效的ST_GEOMETRY类型的数据。当输入的参数存在NULL时，函数返回NULL，空串作为NULL处理。示例（单机HEAP表）SELECT ST_IsEmpty(ST_GeomF

ST_ISCLOSED函数用于判断线的首、尾两个点是否重合，通常用于判断LineString的首尾是否闭合。本函数遵守如下规则：当输入对象为NULL，返回NULL。当输入对象为空几何对象（如LineString Empty），返回FALSE。其他情况下对于不同的几何对象类型，其行为如下：对象类型ST_IsClosed函数行为Point返回trueLineString判断LineString的首尾是

ST_INTERSECTS函数的功能是判断两个Geometry是否相交（即至少有一个共同点），如相交则返回TRUE，否则返回FALSE。geometry通用表达式，其值必须为有效的ST_GEOMETRY类型的数据。输入的geometry1和geometry2须具有相同的空间参考系标识号（SRID）。本函数遵守如下规则：当输入的参数存在NULL时，函数返回NULL。仅计算2D结果，若输入参数中存在Z

ST_INTERSECTION函数返回两个geometry对象的交集，返回值为ST_GEOMETRY类型数据。函数会将geometry对象投射到网格线上进行计算并返回结果。geometry通用表达式，其值必须为有效的ST_GEOMETRY类型的数据。输入的geometry1和geometry2须具有相同的空间参考系标识号（SRID）。gridsizegridsize的数据类型为DOUBLE，表示函

ST_GEOMFROMWKB函数根据给定的wkb（Well-Known Binary）和srid返回一个ST_GEOMETRY类型数据。wkbwkb的数据类型是BLOB，遵循如下规则：支持能够隐式转换成BLOB的类型。wkb需要是一个有效的Well-Known Binary，否则报错。输入的wkb如果前面的字符已经构成了一个有效的ST_GEOMETRY数据，并且后面还有其他有效字符，则只会生成前面

ST_GEOMFROMTEXT（同名函数ST_GEOMETRYFROMTEXT）函数根据给定的wkt（Well-Known Text）和srid返回一个ST_GEOMETRY类型数据。wktwkt的数据类型是CLOB，遵循如下规则：wkt需要是一个有效的Well-Known Text，否则报错。支持的坐标的最高维度是三维，如果输入是四维的坐标，或带有'M'字样的坐标，则会忽略第四个

ST_GEOMFROMGEOJSON函数根据输入的geojson，返回该geojson对应的ST_GEOMETRY类型数据。只支持二维几何图形，三维几何图形会报错。geojsongeojson的数据类型是CLOB，必须为有效的GeoJSON数据，遵循如下规则：支持能够隐式转换成CLOB的类型。当输入的参数是NULL时，函数返回NULL。输入的数据可以包含外包框、坐标参考系，对此不检查正确性且不参与

ST_GEOMFROMEWKB函数根据给定的ewkb（Extended Well-Known Binary）返回一个ST_GEOMETRY类型的数据。ewkbewkb的数据类型是BLOB，遵循如下规则：支持能够隐式转换成BLOB的类型。ewkb需要是一个合法的Extended Well-Known Binary，否则报错。输入的ewkb如果前面的字符已经构成了一个有效的ST_GEOMETRY类型数

ST_GEOMETRYTYPE函数用于打印输入的geometry的类型。该函数会根据输入的geometry返回该geometry的数据类型，返回值为VARCHAR类型。与GEOMETRYTYPE函数相比，ST_GEOMETRYTYPE函数的返回值带ST_前缀且非全大写。geometry通用表达式，其值必须为有效的ST_GEOMETRY类型的数据。当输入的参数存在NULL时，函数返回NULL。示例（

ST_GEOMETRICMEDIAN函数的功能是使用Weiszfeld算法计算MULTIPOINT数据的几何中位数。最终会返回一个POINT数据，该POINT到MULTIPOINT的所有POINT的距离之和是最小的。geometry通用表达式，其值必须为有效的ST_GEOMETRY类型的数据，遵循如下规则：当该参数为NULL时，函数返回NULL。输出的POINT数据维度由输入的MULTIPOINT

ST_GEOMCOLLFROMTEXT函数根据给定的wkt（Well-Known Text）和srid返回一个ST_GEOMETRY类型数据，如果传入的WKT不是GEOMETRYCOLLECTION，则返回NULL。入参wkt和srid的规格与ST_GEOMFROMTEXT函数相同。当输入的参数存在NULL时，函数返回NULL，空串作为NULL处理。示例（单机HEAP表）SELECT S

ST_EXTENT函数的功能是返回一个包围一组geometry的二维边界框，是一个聚合函数，返回类型是BOX2D。geometry通用表达式，其值必须为有效的ST_GEOMETRY类型的数据。本函数遵守如下规则：当输入的一组geometry全部为NULL或全部为EMPTY时，该函数返回NULL。本函数只计算2D结果，如果坐标中有Z轴将直接忽略Z坐标进行计算。geometry不能做为GROUP BY

ST_EQUALS函数的功能是判断两个Geometry是否包含同一组点，即给定的两个Geometry“空间相等”，相等则返回TRUE，否则返回FALSE。空间相等指ST_WITHIN（A，B）= TRUE和ST_WITHIN（B，A）= TRUE，也意味着点的顺序可以不同，但表示相同的几何结构。geometry通用表达式，其值必须为有效的ST_GEOMETRY类型的数据。输入的geometry1和

ST_ENVELOPE函数用于计算输入的geometry的最小外包矩形，返回值为ST_GEOMETRY类型数据。该函数根据输入geometry的不同，返回值的数据类型不同：输入值为POINT类型时，返回值为POINT类型。输入值为其他类型时，返回值为POLYGON类型。输入值为垂直线、水平线时，返回值为线形状的POLYGON类型数据。输入值为任意类型EMPTY时，返回值为POINT EMPTY。g

ST_DWITHIN函数的功能是判断geometry1与geometry2是否在给定的距离distance内，如果在distance内则返回TRUE，否则返回FALSE。geometry通用表达式，其值必须为有效的ST_GEOMETRY类型的数据。输入的geometry1和geometry2须具有相同的空间参考系标识号（SRID）。distancedistance的数据类型是DOUBLE，表示指定

ST_DUMP函数用于返回输入的Geometry对象的所有原子类型（Point、LineString、Polygon）及访问路径。本函数返回一组geometry_dump类型的集合，每个geometry_dump包含：geom属性：类型为ST_Geometry，表示输入geometry中的原子geometry。path属性：integer类型的集合，表示从输入的geometry到该原子geomet