文档首页/ 云数据库 GaussDB/ 开发指南（分布式_V2.0-8.x）/ SQL参考/ 伪列

更新时间：2026-02-06 GMT+08:00

查看PDF

伪列

ROWNUM是一个伪列，它返回一个数字，表示从查询中获取结果的行编号。第一行的ROWNUM为1，第二行的为2，依此类推，使用ROWNUM来限制查询返回的行数。

ROWNUM机制介绍：

赋值时机：ROWNUM是在查询结果集产生过程中动态分配的，是在查询获取到结果集之后再加上去的一个伪列。这意味着序号是在数据被WHERE子句过滤后，但在任何ORDER BY排序之前就确定了。

比较操作符使用：ROWNUM<=n（n大于1）是有效的，常用语限制返回的行数，例如获取前N条记录。如以下示例所示：

     
      
        
        
          gaussdb=# CREATE TABLE Students (name varchar(20), id int) WITH (STORAGE_TYPE = USTORE);
gaussdb=# INSERT INTO Students VALUES ('Jack', 35);
gaussdb=# INSERT INTO Students VALUES ('Leon', 15);
gaussdb=# INSERT INTO Students VALUES ('James', 24);
gaussdb=# INSERT INTO Students VALUES ('Taker', 81);
gaussdb=# INSERT INTO Students VALUES ('Mary', 25);
gaussdb=# INSERT INTO Students VALUES ('Rose', 64);
gaussdb=# INSERT INTO Students VALUES ('Perl', 18);
gaussdb=# INSERT INTO Students VALUES ('Under', 57);
gaussdb=# INSERT INTO Students VALUES ('Angel', 101);
gaussdb=# INSERT INTO Students VALUES ('Frank', 20);
gaussdb=# INSERT INTO Students VALUES ('Charlie', 40);
gaussdb=# SELECT * FROM Students WHERE rownum <= 10; -- 输出表Students前10行数据
 name  | id  
-------+-----
 Jack  |  35
 Leon  |  15
 James |  24
 Taker |  81
 Mary  |  25
 Rose  |  64
 Perl  |  18
 Under |  57
 Angel | 101
 Frank |  20
(10 rows)

         

       

     
    

ROWNUM = 1 是有效的，可以查询出第一条记录。
```
gaussdb=# SELECT * FROM Students WHERE rownum = 1;
 name | id
------+----
 Jack | 35
(1 row)
```
ROWNUM = n（当n > 1）、ROWNUM > n（n >= 1）或 ROWNUM >= n（n > 1）这些条件结果永远为FALSE，不会返回任何行。这是因为第一条取到的行分配ROWNUM=1，如果它不满足条件（例如 ROWNUM > 1），则会被丢弃；接着处理下一条记录，它又成为了新的“第一条”记录，ROWNUM再次被赋值为1，如此循环，所有行都无法满足条件。
```
gaussdb=# SELECT * FROM Students WHERE rownum > 1;
 name | id
------+----
(0 rows)
```

ROWNUM的基本使用

限制返回行数

gaussdb=# SELECT * FROM Students WHERE rownum <= 2;
 name | id
------+----
 Jack | 35
 Leon | 15
(2 rows)

实现分页查询：由于不能直接使用ROWNUM > n，分页查询需要通过子查询为ROWNUM创建一个别名（例如rn），使其成为一个“固定”的列，然后在外层查询中基于这个别名进行范围筛选。

gaussdb=# SELECT *
FROM (SELECT a.*, ROWNUM AS rn
      FROM 
      (SELECT * FROM Students ORDER BY id DESC) a -- 内层子查询先排序
      WHERE ROWNUM <= 10) -- 中层子查询限定上限并生成ROWNUM别名
WHERE rn >= 5;
  name   | id | rn
---------+----+----
 Charlie | 40 |  5
 Jack    | 35 |  6
 Mary    | 25 |  7
 James   | 24 |  8
 Frank   | 20 |  9
 Perl    | 18 | 10
(6 rows)

排序后的前N条数据：如果直接在同级查询中同时使用WHERE ROWNUM <= N和 ORDER BY，可能会得到不正确的结果，应为ROWNUM在排序前就已分配。正确方法时使用子查询先排序，后分配ROWNUM：

     
          gaussdb=# SELECT rownum, * FROM (SELECT * FROM Students order by 1) WHERE rownum <= 2;
 rownum |  name   | id
--------+---------+-----
      1 | Angel   | 101
      2 | Charlie |  40
(2 rows)

使用ROWNUM指定给表的一定范围的每一行分配值：

     
      
        
        
          gaussdb=# SELECT * FROM Students;
  name   | id
---------+-----
 Jack    |  35
 Leon    |  15
 James   |  24
 Taker   |  81
 Mary    |  25
 Rose    |  64
 Perl    |  18
 Under   |  57
 Angel   | 101
 Frank   |  20
 Charlie |  40
(11 rows)

gaussdb=# UPDATE Students SET id = id + 5 WHERE rownum < 4;
UPDATE 3
gaussdb=# SELECT * FROM Students;
  name   | id
---------+-----
 Jack    |  40
 Leon    |  20
 James   |  29
 Taker   |  81
 Mary    |  25
 Rose    |  64
 Perl    |  18
 Under   |  57
 Angel   | 101
 Frank   |  20
 Charlie |  40
(11 rows)

gaussdb=# DROP TABLE Students;
DROP TABLE

         

       

     
    

