Snowflake表转换查询报错Single-row subquery returns more than one row

报错根因 #

Single-row subquery returns more than one row是SQL通用错误，触发条件是写在SELECT子句中的标量子查询，在匹配外层某一行数据时返回了超过1条记录。标量子查询的返回要求是单行单列，只要返回行数>1就会直接抛出这个错误。

问题定位 #

你给出的SQL中包含两个SELECT列表内的标量子查询，两个都存在触发报错的逻辑问题：

• 别名DOCUMENT_ID的子查询：没有和外层主表USERS_L.JOB_MASTER做任何关联，窗口函数分区键写的是DD.DOCUMENT_ID，会把所有row_number=1的DOCUMENT_ID全量返回，只要表中数据多于1条就会触发报错。
• 别名REPAIRED_BY的子查询：既没有和外层主表做关联，也没有做行数限制，会直接返回SFL.RCS_USER和SMW.RCS_STATUS关联后的全量USERNAME，必然触发多行返回错误。

修复逻辑 #

1. 所有放在SELECT子句里的标量子查询，必须和外层主表通过业务主键（这里是JOB_ID）做关联，保证外层每一行JOB数据匹配时，子查询的筛选范围只对应当前JOB下的记录。
2. 窗口函数取Top1的逻辑，分区键必须和关联键对齐（按JOB_ID分区，而不是DOCUMENT_ID），同时要补充有业务意义的排序字段（比如创建时间、更新时间倒序取最新记录），不要用DOCUMENT_ID排序，否则取数逻辑无意义。
3. 如果业务上确实存在一个JOB对应多条匹配记录的场景，必须明确取数规则，通过窗口函数、聚合函数或者LIMIT 1保证子查询最终只返回1行。

参考修正SQL #

注意：SQL中涉及REPAIRED_BY的关联字段、排序字段需要替换成你实际业务表的对应字段。

SELECT DISTINCT 
    J.JOB_ID, 
    J.ACCEPTED_DATE,
    -- 按JOB关联取对应1条DOCUMENT_ID
    (
        SELECT DD.DOCUMENT_ID 
        FROM SFG.RCM_JOB_INDUSTRY DD
        WHERE DD.JOB_ID = J.JOB_ID
        -- Snowflake支持QUALIFY直接过滤窗口结果，无需嵌套子查询
        QUALIFY row_number() OVER (PARTITION BY DD.JOB_ID ORDER BY DD.CREATE_TIME DESC) = 1
    ) AS DOCUMENT_ID,
    -- 按JOB关联取对应处理人
    (
        SELECT U.USERNAME 
        FROM SFL.RCS_USER U 
        LEFT JOIN SMW.RCS_STATUS RS ON RS.USER_ID = U.USER_ID
        -- 此处替换成你实际业务中RCS_STATUS和JOB_MASTER的关联字段
        WHERE RS.JOB_ID = J.JOB_ID
        QUALIFY row_number() OVER (PARTITION BY RS.JOB_ID ORDER BY RS.OPERATE_TIME DESC) = 1
    ) AS REPAIRED_BY
FROM USERS_L.JOB_MASTER J;

快速排查方法 #

• 单独执行每个标量子查询，不关联外层表，如果直接执行就返回超过1行，说明子查询本身缺少去重/行数限制逻辑。
• 如果单独执行子查询只返回1行，放入主查询后报错，说明子查询和外层主表的关联条件缺失，导致产生笛卡尔积放大了返回行数。
• 可以先给子查询临时加LIMIT 1验证是否是行数问题，确认后再补全正确的关联和取数逻辑，不要直接加LIMIT 1上线，会导致取数错误。

内容的提问来源于stack exchange，提问作者Snyder Fox