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

Apache Doris 中文参考:ST_LINEFROMTEXT

· 52CE 我爱测

返回 Line 类型的几何对象,该对象在内存中以 Doris 内部的空间数据格式存储,可直接作为参数传入其他空间函数(如 ST_LENGTH、ST_INTERSECTS 等)进行计算。

描述

将一个 WKT(Well Known Text)转化为一个 Line 形式的内存表现形式

别名

  • ST_LINESTRINGFROMTEXT

语法

ST_LINEFROMTEXT( <wkt>)

参数

参数 说明
<wkt> 符合 LINE 类型的 WKT 字符串,格式为:
"LINE (x1 y1, x2 y2)"
其中,(x1 y1), (x2 y2) 是线段的顶点坐标,坐标值为数值(整数或小数)。

返回值

返回 Line 类型的几何对象,该对象在内存中以 Doris 内部的空间数据格式存储,可直接作为参数传入其他空间函数(如 ST_LENGTH、ST_INTERSECTS 等)进行计算。

  • 若输入的 WKT 字符串格式无效(如顶点数量不足 2 个、语法错误、坐标非数值等),返回 NULL。
  • 若输入 为 NULL 或空字符串,返回 NULL。

举例

正常LINE类型

mysql> SELECT ST_AsText(ST_LineFromText("LINESTRING (1 1, 2 2)"));
+-----------------------------------------------------+
| ST_AsText(ST_LineFromText("LINESTRING (1 1, 2 2)")) |
+-----------------------------------------------------+
| LINESTRING (1 1, 2 2)                               |
+-----------------------------------------------------+

无效 WKT(顶点数量不足)

mysql> SELECT ST_LineFromText("LINESTRING (1 1)");
+-------------------------------------+
| ST_LineFromText("LINESTRING (1 1)") |
+-------------------------------------+
| NULL                                |
+-------------------------------------+

无效 WKT(语法错误)

mysql> SELECT ST_LineFromText("LINESTRING (1 1, 2 2");
+-----------------------------------------+
| ST_LineFromText("LINESTRING (1 1, 2 2") |
+-----------------------------------------+
| NULL                                    |
+-----------------------------------------+

无效WKT(顶点数量太多)

mysql> SELECT ST_LineFromText("LINESTRING (1 1,2 2,3 3)");
+---------------------------------------------------------------------------------+
| ST_LineFromText("LINESTRING (1 1,2 2,3 3)")                                     |
+---------------------------------------------------------------------------------+
|     ��_<���?'���Xޑ?݉+
                       ߑ?�����?(Qjm�ۡ?'���Xޡ?�3|ʏ��?lW<�`ª?��H�˪?       |
+---------------------------------------------------------------------------------+

输入 NULL

mysql> SELECT ST_LineFromText(NULL);
+-----------------------+
| ST_LineFromText(NULL) |
+-----------------------+
| NULL                  |
+-----------------------+

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

资料来源与适用范围

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

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

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