TOP (Transact-SQL)

Articolo
05/23/2023

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW) Endpoint di analisi SQL in Microsoft Fabric Warehouse in Microsoft Fabric

Limita le righe restituite nel set di risultati di una query a un numero specificato o a una percentuale di righe in SQL Server. Quando si usa TOP con la clausola ORDER BY, il set di risultati è limitato alle prime N righe ordinate. In caso contrario, TOP restituisce le prime N righe in un ordine non definito. Usare questa clausola per specificare il numero di righe restituito da un'istruzione SELECT. In alternativa, usare TOP per specificare le righe interessate da un'istruzione INSERT, UPDATE, MERGE o DELETE.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

Di seguito è riportata la sintassi per SQL Server e il database SQL di Azure:

[   
    TOP (expression) [PERCENT]  
    [ WITH TIES ]  
]

Di seguito è riportata la sintassi per Azure Synapse Analytics e Piattaforma di strumenti analitici (PDW):

[   
    TOP ( expression )   
    [ WITH TIES ]  
]

Argomenti

expression
Espressione numerica che specifica il numero di righe da restituire. Se si specifica PERCENT, viene eseguita la conversione implicita di expression in un valore float. In caso contrario, l'argomento expression viene convertito in bigint.

PERCENT
Indica che la query restituisce solo la prima percentuale expression di righe dal set di risultati. I valori frazionari vengono arrotondati al valore intero più vicino.

WITH TIES
Restituisce due o più righe con valori equivalenti per l'ultima posizione del set di risultati limitato. È necessario usare questo argomento con la clausola ORDER BY. WITH TIES potrebbe causare la restituzione di un numero di righe maggiore rispetto al valore specificato in expression. Se l'argomento expression è impostato su 5 ma ai valori delle colonne ORDER BY nella riga 5 corrispondono due righe in più, ad esempio, il set di risultati conterrà sette righe.

È possibile specificare la clausola TOP con l'argomento WITH TIES solo nelle istruzioni SELECT e solo se viene usata anche la clausola ORDER BY. L'ordine restituito per l'associazione dei record è arbitrario. ORDER BY non influisce su questa regola.

Consigli per iniziare

In un'istruzione SELECT utilizzare sempre una clausola ORDER BY con la clausola TOP. È infatti l'unico modo per indicare in modo prevedibile le righe interessate dalla clausola TOP.

Utilizzare OFFSET e FETCH nella clausola ORDER BY anziché la clausola TOP per implementare una soluzione di paging delle query. Una soluzione di paging, ovvero l'invio di blocchi o "pagine" di dati al client, è di più facile implementazione con le clausole OFFSET e FETCH. Per altre informazioni, vedere Clausola ORDER BY (Transact-SQL).

Utilizzare TOP (o OFFSET e FETCH) anziché SET ROWCOUNT per limitare il numero di righe restituite. Questi metodi vengono preferiti all'utilizzo di SET ROWCOUNT per i motivi seguenti:

Come parte di un'istruzione SELECT, in Query Optimizer il valore di expression nella clausola TOP o FETCH può essere preso in considerazione durante l'ottimizzazione della query. Dato che si usa SET ROWCOUNT al di fuori di un'istruzione che esegue una query, il relativo valore non può essere considerato in un piano di query.

Informazioni sulla compatibilità

Per la compatibilità con le versioni precedenti, le parentesi sono facoltative nelle istruzioni SELECT se l'espressione è una costante integer. È consigliabile usare sempre le parentesi per TOP nelle istruzioni SELECT, in modo da mantenere la coerenza con l'uso obbligatorio nelle istruzioni INSERT, UPDATE, MERGE e DELETE.

Interoperabilità

L'espressione di TOP non influisce sulle istruzioni eventualmente eseguite a causa di un trigger. Le tabelle inserted e deleted nei trigger restituiscono solo le righe effettivamente interessate dalle istruzioni INSERT, UPDATE, MERGE o DELETE. Questo si verifica ad esempio se un trigger INSERT viene attivato come risultato di un'istruzione INSERT in cui è stata usata una clausola TOP.

Piattaforma di strumenti analitici consente l'aggiornamento delle righe attraverso le viste. Dato che è possibile includere la clausola TOP nella definizione della vista, alcune righe potrebbero non essere più presenti nella vista se a causa di un aggiornamento non soddisfano più i requisiti dell'espressione di TOP.

