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

StarRocks 中文参考:ST_CoverageSimplify

· 52CE 我爱测

对整个窗口分区中的边匹配原生笛卡尔 XY 多边形进行联合简化。相邻行的共享边共同简化,每个结果保持原始行的位置和 CRS。与逐个处理几何值的标量函数 ST_SimplifyPreserveTopology 不同。

ST_CoverageSimplify

对整个窗口分区中的边匹配原生笛卡尔 XY 多边形进行联合简化。相邻行的共享边共同简化,每个结果保持原始行的位置和 CRS。与逐个处理几何值的标量函数 ST_SimplifyPreserveTopology 不同。

语法

ST_CoverageSimplify(GEOMETRY geom, DOUBLE tolerance)
    OVER (PARTITION BY coverage_id)
ST_CoverageSimplify(GEOMETRY geom, DOUBLE tolerance, BOOLEAN simplify_boundary)
    OVER (PARTITION BY coverage_id)

OVER () 将所有行作为一个分区;整个分区可以跨多个 chunk。禁止窗口内 ORDER BY、显式窗口 frame、DISTINCT、IGNORE NULLS、RESPECT NULLS 和分析执行 hint。查询外层 ORDER BY 可用。不提供标量、数组或普通聚合重载。

参数和输入

两个参数必须是可折叠的计划常量。容差必须为有限非负值,其平方也必须能表示为有限 DOUBLE。双参数形式默认 simplify_boundary = true,显式 NULL 不使用默认值。

容差是基于面积的 Visvalingam–Whyatt 参数,与有效三角形面积的平方根相关,使用输入坐标单位:EPSG:4326 为笛卡尔度,EPSG:3857 为投影米,并非地表测地距离。不进行重投影、吸附或坐标裁剪;不保证 Hausdorff/最大距离、面积不变、最大顶点减少量或与 PostGIS 完全一致。

true 可简化共享边及外边界。false 仅简化共享内部边,保持外部边界、间隙及未填充孔洞的原始边。由另一个成员填充的孔洞属于共享内部边界。

仅接受具有统一平面 GEOMETRY CRS 描述符的 POLYGON/MULTIPOLYGON。非空内部不得重叠,共享边顶点必须匹配。允许间隙(gapWidth = 0)。函数不检查输入是否为有效覆盖。对于无效输入,输出可能包含异常结果,且不保证为有效覆盖。不自动修复、合并或补充节点。不支持 GEOGRAPHY、POINT、LINESTRING、GEOMETRYCOLLECTION 和 Z/M。UNKNOWN/MIXED 维度元数据只有在实际值通过 XY 验证后才可接受。

返回值和错误

返回相同 CRS 的原生 XY WKB GEOMETRY,每行一个结果。对于有效覆盖,保持 POLYGON/MULTIPOLYGON 类型、成员顺序、孔洞、环方向、接触点、交汇点及共享边。单成员 MULTIPOLYGON 仍为 MULTIPOLYGON。按位置映射行,不按几何值去重。

  • NULL 几何值不参与计算,并在原位置返回 NULL。
  • POLYGON/MULTIPOLYGON EMPTY 保持类型和位置。
  • 容差或显式边界参数为 NULL 时,所有结果为 NULL,不运行覆盖内核;类型和常量检查仍执行。
  • 容差为零时保留输入结构检查,并返回原始 WKB,包括重复的闭合坐标。
  • 空输入或全 NULL/EMPTY 仍检查参数。损坏 WKB、结构无效的环、不支持的描述符/维度和资源超限在发布该分区结果前报错。

资源管理

窗口算子和覆盖内核使用 StarRocks 查询内存管理,并受查询内存限制约束。在输入接收、内核循环和输出期间检查取消和内存状态。原生 WKB 结构边界和整数范围检查仍然适用。发生错误时不发布部分分区结果。不保证固定的取消延迟或运行时间。

示例

WITH districts AS (
    SELECT 1 AS district_id, 7 AS coverage_id,
           'POLYGON ((0 0,0 8,4 8,4.1 6,3.8 4,4.2 2,4 0,0 0))' AS wkt
    UNION ALL
    SELECT 2, 7, 'POLYGON ((4 0,4.2 2,3.8 4,4.1 6,4 8,8 8,8 0,4 0))'
)
SELECT district_id,
       ST_AsText(ST_CoverageSimplify(ST_GeomFromText(wkt, 'EPSG:3857'), 1, false)
                 OVER (PARTITION BY coverage_id)) AS simplified
FROM districts ORDER BY district_id;
-- 1  POLYGON ((0 0, 0 8, 4 8, 4 0, 0 0))
-- 2  POLYGON ((4 0, 4 8, 8 8, 8 0, 4 0))

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

SELECT ST_AsText(ST_CoverageSimplify(
    ST_GeomFromText('POLYGON EMPTY', 'EPSG:3857'), 0, NULL) OVER ());
-- NULL

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

资料来源与适用范围

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

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

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