TDengine 地理函数 ST_GeomFromText 用户手册

ST_GeomFromText 函数

基本信息

语法：ST_GeomFromText(wkt_expr)
作用：将 Well-Known Text (WKT) 字符串转换为 GEOMETRY 类型并存储为二进制。
返回类型：GEOMETRY
适用类型：VARCHAR（输入 WKT）
适用表：表、超级表
支持的 WKT 类型：POINT / LINESTRING / POLYGON / MULTIPOINT / MULTILINESTRING / MULTIPOLYGON / GEOMETRYCOLLECTION

常用 WKT 示例

sql 复制代码

-- 点
ST_GeomFromText('POINT(116.397 39.908)')

-- 线串
ST_GeomFromText('LINESTRING(116.39 39.90,116.40 39.91,116.41 39.92)')

-- 简单多边形（闭合，首尾一致）
ST_GeomFromText('POLYGON((0 0,4 0,4 3,0 3,0 0))')

-- 带洞多边形（外环 + 内环）
ST_GeomFromText('POLYGON((0 0,6 0,6 6,0 6,0 0),(2 2,4 2,4 4,2 4,2 2))')

-- 多点
ST_GeomFromText('MULTIPOINT((0 0),(1 1),(2 2))')

-- 多线串
ST_GeomFromText('MULTILINESTRING((0 0,1 1),(2 2,3 3,4 4))')

-- 多多边形
ST_GeomFromText('MULTIPOLYGON(((0 0,2 0,2 2,0 2,0 0)),((3 3,5 3,5 5,3 5,3 3)))')

-- 几何集合（混合类型）
ST_GeomFromText('GEOMETRYCOLLECTION(POINT(1 1),LINESTRING(0 0,2 2))')

基础用法示例

sql 复制代码

-- 建表：包含 GEOMETRY 列
CREATE TABLE geo_points (
  ts TIMESTAMP,
  name VARCHAR(64),
  geom GEOMETRY(256)
);

-- 插入点数据
INSERT INTO geo_points VALUES
  (NOW, 'tiananmen', 'POINT(116.397 39.908)'),
  (NOW, 'airport',   'POINT(116.407 40.080)');

-- 查看 WKT 输出
SELECT name, ST_AsText(geom) AS wkt FROM geo_points;

业务场景示例

设备定位（点）

sql 复制代码

-- 设备位置入库
INSERT INTO geo_points VALUES
  (NOW, 'meter-001', 'POINT(121.48 31.23)');

-- 可视化取出
SELECT name, ST_AsText(geom) FROM geo_points WHERE name='meter-001';

巡检/线路（线串）

sql 复制代码

CREATE TABLE patrol_paths (
  ts TIMESTAMP,
  path_name VARCHAR(64),
  geom GEOMETRY(128)
);

INSERT INTO patrol_paths VALUES
  (NOW, 'line-1', 'LINESTRING(121.48 31.23,121.50 31.25,121.52 31.27)');

SELECT path_name, ST_AsText(geom) FROM patrol_paths;

服务/供电覆盖区（多边形）

sql 复制代码

CREATE TABLE service_zones (
  ts TIMESTAMP,
  zone_name VARCHAR(64),
  geom GEOMETRY(128)
);

INSERT INTO service_zones VALUES
  (NOW, 'zone-a', 'POLYGON((0 0,4 0,4 3,0 3,0 0))');

-- 取出 WKT 复核
SELECT zone_name, ST_AsText(geom) FROM service_zones;

注意事项

输入必须是合法 WKT；坐标用空格分隔，同一点的首尾需闭合（多边形）。
建议插入后用 ST_AsText 复核。
GEOMETRY 以二进制存储，WKT 仅作输入/输出格式。
不区分 SRID，默认按原始数值存储；若需坐标系管理，请在应用侧约定。

关于 TDengine

TDengine 专为物联网IoT平台、工业大数据平台设计。其中，TDengine TSDB 是一款高性能、分布式的时序数据库（Time Series Database），同时它还带有内建的缓存、流式计算、数据订阅等系统功能；TDengine IDMP 是一款AI原生工业数据管理平台，它通过树状层次结构建立数据目录，对数据进行标准化、情景化，并通过 AI 提供实时分析、可视化、事件管理与报警等功能。