Funzioni di aggregazione canoniche
Le aggregazioni sono espressioni che riducono una serie di valori di input, ad esempio, in un singolo valore. In genere, vengono usate insieme alla clausola GROUP BY dell'espressione SELECT. Il relativo uso è tuttavia soggetto ad alcuni vincoli.
Funzioni canoniche di aggregazione di Entity SQL
Di seguito sono riportate le funzioni canoniche di aggregazione di Entity SQL.
Avg(expression)
Restituisce la media dei valori non Null.
Argomenti
Tipo Int32
, Int64
, Double
e Decimal
.
Valore restituito
Il tipo di expression
oppure null
se tutti i valori di input sono valori null
.
Esempio
queryString = @"SELECT VALUE AVG(p.ListPrice)
FROM AdventureWorksEntities.Products as p";
SELECT VALUE AVG(p.ListPrice)
FROM AdventureWorksEntities.Products AS p
BigCount(expression)
Restituisce la dimensione dell'aggregazione, inclusi i valori Null e duplicati.
Argomenti
Qualsiasi tipo.
Valore restituito
Oggetto Int64
.
Esempio
queryString = @"SELECT VALUE BigCount(p.ProductID)
FROM AdventureWorksEntities.Products as p";
SELECT VALUE BigCount(p.ProductID)
FROM AdventureWorksEntities.Products AS p
Count(expression)
Restituisce la dimensione dell'aggregazione, inclusi i valori Null e duplicati.
Argomenti
Qualsiasi tipo.
Valore restituito
Oggetto Int32
.
Esempio
queryString = @"SELECT VALUE Count(p.ProductID)
FROM AdventureWorksEntities.Products as p";
SELECT VALUE Count(p.ProductID)
FROM AdventureWorksEntities.Products AS p
Max(expression)
Restituisce il numero massimo di valori non Null.
Argomenti
Valore Byte
, Int16
, Int32
, Int64
, Byte
, Single
, Double
, Decimal
, DateTime
, DateTimeOffset
, Time
, String
, Binary
.
Valore restituito
Il tipo di expression
oppure null
se tutti i valori di input sono valori null
.
Esempio
queryString = @"SELECT VALUE MAX(p.ListPrice)
FROM AdventureWorksEntities.Products as p";
SELECT VALUE MAX(p.ListPrice)
FROM AdventureWorksEntities.Products AS p
Min(expression)
Restituisce il numero minimo di valori non Null.
Argomenti
Valore Byte
, Int16
, Int32
, Int64
, Byte
, Single
, Double
, Decimal
, DateTime
, DateTimeOffset
, Time
, String
, Binary
.
Valore restituito
Il tipo di expression
oppure null
se tutti i valori di input sono valori null
.
Esempio
queryString = @"SELECT VALUE MIN(p.ListPrice)
FROM AdventureWorksEntities.Products as p";
SELECT VALUE MIN(p.ListPrice)
FROM AdventureWorksEntities.Products AS p
StDev(expression)
Restituisce la deviazione standard dei valori non Null.
Argomenti
Valore Int32
, Int64
, Double
, Decimal
.
Valore restituito
Un oggetto Double
. Null
, se tutti i valori di input sono valori null
.
Esempio
queryString = @"SELECT VALUE StDev(product.ListPrice)
FROM AdventureWorksEntities.Products AS product
WHERE product.ListPrice > @price";
SELECT VALUE StDev(product.ListPrice)
FROM AdventureWorksEntities.Products AS product
WHERE product.ListPrice > @price
StDevP(expression)
Restituisce la deviazione standard della popolazione di tutti i valori.
Argomenti
Valore Int32
, Int64
, Double
, Decimal
.
Valore restituito
Un valore Double
, oppure null
se tutti i valori di input sono valori null
.
Esempio
queryString = @"SELECT VALUE StDevP(product.ListPrice)
FROM AdventureWorksEntities.Products AS product
WHERE product.ListPrice > @price";
SELECT VALUE StDevP(product.ListPrice)
FROM AdventureWorksEntities.Products AS product
WHERE product.ListPrice > @price
Sum(expression)
Restituisce la somma dei valori non Null.
Argomenti
Valore Int32
, Int64
, Double
, Decimal
.
Valore restituito
Un valore Double
, oppure null
se tutti i valori di input sono valori null
.
Esempio
queryString = @"SELECT VALUE Sum(p.ListPrice)
FROM AdventureWorksEntities.Products as p";
SELECT VALUE Sum(p.ListPrice)
FROM AdventureWorksEntities.Products AS p
Var(expression)
Restituisce la varianza di tutti i valori non Null.
Argomenti
Valore Int32
, Int64
, Double
, Decimal
.
Valore restituito
Un valore Double
, oppure null
se tutti i valori di input sono valori null
.
Esempio
queryString = @"SELECT VALUE Var(product.ListPrice)
FROM AdventureWorksEntities.Products AS product
WHERE product.ListPrice > @price";
SELECT VALUE Var(product.ListPrice)
FROM AdventureWorksEntities.Products AS product
WHERE product.ListPrice > @price
VarP(expression)
Restituisce la varianza della popolazione di tutti i valori non Null.
Argomenti
Valore Int32
, Int64
, Double
, Decimal
.
Valore restituito
Un valore Double
, oppure null
se tutti i valori di input sono valori null
.
Esempio
queryString = @"SELECT VALUE VarP(product.ListPrice)
FROM AdventureWorksEntities.Products AS product
WHERE product.ListPrice > @price";
SELECT VALUE VarP(product.ListPrice)
FROM AdventureWorksEntities.Products AS product
WHERE product.ListPrice > @price
Una funzionalità equivalente è disponibile nel provider gestito del client Microsoft SQL. Per altre informazioni, vedere SqlClient per funzioni di Entity Framework.
Aggregazioni basate su raccolta
Le aggregazioni basate su raccolte (funzioni della Collection) operano sulle raccolte e restituiscono un valore. Se, ad esempio, ORDERS è una raccolta di tutti gli ordini, è possibile calcolare la prima data di consegna con l'espressione seguente:
min(select value o.ShipDate from LOB.Orders as o)
Le espressioni all'interno di aggregazioni basate su raccolte vengono valutate nell'ambito di risoluzione dei nomi di ambiente corrente.
Aggregazioni basate su gruppo
Le aggregazioni basate su gruppo vengono calcolate su un gruppo definito dalla clausola GROUP BY. Per ogni gruppo nel risultato viene calcolata un'aggregazione distinta usando gli elementi in ciascun gruppo come input nel calcolo dell'aggregazione. Quando in un'espressione selezionata viene usata una clausola GROUP BY, nella proiezione o nella clausola ORDER BY possono essere presenti solo nomi di espressioni di raggruppamento, aggregazioni o espressioni costanti.
Nell'esempio seguente viene calcolata la quantità media ordinata per ciascun prodotto:
select p, avg(ol.Quantity) from LOB.OrderLines as ol
group by ol.Product as p
È possibile usare un'aggregazione basata su gruppo senza una clausola GROUP BY esplicita nell'espressione SELECT. In questo caso, tutti gli elementi vengono considerati come singolo gruppo. Equivale essenzialmente alla definizione di un raggruppamento basato su costante. Si consideri, ad esempio, l'espressione seguente:
select avg(ol.Quantity) from LOB.OrderLines as ol
L'espressione equivale alla seguente:
select avg(ol.Quantity) from LOB.OrderLines as ol group by 1
Le espressioni all'interno dell'aggregazione basata su gruppo vengono valutate nell'ambito di risoluzione dei nomi visibile per l'espressione della clausola WHERE.
Come in Transact-SQL, le aggregazioni basate su gruppo possono inoltre specificare un modificatore ALL o DISTINCT. Se è specificato il modificatore DISTINCT, eventuali duplicati vengono eliminati dalla raccolta di input di aggregazione prima del calcolo dell'aggregazione. Se è specificato il modificatore ALL o se non è specificato alcun modificatore, non viene eseguita l'eliminazione dei duplicati.