# LEAD

> StackQL 中的 LEAD 視窗函式：針對分割區中後面的資料列對運算式求值，可選擇指定位移和預設值。

Source: https://stackql.io/zh-hant/language-spec/functions/window/lead

傳回針對分割區中後續資料列對運算式求值的結果。

第一種形式的 `LEAD()` 會傳回針對分割區中下一個資料列對運算式求值的結果。如果沒有下一個資料列（因為目前資料列是最後一個），則傳回 `NULL`。

如果提供 offset 引數，它必須是非負整數。傳回值是針對分割區內目前資料列之後第 *offset* 個資料列對運算式求值的結果。如果 offset 為 0，則針對目前資料列對運算式求值。如果目前資料列之後沒有第 *offset* 個資料列，則傳回 `NULL`。

如果同時提供預設值，當 offset 所指的資料列不存在時，會傳回該預設值而非 `NULL`。

另請參閱：
[[` SELECT `]](/language-spec/select) [[` LAG `]](/language-spec/functions/window/lag)

* * *

## 語法

```sql
SELECT LEAD(expr) OVER ([PARTITION BY column] ORDER BY column) FROM <multipartIdentifier>;

SELECT LEAD(expr, offset) OVER ([PARTITION BY column] ORDER BY column) FROM <multipartIdentifier>;

SELECT LEAD(expr, offset, default) OVER ([PARTITION BY column] ORDER BY column) FROM <multipartIdentifier>;
```

## 引數

__*expr*__
要針對後續資料列求值的運算式。

__*offset*__
選用。非負整數，指定要往後查看多少個資料列。預設為 1。

__*default*__
選用。位移所指的資料列不存在時要傳回的值。預設為 `NULL`。

__*PARTITION BY column*__
選用。將結果集分成多個分割區。`LEAD` 函式會在每個分割區內分別套用。

__*ORDER BY column*__
指定處理資料列的順序。

## 傳回值

傳回運算式針對指定的後續資料列求值的結果；若該資料列不存在，則傳回 `NULL`（或預設值）。

* * *

## 範例

### 預先查看下一個發行版本

```sql
-- Compare each release to previous and next release dates
SELECT
    tag_name,
    name,
    published_at,
    LAG(tag_name, 1) OVER (ORDER BY published_at) as previous_release,
    LEAD(tag_name, 1) OVER (ORDER BY published_at) as next_release
FROM github.repos.releases
WHERE owner = 'stackql'
  AND repo = 'stackql'
ORDER BY published_at;
```

如需詳細資訊，請參閱 [https://sqlite.org/windowfunctions.html#built-in_window_functions](https://sqlite.org/windowfunctions.html#built-in_window_functions)。
