PostgreSQL窗口函数本身不支持地理空间聚类，必须先用ST_ClusterDBSCAN生成聚类ID，再在其基础上使用ROW_NUMBER()等窗口函数进行簇内排序；该函数是PostGIS扩展提供的密度聚类工具，需注意SRID、eps单位及噪声点处理。
窗口函数本身不支持地理空间聚类，必须先用ST_ClusterDBSCAN预处理
PostgreSQL 的窗口函数（如 ROW_NUMBER()、RANK()）无法直接对地理空间点做密度聚类——它们只按排序逻辑分配序号，不理解经纬度距离或空间邻近性。真正在做“地理空间聚类排名”的核心是 ST_ClusterDBSCAN()，它属于 PostGIS 扩展，会为每个几何对象打上聚类 ID（cluster_id），之后才能用窗口函数在每个簇内排序。
常见错误现象：直接对 geom 列用 ORDER BY geom 配合 ROW_NUMBER() OVER (PARTITION BY ...)，结果毫无地理意义，因为 WKB 或 WKT 字符串排序与空间位置完全无关。
- 必须先启用 PostGIS：
CREATE EXTENSION IF NOT EXISTS postgis; -
ST_ClusterDBSCAN()要求输入是GEOMETRY类型且 SRID 明确（推荐 EPSG:4326 以上，但实际计算需转为米制，见下一点） - 参数
eps单位必须与坐标系单位一致；若用 WGS84（SRID=4326），eps=0.001表示约 111 米，易误判——更稳妥做法是先用ST_Transform(geom, 3857)或ST_Transform(geom, 26910)转到投影坐标系再聚类
ST_ClusterDBSCAN + 窗口函数组合的标准写法
典型流程是子查询或 CTE 先生成聚类 ID，外层再按簇分组排序。注意：不能把 ST_ClusterDBSCAN() 放在窗口函数的 PARTITION BY 里——它不是标量函数，不能直接嵌入窗口定义中。
正确结构示例：
PostgreSQL 18.4 官方 Ubuntu 安装包现已发布，这是目前最新的稳定版本。推荐通过官方 APT 仓库安装：先执行 sudo apt update 更新索引，再运行 sudo apt install postgresql-18 即可完成部署。新版本引入了异步 I/O 子系统，在顺序扫描与 VACUUM 场景下性能提升显著，同时支持 UUID v7 原生生成函数与虚拟生成列。
SELECT
id,
geom,
cluster_id,
ROW_NUMBER() OVER (PARTITION BY cluster_id ORDER BY ST_Distance(geom, ST_Point(-73.9857, 40.7484)::geography)) AS rank_in_cluster
FROM (
SELECT
id,
geom,
ST_ClusterDBSCAN(
ST_Transform(geom, 3857),
eps := 100, -- 单位：米（因用了 Web Mercator）
minpoints := 3
) OVER () AS cluster_id
FROM locations
WHERE geom IS NOT NULL
) clustered;-
ST_ClusterDBSCAN(...) OVER ()必须带空窗口定义（OVER ()），否则报错window function requires an OVER clause - 排序依据建议用
ST_Distance(...::geography)（自动按球面距离算）或ST_Distance(ST_Transform(geom, 3857), ...)（平面距离），避免用ST_Distance(geom, ...)在 WGS84 下返回度数 - 若要按某属性（如人口、评分）在簇内排名，把
ORDER BY换成ORDER BY score DESC即可
性能关键：索引和数据预过滤不可省略
ST_ClusterDBSCAN 是全表扫描级操作，无索引加速；若表有千万级点，不加约束会极慢甚至 OOM。
- 务必在
WHERE子句中限制范围：WHERE geom && ST_MakeEnvelope(-74, 40, -73, 41, 4326)（利用geom的 GIST 索引快速初筛） - 确保
geom列有 GIST 索引：CREATE INDEX idx_locations_geom ON locations USING GIST (geom); - 若频繁按区域+聚类分析，考虑物化视图缓存
cluster_id结果，避免每次重算 -
minpoints值越大，簇越稀疏、数量越少；设为 1 会退化成每个点一个簇，失去聚类意义
容易被忽略的 SRID 和精度陷阱
最常踩的坑不是语法，而是空间参考系混乱导致 eps 完全失效：用 WGS84 直接传 eps=100，实际是 100 度——相当于地球周长的几十分之一，所有点被划进一个簇。
- 检查当前几何的 SRID：
SELECT ST_SRID(geom) FROM locations LIMIT 1; - 若为 4326，别手抖直接传
eps=100；要么转投影坐标系，要么换算：eps ≈ 0.0008983（对应 100 米，仅赤道附近近似） -
ST_ClusterDBSCAN返回NULL表示该点为噪声（未被任何簇接纳），后续PARTITION BY cluster_id会把它单独归为一组；如需排除噪声，加WHERE cluster_id IS NOT NULL - 输出的
cluster_id是整数，从 0 开始，-1 表示噪声点（PostGIS ≥ 3.0）
真正卡住人的从来不是窗口函数怎么写，而是没想清楚：聚类是空间运算，排序才是窗口的事——顺序错了，结果就全偏了。
