类别：

:doc:`/sql-reference/functions-window-syntax`（排名）

LEAD

访问同一结果集中后续行中的数据，而无需将表联结到该数据。

另请参阅：

LAG

语法

LEAD ( <expr> [ , <offset> , <default> ] ) [ { IGNORE | RESPECT } NULLS ]
  OVER ( [ PARTITION BY <expr1> ] ORDER BY <expr2> [ { ASC | DESC } ] [ NULLS { FIRST | LAST } ] )

实参

expr

要返回的字符串表达式。

offset

从可从中获取值的当前行向前排列行数。例如，若 offset 为 2，会返回间隔为 2 行的 expr 值。

请注意，使用 LAG 函数来设置负偏移量具有相同的效果。

默认值为 1。如果指定 IGNORE NULLS，则最大值为 1,000,000。

default

当偏移量超出窗口边界时要返回的表达式。支持其类型与 expr 兼容的任何表达式。

默认值为 NULL。

{ IGNORE | RESPECT } NULLS

当 expr 包含 NULL 值时，是忽略还是遵照 NULL 值：

  • IGNORE NULLS 排除计算偏移行时其表达式计算结果为 NULL 的任何行。

  • RESPECT NULLS 包括计算偏移行时其表达式计算结果为 NULL 的任何行。

默认值：RESPECT NULLS

使用说明

  • 此 PARTITION BY 子句将 FROM 子句生成的结果集划分入应用该函数的分区。有关更多信息，请参阅 窗口函数的语法和用法。

  • 此 ORDER BY 子句对每个分区中的数据进行排序。

示例

CREATE OR REPLACE TABLE sales(
  emp_id INTEGER,
  year INTEGER,
  revenue DECIMAL(10,2));

INSERT INTO sales VALUES
  (0, 2010, 1000),
  (0, 2011, 1500),
  (0, 2012, 500),
  (0, 2013, 750);
INSERT INTO sales VALUES
  (1, 2010, 10000),
  (1, 2011, 12500),
  (1, 2012, 15000),
  (1, 2013, 20000);
INSERT INTO sales VALUES
  (2, 2012, 500),
  (2, 2013, 800);

SELECT emp_id,
       year,
       revenue,
       LEAD(revenue) OVER (PARTITION BY emp_id ORDER BY year) - revenue AS diff_to_next
  FROM sales
  ORDER BY emp_id, year;

+--------+------+----------+--------------+
| EMP_ID | YEAR |  REVENUE | DIFF_TO_NEXT |
|--------+------+----------+--------------|
|      0 | 2010 |  1000.00 |       500.00 |
|      0 | 2011 |  1500.00 |     -1000.00 |
|      0 | 2012 |   500.00 |       250.00 |
|      0 | 2013 |   750.00 |         NULL |
|      1 | 2010 | 10000.00 |      2500.00 |
|      1 | 2011 | 12500.00 |      2500.00 |
|      1 | 2012 | 15000.00 |      5000.00 |
|      1 | 2013 | 20000.00 |         NULL |
|      2 | 2012 |   500.00 |       300.00 |
|      2 | 2013 |   800.00 |         NULL |
+--------+------+----------+--------------+

CREATE OR REPLACE TABLE t1 (
  c1 NUMBER,
  c2 NUMBER);

INSERT INTO t1 VALUES
  (1,5),
  (2,4),
  (3,NULL),
  (4,2),
  (5,NULL),
  (6,NULL),
  (7,6);

SELECT c1,
       c2,
       LEAD(c2) IGNORE NULLS OVER (ORDER BY c1)
  FROM t1;

+----+------+------------------------------------------+
| C1 | C2   | LEAD(C2) IGNORE NULLS OVER (ORDER BY C1) |
|----+------+------------------------------------------|
|  1 |  5   |                                        4 |
|  2 |  4   |                                        2 |
|  3 | NULL |                                        2 |
|  4 |  2   |                                        6 |
|  5 | NULL |                                        6 |
|  6 | NULL |                                        6 |
|  7 |  6   |                                     NULL |
+----+------+------------------------------------------+