Sdílet prostřednictvím


NTILE (Transact-SQL)

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)databáze SQL v Microsoft Fabric

Distribuuje řádky v uspořádaném oddílu do zadaného počtu skupin. Skupiny jsou očíslované od jedné. Pro každý řádek vrátí číslo skupiny, NTILE do které řádek patří.

Transact-SQL konvence syntaxe

Syntaxe

NTILE (integer_expression) OVER ( [ <partition_by_clause> ] <order_by_clause> )

Arguments

integer_expression

Kladný celočíselná výraz, který určuje počet skupin, do kterých musí být každý oddíl rozdělen. integer_expression může být typu int nebo bigint.

<partition_by_clause>

Rozdělí sadu výsledků vytvořenou klauzulí FROM plus JOIN, APPLY, PIVOT klauzule na oddíly, na které se funkce použije. PARTITION BY Syntaxi najdete v tématu SELECT – OVER – klauzule.

<order_by_clause>

Určuje pořadí, ve kterém NTILE jsou hodnoty přiřazeny k řádkům v oddílu. Celé číslo nemůže představovat sloupec, pokud <se order_by_clause> použije ve funkci řazení.

Návratové typy

bigint

Poznámky

Pokud počet řádků v oddílu není dělitelný podle integer_expression, způsobí to skupiny dvou velikostí, které se liší o jeden člen. Větší skupiny přicházejí před menší skupiny v pořadí určeném klauzulí OVER . Pokud je například celkový počet řádků 53 a počet skupin je pět, první tři skupiny mají 11 řádků a zbývající skupiny mají 10 řádků. Pokud je na druhé straně celkový počet řádků dělitelný počtem skupin, řádky jsou rovnoměrně rozděleny mezi skupiny. Pokud je například celkový počet řádků 50 a existuje pět skupin, každý kbelík obsahuje 10 řádků.

NTILE je nedeterministické. Další informace naleznete v tématu Deterministické a nedeterministické funkce.

Examples

Ukázky kódu v tomto článku používají AdventureWorks2025 ukázkovou databázi, AdventureWorksDW2025 kterou si můžete stáhnout z domovské stránky Ukázky a projekty komunity Microsoft SQL Serveru .

Poznámka:

V následujících příkladech se funkce CONVERT používá k formátování SalesYTD dat jako měny.

A. Rozdělení řádků do skupin

Následující příklad rozdělí řádky do čtyř skupin zaměstnanců na základě jejich ročního prodeje. Vzhledem k tomu, že celkový počet řádků není dělitelný počtem skupin, mají první dvě skupiny čtyři řádky a zbývající skupiny mají každý ze tří řádků.

USE AdventureWorks2022;
GO

SELECT p.FirstName,
       p.LastName,
       NTILE(4) OVER (ORDER BY SalesYTD DESC) AS Quartile,
       CONVERT (NVARCHAR (20), s.SalesYTD, 1) AS SalesYTD,
       a.PostalCode
FROM Sales.SalesPerson AS s
     INNER JOIN Person.Person AS p
         ON s.BusinessEntityID = p.BusinessEntityID
     INNER JOIN Person.Address AS a
         ON a.AddressID = p.BusinessEntityID
WHERE TerritoryID IS NOT NULL
      AND SalesYTD <> 0;
GO

Tady je soubor výsledků.

FirstName      LastName              Quartile  SalesYTD       PostalCode
-------------  --------------------- --------- -------------- ----------
Linda          Mitchell              1         4,251,368.55   98027
Jae            Pak                   1         4,116,871.23   98055
Michael        Blythe                1         3,763,178.18   98027
Jillian        Carson                1         3,189,418.37   98027
Ranjit         Varkey Chudukatil     2         3,121,616.32   98055
José           Saraiva               2         2,604,540.72   98055
Shu            Ito                   2         2,458,535.62   98055
Tsvi           Reiter                2         2,315,185.61   98027
Rachel         Valdez                3         1,827,066.71   98055
Tete           Mensa-Annan           3         1,576,562.20   98055
David          Campbell              3         1,573,012.94   98055
Garrett        Vargas                4         1,453,719.47   98027
Lynn           Tsoflias              4         1,421,810.92   98055
Pamela         Ansman-Wolfe          4         1,352,577.13   98027

B. Rozdělení sady výsledků pomocí funkce PARTITION BY

Následující příklad přidá PARTITION BY argument do kódu v příkladu A. Řádky jsou nejprve rozděleny do PostalCode oddílů a pak rozděleny do čtyř skupin v rámci každého PostalCode. Příklad také deklaruje proměnnou @NTILE_Var a používá ji k určení hodnoty parametru integer_expression .

USE AdventureWorks2022;
GO

DECLARE @NTILE_Var AS INT = 4;

SELECT p.FirstName,
       p.LastName,
       NTILE(@NTILE_Var) OVER (PARTITION BY PostalCode ORDER BY SalesYTD DESC) AS Quartile,
       CONVERT (NVARCHAR (20), s.SalesYTD, 1) AS SalesYTD,
       a.PostalCode
FROM Sales.SalesPerson AS s
     INNER JOIN Person.Person AS p
         ON s.BusinessEntityID = p.BusinessEntityID
     INNER JOIN Person.Address AS a
         ON a.AddressID = p.BusinessEntityID