使用ROWNUM有一定的约束条件：

ROWNUM不可作为别名，以免SQL语句出现歧义。
创建索引时不可使用ROWNUM。
创建表时默认值不可为ROWNUM。
Where子句中不可使用ROWNUM的别名。
在插入数据时不可使用ROWNUM。
在无表查询中不可以使用ROWNUM。
ROWNUM不能用于Limit子句。
ROWNUM不能用于EXECUTE语句的参数。
UPSERT语句不支持ROWNUM用做update子句更新。
SELECT ... FOR UPDATE语句不支持ROWNUM用作投影列和WHERE条件。
若having子句中含有ROWNUM（且不在聚合函数中）时，group by子句中必须含有ROWNUM（且不在聚合函数中），除非group by子句存在表达式，例如：SELECT a + a FROM t group by a + a having rownum < 5。

having子句中如果存在ROWNUM条件则不允许having子句下推至扫描节点：

      
       
         
         
           gaussdb=# CREATE TABLE test (a int, b int);
NOTICE:  The 'DISTRIBUTE BY' clause is not specified. Using 'a' as the distribution column by default.
HINT:  Please use 'DISTRIBUTE BY' clause to specify suitable data distribution column.
CREATE TABLE
gaussdb=# INSERT INTO test SELECT generate_series, generate_series FROM generate_series(1, 10);
INSERT 0 10

--rownum条件不能下推至seqscan。
gaussdb=# EXPLAIN SELECT a,rownum FROM test group by a,rownum having rownum < 5; 
                               QUERY PLAN                                
-------------------------------------------------------------------------
 HashAggregate  (cost=3.45..3.49 rows=3 width=4)
   Group By Key: a, ROWNUM
   Filter: ((ROWNUM) < 5::numeric)
   ->  Rownum  (cost=0.19..3.40 rows=10 width=4)
         ->  Streaming (type: GATHER)  (cost=0.19..3.40 rows=10 width=4)
               Node/s: All datanodes
               ->  Seq Scan on test  (cost=0.00..3.03 rows=10 width=4)
(7 rows)                         

          

        

      
     

子查询中如果存在ROWNUM条件则不允许谓词下推至扫描节点：

      
           gaussdb=# EXPLAIN SELECT * FROM (SELECT * FROM test WHERE rownum < 5) WHERE b < 5; -- b<5 不能下推至seqscan
                                    QUERY PLAN                                     
-----------------------------------------------------------------------------------
 Streaming (type: GATHER)  (cost=0.06..0.63 rows=2 width=8)
   Node/s: All datanodes
   ->  Subquery Scan on __unnamed_subquery__  (cost=0.00..0.50 rows=2 width=8)
         Filter: (__unnamed_subquery__.b < 5)
         ->  Rownum  (cost=0.00..0.45 rows=4 width=8)
               StopKey: (ROWNUM < 5::numeric)
               ->  Streaming(type: BROADCAST)  (cost=0.00..1.36 rows=12 width=8)
                     Spawn on: All datanodes
                     ->  Rownum  (cost=0.00..1.35 rows=4 width=8)
                           StopKey: (ROWNUM < 5::numeric)
                           ->  Seq Scan on test  (cost=0.00..3.03 rows=10 width=8)
(11 rows)

gaussdb=# DROP TABLE test;
DROP TABLE

ROWNUM查询结果将会由于CN接收DN数据的顺序不同导致查询结果不稳定。

        
         
           
           
             gaussdb=# CREATE TABLE test(a int, b int);
gaussdb=# INSERT INTO test VALUES(generate_series(1,10),generate_series(1,10));

--CN先收到DN1数据再收到DN2数据。
gaussdb=# SELECT rownum,* FROM test; 
 rownum | a  | b  
--------+----+----
      1 |  1 |  1
      2 |  2 |  2
      3 |  5 |  5
      4 |  6 |  6
      5 |  8 |  8
      6 |  9 |  9
      7 |  3 |  3
      8 |  4 |  4
      9 |  7 |  7
     10 | 10 | 10
(10 rows)

--CN先收到DN2数据再收到DN1数据。
gaussdb=# SELECT rownum,* FROM test; 
 rownum | a  | b  
--------+----+----
      1 |  3 |  3
      2 |  4 |  4
      3 |  7 |  7
      4 | 10 | 10
      5 |  1 |  1
      6 |  2 |  2
      7 |  5 |  5
      8 |  6 |  6
      9 |  8 |  8
     10 |  9 |  9
(10 rows)

            

          

        
       

不推荐ROWNUM条件用于JOIN ON子句，GaussDB中ROWNUM条件用于JOIN ON子句时在LEFT JOIN、RIGHT JOIN、FULL JOIN场景下和MERGE INTO场景下与其他数据库行为不一致，直接进行业务迁移存在风险。

当父查询中有rownum限制条件同时子查询的投影列中有rownum时，该限制条件将下推至子查询。其中约束条件如下：

只有父查询rownum限制条件为“<”、“<=”、“=”，且子查询直接用rownum作为伪列时，才可以下推。
父查询中有多个对子查询中rownum的过滤条件并且满足下推要求时，按顺序仅下推第一个过滤条件。
当子查询中包括volatile函数、存储过程时不能下推。

父主题： SQL参考

上一篇：时间间隔表达式

下一篇：类型转换

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

伪列

相关文档

意见反馈

文档内容是否对您有帮助？