Quando viene specificata nell'istruzione MERGE, la clausola TOP si applica dopo l'unione in join dell'intera tabella di origine e dell'intera tabella di destinazione. Le righe unite in join non qualificate per un'azione di inserimento, aggiornamento o eliminazione, inoltre, vengono rimosse. La clausola TOP riduce ulteriormente il numero di righe unite in join in base al valore specificato e l'azione di inserimento, aggiornamento o eliminazione si applica alle restanti righe unite in join in modo non ordinato. Ciò significa che le righe vengono distribuite tra le azioni definite nelle clausole WHEN senza alcun ordine. Se specificando TOP (10) le righe interessate sono 10, ad esempio, sette di queste righe potrebbero essere aggiornate e tre inserite oppure una potrebbe essere eliminata, cinque aggiornate e quattro inserite e così via. Dato che l'istruzione MERGE esegue una scansione di tabella completa sulle tabelle sia di origine che di destinazione, l'uso della clausola TOP per modificare una tabella di grandi dimensioni creando più batch può influire sulle prestazioni di I/O. In questo scenario è importante assicurarsi che tutti i batch successivi abbiano come destinazione nuove righe.

Prestare attenzione quando si specifica la clausola TOP in una query contenente un operatore UNION, UNION ALL, EXCEPT o INTERSECT. È possibile scrivere una query che restituisce risultati imprevisti perché l'ordine in cui le clausole TOP e ORDER BY vengono elaborate logicamente non è sempre intuitivo quando questi operatori vengono usati in un'operazione di selezione. Ad esempio, considerati i dati e la tabella seguenti, si supponga di voler ottenere come risultato la macchina rossa meno costosa e la macchina blu più costosa, ovvero la berlina rossa e il furgone blu.

CREATE TABLE dbo.Cars(Model VARCHAR(15), Price MONEY, Color VARCHAR(10));  
INSERT dbo.Cars VALUES  
    ('sedan', 10000, 'red'), ('convertible', 15000, 'blue'),   
    ('coupe', 20000, 'red'), ('van', 8000, 'blue');

Per ottenere questi risultati, è possibile scrivere la query seguente.

SELECT TOP(1) Model, Color, Price  
FROM dbo.Cars  
WHERE Color = 'red'  
UNION ALL  
SELECT TOP(1) Model, Color, Price  
FROM dbo.Cars  
WHERE Color = 'blue'  
ORDER BY Price ASC;  
GO

Di seguito è riportato il set di risultati.

Model         Color      Price  
------------- ---------- -------  
sedan         red        10000.00  
convertible   blue       15000.00

Vengono restituiti risultati imprevisti perché la clausola TOP viene eseguita logicamente prima della clausola ORDER BY che ordina i risultati dell'operatore (in questo caso UNION ALL). La query precedente restituisce pertanto qualsiasi macchina rossa e qualsiasi macchina blu e quindi ordina il risultato dell'unione in base al prezzo. Nell'esempio seguente viene illustrato il metodo corretto per scrivere questa query per ottenere il risultato desiderato.

SELECT Model, Color, Price  
FROM (SELECT TOP(1) Model, Color, Price  
      FROM dbo.Cars  
      WHERE Color = 'red'  
      ORDER BY Price ASC) AS a  
UNION ALL  
SELECT Model, Color, Price  
FROM (SELECT TOP(1) Model, Color, Price  
      FROM dbo.Cars  
      WHERE Color = 'blue'  
      ORDER BY Price ASC) AS b;  
GO

L'uso di TOP e ORDER BY in un'operazione sub-SELECT assicura che i risultati della clausola ORDER BY vengano applicati alla clausola TOP e non all'ordinamento del risultato dell'operazione UNION.

Questo è il set di risultati.

Model         Color      Price  
------------- ---------- -------  
sedan         red        10000.00  
van           blue        8000.00

Limitazioni e restrizioni

Quando si usa TOP con INSERT, UPDATE, MERGE o DELETE, le righe a cui viene fatto riferimento non vengono disposte in alcun ordine e non è possibile specificare direttamente la clausola ORDER BY in queste istruzioni. Se è necessario usare TOP per inserire, eliminare o modificare righe in un ordine cronologico significativo, usare TOP specificando una clausola ORDER BY in un'istruzione sub-SELECT. Vedere la successiva sezione Esempi di questo articolo.

Non è possibile usare TOP in istruzioni UPDATE e DELETE su viste partizionate.

Non è possibile combinare TOP con OFFSET e FETCH nella stessa espressione di query (nello stesso ambito query). Per altre informazioni, vedere Clausola ORDER BY (Transact-SQL).

Esempi

Categoria	Elementi di sintassi inclusi
Sintassi di base	TOP * PERCENT
Inclusione di valori equivalenti	WITH TIES
Limitazione delle righe interessate da DELETE, INSERT o UPDATE	DELETE * INSERT * UPDATE

Sintassi di base

Negli esempi contenuti in questa sezione vengono illustrate le funzionalità di base della clausola ORDER BY utilizzando la sintassi minima necessaria.

