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

StarRocks 中文参考:ST_Difference

· 52CE 我爱测

返回第一个输入中位于第二个输入之外的区域。参数顺序会影响结果。保留孔洞及不相连的组成部分。

ST_Difference

返回第一个输入中位于第二个输入之外的区域。参数顺序会影响结果。保留孔洞及不相连的组成部分。

语法

ST_Difference(GEOMETRY lhs, GEOMETRY rhs)

行为与限制

两个参数必须是具有兼容 CRS 描述符的原生 XY POLYGON 或 MULTIPOLYGON。支持这两种类型的全部四种组合。返回原生 GEOMETRY,保留 CRS 和 XY 坐标:单个面积组成部分为 POLYGON,多个组成部分为 MULTIPOLYGON,空结果为 POLYGON EMPTY。

NULL 参数返回 NULL。EMPTY 表示空区域,不等于 NULL。在处理空输入之前,检查非 NULL 输入的结构及拓扑有效性,包括孔洞和多多边形各部分之间的关系。无效输入产生错误,不进行修复。

即使 CRS 为 EPSG:4326,也使用笛卡尔运算(以度为单位的直线边)。EPSG:3857 使用以米为单位的投影坐标。不会隐式转换坐标。不支持 GEOGRAPHY、点、线、集合、Z/M、兼容性不符的 CRS、聚合或数组形式及精度网格参数。

计算采用浮点运算,不进行吸附或整数重缩放。WKB 输出为 double 坐标。环方向、起点和组成部分顺序可能改变。如果将输入平移到共同的局部原点或对输出舍入导致拓扑丢失,函数返回错误,不修复或丢弃几何对象。

每个输入最多为 256 KiB WKB 和 5,000 个坐标(包括闭环坐标)。坐标数为 n 和 m 时,还必须满足 n*n + m*m + n*m <= 25,000,000。输出及对称差集的各中间结果最多为 5,000 个坐标;中间结果对也必须满足相同的工作量限制。超出限制返回错误,不截断结果。输入模型及临时分配受查询内存限制约束。在行之间及 overlay 调用前后检查取消状态;单次 Boost 调用没有取消回调。这些限制不保证固定的内存峰值或运行时间。

示例

SELECT ST_Area(ST_Difference(
    ST_GeomFromText('POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0))', 'EPSG:3857'),
    ST_GeomFromText('POLYGON ((2 0, 6 0, 6 4, 2 4, 2 0))', 'EPSG:3857')));
-- 8

SELECT ST_AsText(ST_Difference(
    ST_GeomFromText('POLYGON EMPTY', 'EPSG:3857'),
    ST_GeomFromText('POLYGON EMPTY', 'EPSG:3857')));
-- POLYGON EMPTY

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

资料来源与适用范围

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

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

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