WHERE TerritoryID IS NOT NULL
      AND SalesYTD <> 0;
GO

Tady je soubor výsledků.

FirstName    LastName             Quartile SalesYTD      PostalCode
------------ -------------------- -------- ------------  ----------
Linda        Mitchell             1        4,251,368.55  98027
Michael      Blythe               1        3,763,178.18  98027
Jillian      Carson               2        3,189,418.37  98027
Tsvi         Reiter               2        2,315,185.61  98027
Garrett      Vargas               3        1,453,719.47  98027
Pamela       Ansman-Wolfe         4        1,352,577.13  98027
Jae          Pak                  1        4,116,871.23  98055
Ranjit       Varkey Chudukatil    1        3,121,616.32  98055
José         Saraiva              2        2,604,540.72  98055
Shu          Ito                  2        2,458,535.62  98055
Rachel       Valdez               3        1,827,066.71  98055
Tete         Mensa-Annan          3        1,576,562.20  98055
David        Campbell             4        1,573,012.94  98055
Lynn         Tsoflias             4        1,421,810.92  98055

Příklady: Azure Synapse Analytics a Analytický platformový systém (PDW)

C. Rozdělení řádků do skupin

Následující příklad používá NTILE funkci k rozdělení sady prodejců do čtyř skupin na základě přiřazené kvóty prodeje pro rok 2003. Vzhledem k tomu, že celkový počet řádků není dělitelný počtem skupin, má první skupina pět řádků a zbývající skupiny mají čtyři řádky.

-- Uses AdventureWorks
SELECT e.LastName,
       NTILE(4) OVER (ORDER BY SUM(SalesAmountQuota) DESC) AS Quartile,
       CONVERT (VARCHAR (13), SUM(SalesAmountQuota), 1) AS SalesQuota
FROM dbo.DimEmployee AS e
     INNER JOIN dbo.FactSalesQuota AS sq
         ON e.EmployeeKey = sq.EmployeeKey
WHERE sq.CalendarYear = 2003
      AND SalesTerritoryKey IS NOT NULL
      AND SalesAmountQuota <> 0
GROUP BY e.LastName
ORDER BY Quartile, e.LastName;

Tady je soubor výsledků.

LastName          Quartile SalesYTD
----------------- -------- ------------
Blythe            1        4,716,000.00
Carson            1        4,350,000.00
Mitchell          1        4,682,000.00
Pak               1        5,142,000.00
Varkey Chudukatil 1        2,940,000.00
Ito               2        2,644,000.00
Saraiva           2        2,293,000.00
Vargas            2        1,617,000.00
Ansman-Wolfe      3        1,183,000.00
Campbell          3        1,438,000.00
Mensa-Annan       3        1,481,000.00
Valdez            3        1,294,000.00
Abbas             4          172,000.00
Albert            4          651,000.00
Jiang             4          544,000.00
Tsoflias          4          867,000.00

D. Rozdělení sady výsledků pomocí funkce PARTITION BY

Následující příklad přidá PARTITION BY argument do kódu v příkladu A. Řádky jsou nejprve rozděleny do SalesTerritoryCountry oddílů a pak rozděleny do dvou skupin v rámci každého SalesTerritoryCountry. V ORDER BY klauzuli OVER se příkazy a NTILEORDER BY příkazy SELECT objednává sadu výsledků.

-- Uses AdventureWorks
SELECT e.LastName,
       NTILE(2) OVER (PARTITION BY e.SalesTerritoryKey ORDER BY SUM(SalesAmountQuota) DESC) AS Quartile,
       CONVERT (VARCHAR (13), SUM(SalesAmountQuota), 1) AS SalesQuota,
       st.SalesTerritoryCountry
FROM dbo.DimEmployee AS e
     INNER JOIN dbo.FactSalesQuota AS sq
         ON e.EmployeeKey = sq.EmployeeKey
     INNER JOIN dbo.DimSalesTerritory AS st
         ON e.SalesTerritoryKey = st.SalesTerritoryKey
WHERE sq.CalendarYear = 2003
GROUP BY e.LastName, e.SalesTerritoryKey, st.SalesTerritoryCountry
ORDER BY st.SalesTerritoryCountry, Quartile;

Tady je soubor výsledků.

LastName          Quartile SalesYTD       SalesTerritoryCountry
----------------- -------- -------------- ------------------
Tsoflias          1           867,000.00   Australia
Saraiva           1         2,293,000.00   Canada
Varkey Chudukatil 1         2,940,000.00   France
Valdez            1         1,294,000.00   Germany
Alberts           1           651,000.00   NA
Jiang             1           544,000.00   NA
Pak               1         5,142,000.00   United Kingdom
Mensa-Annan       1         1,481,000.00   United States
Campbell          1         1,438,000.00   United States
Reiter            1         2,768,000.00   United States
Blythe            1         4,716,000.00   United States
Carson            1         4,350,000.00   United States
Mitchell          1         4,682,000.00   United States
Vargas            2         1,617,000.00   Canada
Abbas             2           172,000.00   NA
Ito               2         2,644,000.00   United States
Ansman-Wolfe      2         1,183,000.00   United States