R. Utilizzo di TOP con un valore costante

Negli esempi seguenti viene utilizzato un valore costante per specificare il numero di dipendenti restituiti nel set di risultati della query. Nel primo esempio vengono restituite le prime 10 righe non definite perché non viene usata una clausola ORDER BY. Nel secondo esempio viene utilizzata una clausola ORDER BY per restituire i primi 10 dipendenti assunti di recente.

USE AdventureWorks2022;  
GO  
-- Select the first 10 random employees.  
SELECT TOP(10)JobTitle, HireDate  
FROM HumanResources.Employee;  
GO  
-- Select the first 10 employees hired most recently.  
SELECT TOP(10)JobTitle, HireDate  
FROM HumanResources.Employee  
ORDER BY HireDate DESC;  
GO

B. Utilizzo di TOP con una variabile

Nell'esempio seguente viene utilizzata una variabile per specificare il numero di dipendenti restituiti nel set di risultati della query.

USE AdventureWorks2022;  
GO  
DECLARE @p AS INT = 10;  
SELECT TOP(@p)JobTitle, HireDate, VacationHours  
FROM HumanResources.Employee  
ORDER BY VacationHours DESC;  
GO

C. Specifica di una percentuale

Nell'esempio seguente viene utilizzato PERCENT per specificare il numero di dipendenti restituiti nel set di risultati della query. Nella tabella HumanResources.Employee sono presenti 290 dipendenti. Dato che il 5% di 290 è un valore frazionario, il valore viene arrotondato al numero intero successivo.

USE AdventureWorks2022;  
GO  
SELECT TOP(5)PERCENT JobTitle, HireDate  
FROM HumanResources.Employee  
ORDER BY HireDate DESC;  
GO

Inclusione di valori equivalenti

R. Utilizzo di WITH TIES per includere righe corrispondenti ai valori nell'ultima riga

L'esempio seguente recupera il primo 10% di tutti i dipendenti con lo stipendio più alto e restituisce i dipendenti in ordine decrescente in base allo stipendio. Specificando WITH TIES, nel set di risultati vengono inclusi anche i dipendenti con stipendio pari allo stipendio più basso restituito (ultima riga), anche se in questo modo il set di risultati supera il 10% dei dipendenti.

USE AdventureWorks2022;  
GO  
SELECT TOP(10) PERCENT WITH TIES  
pp.FirstName, pp.LastName, e.JobTitle, e.Gender, r.Rate  
FROM Person.Person AS pp   
    INNER JOIN HumanResources.Employee AS e  
        ON pp.BusinessEntityID = e.BusinessEntityID  
    INNER JOIN HumanResources.EmployeePayHistory AS r  
        ON r.BusinessEntityID = e.BusinessEntityID  
ORDER BY Rate DESC;  
GO

Limitazione delle righe interessate da DELETE, INSERT o UPDATE

R. Utilizzo di TOP per limitare il numero di righe eliminate

Quando si usa una clausola TOP (n) con DELETE, l'operazione di eliminazione viene eseguita su una selezione non definita di n righe. In altre parole, l'istruzione DELETE sceglie un numero (n) di righe che soddisfano i criteri definiti nella clausola WHERE. L'esempio seguente elimina 20 righe con scadenze precedenti al 1° luglio 2002 dalla tabella PurchaseOrderDetail.

USE AdventureWorks2022;  
GO  
DELETE TOP (20)   
FROM Purchasing.PurchaseOrderDetail  
WHERE DueDate < '20020701';  
GO

Se si vuole usare TOP per eliminare le righe in un ordine cronologico significativo, usare TOP con ORDER BY in un'istruzione sub-SELECT. Tramite la query seguente vengono eliminate le 10 righe della tabella PurchaseOrderDetail contenenti le date di scadenza più imminenti. Per assicurarsi che vengano eliminate solo 10 righe, la colonna specificata nell'istruzione di selezione secondaria (PurchaseOrderID) è la chiave primaria della tabella. L'utilizzo di una colonna non chiave nell'istruzione sub-SELECT può avere come conseguenza l'eliminazione di più di 10 righe se la colonna specificata contiene valori duplicati.

USE AdventureWorks2022;  
GO  
DELETE FROM Purchasing.PurchaseOrderDetail  
WHERE PurchaseOrderDetailID IN  
   (SELECT TOP 10 PurchaseOrderDetailID   
    FROM Purchasing.PurchaseOrderDetail   
    ORDER BY DueDate ASC);  
GO

B. Utilizzo di TOP per limitare il numero di righe inserite

