大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:ST_GeomFromText, ST_GeometryFromText

· 52CE 我爱测

对于原生签名, 必须是非空字符串字面量。没有默认 CRS,也不会执行隐式坐标转换或重投影。支持全部七种二维 OGC 几何类型、 和空子元素。无效 WKT 返回 ;WKT 为 时返回 。

ST_GeomFromText, ST_GeometryFromText

ST_GeomFromText(wkt, crs) 从二维 OGC Well-Known Text(WKT)构造原生平面 GEOMETRY 值。必须显式指定 CRS,该 CRS 会成为原生类型描述符的一部分。

现有的单参数 ST_GeomFromText 和 ST_GeometryFromText 签名保持不变,继续返回旧版 VARCHAR 表示。

语法

GEOMETRY ST_GeomFromText(VARCHAR wkt, VARCHAR crs)
VARCHAR ST_GeomFromText(VARCHAR wkt)
VARCHAR ST_GeometryFromText(VARCHAR wkt)

参数说明

对于原生签名,crs 必须是非空字符串字面量。没有默认 CRS,也不会执行隐式坐标转换或重投影。支持全部七种二维 OGC 几何类型、EMPTY 和空子元素。无效 WKT 返回 NULL;WKT 为 NULL 时返回 NULL。

返回值说明

双参数签名返回原生 GEOMETRY。单参数签名返回旧版 VARCHAR 表示。

在查询中,兼容的原生地理空间值可以用作 ARRAY 元素、MAP 值或 STRUCT 字段。您可以构造这些容器、读取元素和字段、使用 cardinality 或 array_length、用 UNNEST 展开数组,也可以使用 array_map、array_filter,以及不带排序和 DISTINCT 的 array_agg 和 map_agg。

MAP 的键不能包含地理空间值。需要对地理空间值进行相等性判断、排序或哈希计算的操作会被拒绝,例如比较、排序和去重。视图、物化视图、SQL UDF、生成列、SQL 执行计划基线和 Pipe 等持久化 SQL 定义不能使用嵌套地理空间表达式。

向客户端返回容器前,请先用 ST_AsText 或 ST_AsBinary 转换其中的地理空间元素或字段。标量 GEOGRAPHY 可以直接返回。标量 GEOMETRY 也需要显式转换。

SELECT array_map(x -> ST_AsText(x), [ST_GeomFromText('POINT (1 2)', 'EPSG:3857')]);

示例

MySQL > SELECT ST_AsText(ST_GeomFromText('LINESTRING (1 1, 2 2)', 'EPSG:3857'));
+----------------------------------------------------------------------------+
| st_astext(st_geomfromtext('LINESTRING (1 1, 2 2)', 'EPSG:3857'))           |
+----------------------------------------------------------------------------+
| LINESTRING (1 1, 2 2)                                                      |
+----------------------------------------------------------------------------+

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。