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

StarRocks 中文参考:ST_SimplifyPreserveTopology

· 52CE 我爱测

减少原生笛卡尔 XY 的顶点,同时保留有效性、维度、组成部分、环、孔洞归属、已有接触和分离关系。如果删除顶点不安全,则保留原有部分。这是针对单个几何的标量运算,不会在多行之间执行覆盖简化。

ST_SimplifyPreserveTopology

减少原生笛卡尔 XY GEOMETRY 的顶点,同时保留有效性、维度、组成部分、环、孔洞归属、已有接触和分离关系。如果删除顶点不安全,则保留原有部分。这是针对单个几何的标量运算,不会在多行之间执行覆盖简化。

语法

ST_SimplifyPreserveTopology(GEOMETRY geometry, DOUBLE tolerance)

容差可以是常量,也可以随行变化。必须为有限非负数,单位为输入坐标单位。不支持第三个参数。

输入和结果

支持 POINT、LINESTRING、POLYGON、对应的 MULTI 类型以及嵌套 GEOMETRYCOLLECTION。结果保留输入类型、组成部分顺序、集合树、带类型的 EMPTY 子元素、CRS 和平面 XY 描述符。只有一个成员的 MULTIPOLYGON 仍为 MULTIPOLYGON。点和重复点成员保持不变。线保留端点,环保留闭合和方向。结果仅使用原始顶点,并保留各路径中的原始顺序。

任一参数为 NULL 时返回 NULL。容差为零时,在完成结构、维度和拓扑校验后返回原始 WKB。EMPTY 保留原有类型;非 NULL 的 EMPTY 也要求容差有效。负数、NaN 或无穷容差、格式错误的 WKB、无效多边形拓扑、退化线或环以及超出限制均报错。不会修复无效输入,也不会通过丢弃组成部分来生成有效结果。

不支持 GEOGRAPHY、Z/M、未知或混合维度。此函数支持集合不表示其他 GEO 函数也支持集合。不提供聚合、窗口或数组形式。

单位和误差界限

EPSG:4326 使用笛卡尔角度,容差 1000 表示 1000 度。EPSG:3857 使用投影米,而非测地地面距离。不执行坐标转换、环绕、截断或球面计算。

对线的路径和多边形边界,输入与结果的双向 Hausdorff 距离不超过容差。每个替换线段都检查完整的原始子路径,包括此前删除的顶点,因此误差不会累积。接触和距离判断对存储的有限 double 坐标执行精确的二进制有理数比较,不会通过隐含 epsilon、吸附或精度网格更改输入。不保证面积不变、填充多边形内部的距离界限、最大简化程度或与 PostGIS/JTS 顶点一致。不同输入行之间的共享边界不受约束。

资源限制

每个输入限制为 256 KiB WKB、5,000 个坐标位置(包括闭合点)、1,024 个几何节点与环,以及 32 层嵌套。准备和每次计算受 2,000 万个计费工作单位的限制。精确整数大小、活动边、索引和查询结果有界;输入大小未超限时也可能触发工作量限制。准备模型和临时分配都受查询内存限制约束。取消和内存检查在行之间、有界分配组之前以及工作循环内执行。不保证固定的峰值内存或执行时间。

示例

SELECT ST_AsText(ST_SimplifyPreserveTopology(
    ST_GeomFromText('LINESTRING (0 0,1 0,2 0)', 'EPSG:3857'), 0.1));
-- LINESTRING (0 0, 2 0)

SELECT ST_AsText(ST_SimplifyPreserveTopology(
    ST_GeomFromText('MULTIPOLYGON EMPTY', 'EPSG:4326'), 1));
-- MULTIPOLYGON EMPTY

SELECT ST_SRID(ST_SimplifyPreserveTopology(
    ST_GeomFromText('POINT (1 2)', 'EPSG:4326'), 0));
-- 4326

SELECT ST_AsText(ST_SimplifyPreserveTopology(
    ST_GeomFromText('POINT (1 2)', 'EPSG:3857'), NULL));
-- NULL

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

资料来源与适用范围

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

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

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