L'esempio seguente crea la tabella EmployeeSales e inserisce il nome e i dati sulle vendite da inizio anno per i primi cinque dipendenti della tabella HumanResources.Employee. L'istruzione INSERT sceglie cinque righe qualsiasi restituite dall'istruzione SELECT che soddisfano i criteri definiti nella clausola WHERE. La clausola OUTPUT consente di visualizzare le righe inserite nella tabella EmployeeSales. Si noti che la clausola ORDER BY nell'istruzione SELECT non viene usate per determinare i primi cinque dipendenti.

USE AdventureWorks2022;  
GO  
IF OBJECT_ID ('dbo.EmployeeSales', 'U') IS NOT NULL  
    DROP TABLE dbo.EmployeeSales;  
GO  
CREATE TABLE dbo.EmployeeSales  
( EmployeeID   NVARCHAR(11) NOT NULL,  
  LastName     NVARCHAR(20) NOT NULL,  
  FirstName    NVARCHAR(20) NOT NULL,  
  YearlySales  MONEY NOT NULL  
 );  
GO  
INSERT TOP(5)INTO dbo.EmployeeSales  
    OUTPUT inserted.EmployeeID, inserted.FirstName, inserted.LastName, inserted.YearlySales  
    SELECT sp.BusinessEntityID, c.LastName, c.FirstName, sp.SalesYTD   
    FROM Sales.SalesPerson AS sp  
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.SalesYTD > 250000.00  
    ORDER BY sp.SalesYTD DESC;  
GO

Se si vuole usare TOP per inserire le righe in un ordine cronologico significativo, usare TOP con ORDER BY in un'istruzione sub-SELECT. L'esempio seguente illustra come effettuare questa operazione. La clausola OUTPUT consente di visualizzare le righe inserite nella tabella EmployeeSales. Si noti che vengono ora inseriti i primi cinque dipendenti in base ai risultati della clausola ORDER BY, anziché righe non definite.

INSERT INTO dbo.EmployeeSales  
    OUTPUT inserted.EmployeeID, inserted.FirstName, inserted.LastName, inserted.YearlySales  
    SELECT TOP (5) sp.BusinessEntityID, c.LastName, c.FirstName, sp.SalesYTD   
    FROM Sales.SalesPerson AS sp  
    INNER JOIN Person.Person AS c  
        ON sp.BusinessEntityID = c.BusinessEntityID  
    WHERE sp.SalesYTD > 250000.00  
    ORDER BY sp.SalesYTD DESC;  
GO

C. Utilizzo di TOP per limitare il numero di righe aggiornate

Nell'esempio seguente viene utilizzata la clausola TOP per aggiornare righe in una tabella. Quando si usa una clausola TOP (n) con UPDATE, l'operazione di aggiornamento viene eseguita su un numero non definito di righe. In altre parole, l'istruzione UPDATE sceglie un numero (n) di righe che soddisfano i criteri definiti nella clausola WHERE. Nell'esempio seguente vengono assegnati 10 clienti da un venditore a un altro.

USE AdventureWorks2022;  
UPDATE TOP (10) Sales.Store  
SET SalesPersonID = 276  
WHERE SalesPersonID = 275;  
GO

Se è necessario utilizzare TOP per applicare gli aggiornamenti in un ordine cronologico significativo, è necessario utilizzare questa clausola insieme a ORDER BY in un'istruzione sub-SELECT. Nell'esempio seguente le ore di ferie dei 10 dipendenti vengono aggiornate con le prime date di assunzione.

UPDATE HumanResources.Employee  
SET VacationHours = VacationHours + 8  
FROM (SELECT TOP 10 BusinessEntityID FROM HumanResources.Employee  
     ORDER BY HireDate ASC) AS th  
WHERE HumanResources.Employee.BusinessEntityID = th.BusinessEntityID;  
GO

Esempi: Azure Synapse Analytics e Piattaforma di strumenti analitici (PDW)

L'esempio seguente restituisce le prime 31 righe corrispondenti ai criteri di query. La clausola ORDER BY garantisce che le 31 righe restituite siano le prime 31 righe in base all'ordinamento alfabetico della colonna LastName.

Uso di TOP senza specificare i valori equivalenti.

SELECT TOP (31) FirstName, LastName   
FROM DimEmployee ORDER BY LastName;

Risultato: vengono restituite 31 righe.

Uso di TOP specificando WITH TIES.

SELECT TOP (31) WITH TIES FirstName, LastName   
FROM DimEmployee ORDER BY LastName;

Risultato: vengono restituite 33 righe, perché tre dipendenti denominati Brown tie per la prima riga.

Vedi anche

SELECT (Transact-SQL)
INSERT (Transact-SQL)
UPDATE (Transact-SQL)
DELETE (Transact-SQL)
Clausola ORDER BY (Transact-SQL)
SET ROWCOUNT (Transact-SQL)
MERGE (Transact-SQL)

Condividi tramite