LAST_VALUE () (Transact-SQL)

[アーティクル]
03/03/2023

適用対象:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) Azure SQL Edge

順序付けられた値のセットで最後の値を返します。

Transact-SQL 構文表記規則

構文

LAST_VALUE ( [ scalar_expression ] )  [ IGNORE NULLS | RESPECT NULLS ]
    OVER ( [ partition_by_clause ] order_by_clause [ rows_range_clause ] )

Note

SQL Server 2014 以前の Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

scalar_expression

返される値。 scalar_expression 列、サブクエリ、または 1 つの値となるその他の式を指定できます。他の分析関数は指定できません。

[ IGNORE NULLS | RESPECT NULLS ]

適用対象: SQL Server (SQL Server 2022 (16.x) 以降)、Azure SQL Database、Azure SQL Managed Instance、Azure SQL Edge

IGNORE NULLS: パーティションの最後の値の計算時に、データセット内の null 値を無視します。

RESPECT NULLS: パーティションの最後の値の計算時に、データセット内の null 値を使用します。

詳細については、欠損値の補完に関する記事を参照してください。

OVER ( [ partition_by_clause ] order_by_clause [ rows_range_clause ] )

partition_by_clause は、FROM 句で生成された結果セットをパーティションに分割します。このパーティションに関数が適用されます。指定しない場合、関数ではクエリ結果セットのすべての行を 1 つのグループとして扱います。

order_by_clause は、関数を適用する前にデータの順序を決定します。 order_by_clause が必要です。

rows_range_clause は始点と終点を指定することによって、パーティション内の行をさらに制限します。

詳細については、OVER 句 (Transact-SQL) に関する記事を参照してください。

戻り値の型

scalar_expression と同じ型。

解説

LAST_VALUE は非決定的です。詳細については、「決定的関数と非決定的関数」を参照してください。

例

A. パーティションで LAST_VALUE を使用する

次の例では、特定の給与 (Rate) について各部門の最後の従業員の採用日を返します。 PARTITION BY 句によって部門ごとに従業員がパーティションに分割され、各パーティションに個別に LAST_VALUE 関数が適用されます。 OVER 句に指定された ORDER BY 句は、各パーティション内の行に LAST_VALUE 関数が適用される論理的な順序を決定します。

USE AdventureWorks2012;
GO
SELECT Department
    , LastName
    , Rate
    , HireDate
    , LAST_VALUE(HireDate) OVER (
        PARTITION BY Department ORDER BY Rate
        ) AS LastValue
FROM HumanResources.vEmployeeDepartmentHistory AS edh
INNER JOIN HumanResources.EmployeePayHistory AS eph
    ON eph.BusinessEntityID = edh.BusinessEntityID
INNER JOIN HumanResources.Employee AS e
    ON e.BusinessEntityID = edh.BusinessEntityID
WHERE Department IN (N'Information Services', N'Document Control');

結果セットは次のとおりです。

Department                  LastName                Rate         HireDate     LastValue
--------------------------- ----------------------- ------------ ----------   ----------
Document Control            Chai                    10.25        2003-02-23   2003-03-13
Document Control            Berge                   10.25        2003-03-13   2003-03-13
Document Control            Norred                  16.8269      2003-04-07   2003-01-17
Document Control            Kharatishvili           16.8269      2003-01-17   2003-01-17
Document Control            Arifin                  17.7885      2003-02-05   2003-02-05
Information Services        Berg                    27.4038      2003-03-20   2003-01-24
Information Services        Meyyappan               27.4038      2003-03-07   2003-01-24
Information Services        Bacon                   27.4038      2003-02-12   2003-01-24
Information Services        Bueno                   27.4038      2003-01-24   2003-01-24
Information Services        Sharma                  32.4519      2003-01-05   2003-03-27
Information Services        Connelly                32.4519      2003-03-27   2003-03-27
Information Services        Ajenstat                38.4615      2003-02-18   2003-02-23
Information Services        Wilson                  38.4615      2003-02-23   2003-02-23
Information Services        Conroy                  39.6635      2003-03-08   2003-03-08
Information Services        Trenary                 50.4808      2003-01-12   2003-01-12

B. 計算された式で FIRST_VALUE と LAST_VALUE を使用する

次の例では、計算された式で FIRST_VALUE 関数と LAST_VALUE 関数を使用して、指定された人数の従業員について、その年の現在の四半期の販売ノルマの値と第 1 四半期および第 4 四半期の販売ノルマの値の差をそれぞれ示します。 FIRST_VALUE 関数は、その年の第 1 四半期の販売ノルマの値を返し、その値を現在の四半期の販売ノルマの値から引きます。そして、その結果を DifferenceFromFirstQuarter という派生列に返します。その年の第 1 四半期については、DifferenceFromFirstQuarter 列の値は 0 です。 LAST_VALUE 関数は、その年の第 4 四半期の販売ノルマの値を返し、その値を現在の四半期の販売ノルマの値から引きます。そして、その結果を DifferenceFromLastQuarter という派生列に返します。その年の第 4 四半期については、DifferenceFromLastQuarter 列の値は 0 です。

以下に示すように、この例の場合、DifferenceFromLastQuarter 列でゼロ以外の値を返すには、"RANGE BETWEEN CURRENT ROW AND UNBOUNDED FOLLOWING" 句が必要です。既定の範囲は RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW です。この例では、この既定の範囲を使用した場合 (または、範囲を含めない結果、既定値が使用される場合)、DifferenceFromLastQuarter 列にゼロが返されます。詳細については、OVER 句 (Transact-SQL) に関する記事を参照してください。

USE AdventureWorks2012;
GO
SELECT BusinessEntityID
    , DATEPART(QUARTER, QuotaDate) AS Quarter
    , YEAR(QuotaDate) AS SalesYear
    , SalesQuota AS QuotaThisQuarter
    , SalesQuota - FIRST_VALUE(SalesQuota)
          OVER (PARTITION BY BusinessEntityID, YEAR(QuotaDate)
              ORDER BY DATEPART(QUARTER, QuotaDate)) AS DifferenceFromFirstQuarter
    , SalesQuota - LAST_VALUE(SalesQuota)
          OVER (PARTITION BY BusinessEntityID, YEAR(QuotaDate)
              ORDER BY DATEPART(QUARTER, QuotaDate)
              RANGE BETWEEN CURRENT ROW AND UNBOUNDED FOLLOWING) AS DifferenceFromLastQuarter
FROM Sales.SalesPersonQuotaHistory
WHERE YEAR(QuotaDate) > 2005 AND BusinessEntityID BETWEEN 274 AND 275
ORDER BY BusinessEntityID, SalesYear, Quarter;