Aggr() returnerar en uppsättning värden för uttrycket beräknade över den angivna dimensionen eller de angivna dimensionerna. Exempelvis det maximala värdet av försäljningen, per kund, per region. Funktionen Aggr används för avancerade aggregeringar där Aggr-funktionen omsluts av en annan aggregeringsfunktion och uppsättningen med resultat från Aggr-funktionen används som indata till den aggregering som den är kapslad i.
Syntax:
Aggr({SetExpression}[DISTINCT] [NODISTINCT ] expr, StructuredParameter{, StructuredParameter})
Return data type: dual
Arguments:
| Argument | Beskrivning |
|---|---|
| expr |
Ett uttryck som består av en aggregeringsfunktion. Som standard kommer aggregeringsfunktionen att aggregera över den uppsättning möjliga poster som definierats av urvalet. |
| StructuredParameter |
StructuredParameter består av en dimension och ett (valfritt) sorteringskriterium i formatet: (Dimension(Sort-type, Ordering)) Dimensionen är ett enda fält och kan inte vara ett uttryck. Dimensionen används för att bedöma vilken uppsättning med värden som Aggr-uttrycket ska beräknas på. Om sorteringskriterier används, sorteras den uppsättning med värden som skapas av Aggr-funktionen och som beräknats för dimensionen. Detta är viktigt när sorteringsordningen påverkar resultatet av det uttryck som Aggr-funktionen är innesluten i. Mer information om hur du använder sorteringskriterier finns i Lägga till sorteringskriterier till dimensionen i den strukturerade parametern. |
| SetExpression | Som standard kommer aggregeringsfunktionen att aggregera över den uppsättning möjliga poster som definierats av urvalet. En alternativ uppsättning poster kan definieras med ett uttryck för set-analys. |
| DISTINCT |
Om uttrycksargumentet föregås av kvalificeraren distinct, eller om ingen kvalificerare alls används, kommer varje distinkt kombination av dimensionsvärden endast att generera ett returvärde. Det är normalt så här aggregeringar skapas - varje distinkt kombination av dimensionsvärden ger en rad i diagrammet. |
|
NODISTINCT |
Om uttrycksargumentet föregås av kvalificeraren nodistinct kan varje kombination av dimensionsvärden generera mer än ett returvärde, beroende på den underliggande datastrukturen. Om det bara finns en dimension, returnerar funktionen aggr en uppsättning med samma antal element som det finns rader i källdata. |
Grundläggande aggregeringsfunktioner, såsom Sum, Min och Avg, returnerar ett enda numeriskt värde, medan funktionen Aggr() kan jämföras med att skapa en temporär uppsättning med resultat (en virtuell tabell), över vilken en annan aggregering kan göras. Detta kan exempelvis göras genom att beräkna ett genomsnittligt försäljningsvärde genom att summera försäljningen efter kund i en Aggr()-sats och sedan beräkna genomsnittet av de summerade resultaten: Avg(TOTAL Aggr(Sum(Sales),Customer)).
Limitations:
Varje dimension i en Aggr()-funktion måste bestå av ett enda fält. Den får inte vara ett uttryck (beräknad dimension).
Lägga till sorteringskriterier till dimensionen i den strukturerade parametern
I sin grundläggande form är argumentet StructuredParameter i syntaxen för Aggr-funktionen en enda dimension. Uttrycket: Aggr(Sum(Sales, Month)) hittar det totala värdet för försäljning per månad. Om det innesluts i en annan aggregeringsfunktion kan det dock ge oväntade resultat om inte sorteringskriterier används. Det beror på att en del dimensioner kan sorteras numeriskt eller alfabetiskt, och så vidare.
I StructuredParameter-argumentet i Aggr-funktionen kan du ange sorteringskriterier för dimensionen i dina uttryck. På så sätt fastställer du en sorteringsordning för den virtuella tabell som produceras av Aggr-funktionen.
Argumentet StructuredParameter har följande syntax:
(FieldName, (Sort-type, Ordering))
Strukturerade parametrar kan kapslas:
(FieldName, (FieldName2, (Sort-type, Ordering)))
Sorteringstypen kan vara: NUMERIC, TEXT, FREQUENCY eller LOAD_ORDER.
Ordningstyperna som är associerade med varje sorteringstyp är som följer:
| Sorteringstyp | Tillåtna ordningstyper |
|---|---|
| NUMERIC | ASCENDING, DESCENDING eller REVERSE |
| TEXT | ASCENDING, A2Z, DESCENDING, REVERSE eller Z2A |
| FREQUENCY | DESCENDING, REVERSE eller ASCENDING |
| LOAD_ORDER | ASCENDING, ORIGINAL, DESCENDING eller REVERSE |
Ordningstyperna REVERSE och DESCENDING är motsvarigheter.
För sorteringstypen TEXT är ordningstyperna ASCENDING och A2Z motsvarigheter, och DESCENDING, REVERSE och Z2A är motsvarigheter.
För sorteringstypen LOAD_ORDER är ordningstyperna ASCENDING och ORIGINAL motsvarigheter.
Examples and results:
| Exempel | Resultat |
|---|---|
| Avg(Aggr(Sum(UnitSales*UnitPrice), Customer)) |
Uttrycket Aggr(Sum(UnitSales*UnitPrice), Customer) hittar det totala värdet för försäljning utifrån Customer, och returnerar en uppsättning med värden: 295, 715 och 120 för de tre Customer-värdena. Vi har i praktiken skapat en tillfällig lista med värden utan att ha behövt skapa en explicit tabell eller kolumn som innehåller dessa värden. Dessa tre värden används som indata för funktionen Avg(), som räknar ut medelvärdet för försäljning; 376,6667. (Alternativet Totalvärden måste vara markerat under Presentation på egenskapspanelen). |
| Aggr(NODISTINCT Max(UnitPrice), Customer) |
En uppsättning med värden: 16, 16, 16, 25, 25, 25, 19 och 19. Kvalificeraren nodistinct innebär att uppsättningen innehåller ett element för varje rad i källdata: varje är maximalt UnitPrice för varje Customer och Product. |
Data som används i exempel:
Skapa en tabell med Customer, Product, UnitPrice och UnitSales som dimensioner. Lägg till uttrycket i tabellen som ett mått.
ProductData:
LOAD * inline [
Customer|Product|UnitSales|UnitPrice
Astrida|AA|4|16
Astrida|AA|10|15
Astrida|BB|9|9
Betacab|BB|5|10
Betacab|CC|2|20
Betacab|DD|25|25
Canutility|AA|8|15
Canutility|CC||19
] (delimiter is '|');
Examples and results: Strukturerade parametrar
| Exempel | Resultat |
|---|---|
| Sum(Aggr( Rangesum(Above(Sum(Sales),0,12)), (Year, (Numeric, Ascending)), (Month, (Numeric, Ascending)) )) |
Måttet beräknar årsackumulerad försäljning för varje månad med hjälp av sorteringskriterier i det strukturerade parameterargumentet i uttrycket. Utan sorteringskriterier kommer resultatet av uttrycket Sum(Aggr( Rangesum(Above(Sum(Sales),0,12)), (Year), (Month) )) att bero på hur dimensionerna Year och Month är sorterade. Vi kanske inte får det resultat som vi vill ha. Genom att lägga till värden för sorteringstyp och ordningstyp till dimensionen, kan vi ge sorteringskriteriet till den strukturerade parametern: (Year, (Numeric, Ascending)), (Month, (Numeric, Ascending)). Sorteringstypen NUMERIC och ordningen ASCENDING fastställer att Year och Month sorteras i stigande numerisk ordning. |
Data som används i exempel:
Följande laddningsskript genererar en tabell med orderrader som kan användas i exemplet för strukturerade parametrar.
Du kan jämföra skillnaden mellan dessa mått i en tabell eller i separata linjediagram:
- Sum(Aggr( Rangesum(Above(Sum(Sales),0,12)), (Year), (Month) ))
- Sum(Aggr( Rangesum(Above(Sum(Sales),0,12)), (Year, (Numeric, Ascending)), (Month, (Numeric, Ascending)) ))
Det andra måttet ger den rätta årsackumulerade försäljningen för varje månad.