全部產品
Search
文件中心

MaxCompute:NTH_VALUE

更新時間:Feb 28, 2024

取當前行所對應視窗的第N條資料的值。

使用限制

視窗函數的使用限制如下:

  • 視窗函數只能出現在select語句中。

  • 視窗函數中不能嵌套使用視窗函數和彙總函式。

  • 視窗函數不能和同層級的彙總函式一起使用。

命令格式

nth_value(<expr>, <number> [, <ignore_nulls>]) over ([partition_clause] [orderby_clause] [frame_clause])

命令說明

返回運算式expr在視窗的第N條資料進行運算的結果。

參數說明

  • expr:必填。待計算返回結果的運算式。

  • number:必填。BIGINT類型。大於等於1的整數。值為1時與FIRST_VALUE等價。

  • ignore_nulls:可選。BOOLEAN類型。表示是否忽略NULL值。預設值為False。當參數的值為True時,返回視窗中第N條非NULL的expr值。

  • partition_clauseorderby_clauseframe_clause:詳情請參見windowing_definition

傳回值說明

傳回值類型同expr類型。

樣本資料

為便於理解各函數的使用方法,本文為您提供來源資料,基於來源資料提供函數相關樣本。建立表emp,並添加資料,命令樣本如下:

create table if not exists emp
   (empno bigint,
    ename string,
    job string,
    mgr bigint,
    hiredate datetime,
    sal bigint,
    comm bigint,
    deptno bigint);
tunnel upload emp.txt emp;   --請根據您上傳資料檔案的實際path(路徑以及名稱)替換emp.txt

emp.txt中的資料如下:

7369,SMITH,CLERK,7902,1980-12-17 00:00:00,800,,20
7499,ALLEN,SALESMAN,7698,1981-02-20 00:00:00,1600,300,30
7521,WARD,SALESMAN,7698,1981-02-22 00:00:00,1250,500,30
7566,JONES,MANAGER,7839,1981-04-02 00:00:00,2975,,20
7654,MARTIN,SALESMAN,7698,1981-09-28 00:00:00,1250,1400,30
7698,BLAKE,MANAGER,7839,1981-05-01 00:00:00,2850,,30
7782,CLARK,MANAGER,7839,1981-06-09 00:00:00,2450,,10
7788,SCOTT,ANALYST,7566,1987-04-19 00:00:00,3000,,20
7839,KING,PRESIDENT,,1981-11-17 00:00:00,5000,,10
7844,TURNER,SALESMAN,7698,1981-09-08 00:00:00,1500,0,30
7876,ADAMS,CLERK,7788,1987-05-23 00:00:00,1100,,20
7900,JAMES,CLERK,7698,1981-12-03 00:00:00,950,,30
7902,FORD,ANALYST,7566,1981-12-03 00:00:00,3000,,20
7934,MILLER,CLERK,7782,1982-01-23 00:00:00,1300,,10
7948,JACCKA,CLERK,7782,1981-04-12 00:00:00,5000,,10
7956,WELAN,CLERK,7649,1982-07-20 00:00:00,2450,,10
7956,TEBAGE,CLERK,7748,1982-12-30 00:00:00,1300,,10

樣本

將所有職工根據部門分組,返回每組中的第6行資料。命令樣本如下:

  • 不指定order by,當前視窗為第一行到最後一行的範圍,返回當前視窗第6行的值。

    select deptno, ename, sal, nth_value(sal,6) over (partition by deptno) as nth_value from emp;

    返回結果如下:

    +------------+------------+------------+------------+
    | deptno     | ename      | sal        | nth_value  |
    +------------+------------+------------+------------+
    | 10         | TEBAGE     | 1300       | 2450       |
    | 10         | CLARK      | 2450       | 2450       |
    | 10         | KING       | 5000       | 2450       |
    | 10         | MILLER     | 1300       | 2450       |
    | 10         | JACCKA     | 5000       | 2450       |
    | 10         | WELAN      | 2450       | 2450       |   --當前視窗的第6行。
    | 20         | FORD       | 3000       | NULL       |
    | 20         | SCOTT      | 3000       | NULL       |
    | 20         | SMITH      | 800        | NULL       |
    | 20         | ADAMS      | 1100       | NULL       |
    | 20         | JONES      | 2975       | NULL       |   --當前視窗的沒有第6行,返回NULL。
    | 30         | TURNER     | 1500       | 2850       |
    | 30         | JAMES      | 950        | 2850       |
    | 30         | ALLEN      | 1600       | 2850       |
    | 30         | WARD       | 1250       | 2850       |
    | 30         | MARTIN     | 1250       | 2850       |
    | 30         | BLAKE      | 2850       | 2850       |   --當前視窗的第6行。
    +------------+------------+------------+------------+
  • 指定order by,當前視窗為第一行到當前行的範圍,返回當前視窗第6行的值。

    select deptno, ename, sal, nth_value(sal,6) over (partition by deptno order by sal) as nth_value from emp;

    返回結果如下:

    +------------+------------+------------+------------+
    | deptno     | ename      | sal        | nth_value  |
    +------------+------------+------------+------------+
    | 10         | TEBAGE     | 1300       | NULL       |   
    | 10         | MILLER     | 1300       | NULL       |   --當前視窗只有2行,第6行超過了視窗長度。
    | 10         | CLARK      | 2450       | NULL       |
    | 10         | WELAN      | 2450       | NULL       |
    | 10         | KING       | 5000       | 5000       |  
    | 10         | JACCKA     | 5000       | 5000       |
    | 20         | SMITH      | 800        | NULL       |
    | 20         | ADAMS      | 1100       | NULL       |
    | 20         | JONES      | 2975       | NULL       |
    | 20         | SCOTT      | 3000       | NULL       |
    | 20         | FORD       | 3000       | NULL       |
    | 30         | JAMES      | 950        | NULL       |
    | 30         | MARTIN     | 1250       | NULL       |
    | 30         | WARD       | 1250       | NULL       |
    | 30         | TURNER     | 1500       | NULL       |
    | 30         | ALLEN      | 1600       | NULL       |
    | 30         | BLAKE      | 2850       | 2850       |
    +------------+------------+------------+------------+

相關函數

NTH_VALUE函數屬於視窗函數,更多對指定開窗列的資料進行求和、數值排序的相關函數請參見視窗函數