TopPercent (MDX)

Dispone un set in ordine decrescente e restituisce un set di tuple con i valori più alti il cui totale cumulativo è maggiore o uguale alla percentuale specificata.

Sintassi

TopPercent(Set_Expression, Percentage, Numeric_Expression) 

Argomenti

• Set_Expression
  Espressione MDX (Multidimensional Expression) valida che restituisce un set.

• Percentage
  Espressione numerica valida che specifica la percentuale di tuple da restituire.

  Importante
  Percentage deve essere un valore positivo; i valori negativi generano un errore.

• Numeric_Expression
  Espressione numerica valida che in genere è un'espressione MDX (Multidimensional Expression) di coordinate di celle che restituisce un numero.

Osservazioni

La funzione TopPercent calcola la somma dell'espressione numerica specificata valutata sul set specificato, disponendo il set in ordine decrescente. La funzione restituisce quindi gli elementi con i valori più alti la cui percentuale cumulativa del valore sommato totale corrisponde almeno alla percentuale specificata. Tramite la funzione viene restituito il subset più piccolo di un set il cui totale cumulativo corrisponde almeno alla percentuale specificata. Gli elementi restituiti sono ordinati dal più grande al più piccolo.

Attenzione
Se Numeric_Expression restituisce un valore negativo, TopPercent restituisce solo una (1) riga. Vedere il secondo esempio per una presentazione dettagliata di questo comportamento.

Importante
Come la funzione BottomPercent, la funzione TopPercent non rispetta mai la gerarchia.

Esempio

Nell'esempio seguente vengono restituite le migliori città che contribuiscono al primo 10% delle vendite dei rivenditori per la categoria della bicicletta. Il risultato viene disposto in ordine decrescente a iniziare con la città con il valore massimo di vendite.

SELECT [Measures].[Reseller Sales Amount] ON 0,
TopPercent
   ({[Geography].[Geography].[City].Members}
   , 10
   , [Measures].[Reseller Sales Amount]
   ) ON 1
FROM [Adventure Works]
WHERE([Product].[Product Categories].[Bikes])

Tramite l'espressione sopra indicata vengono prodotti i risultati seguenti:

Il set di dati originale può essere ottenuto con la query seguente e può restituire 588 righe:

SELECT [Measures].[Reseller Sales Amount] ON 0,
Order
   ({[Geography].[Geography].[City].Members}
   , [Measures].[Reseller Sales Amount]
   , BDESC
   ) ON 1
FROM [Adventure Works]
WHERE([Product].[Product Categories].[Bikes])

Esempio

La procedura dettagliata seguente consentirà di capire l'effetto dei valori negativi in Numeric_Expression. Prima compilare un contesto in cui è possibile presentare il comportamento.

Nella query seguente viene restituita una tabella di rivenditori 'Sales Amount', 'Total Product Cost' e 'Gross Profit', disposto in ordine decrescente di profitto. Per il profitto sono presenti solo valori negativi e quindi la perdita più piccola appare all'inizio.

SELECT { [Measures].[Reseller Sales Amount], [Measures].[Reseller Total Product Cost], [Measures].[Reseller Gross Profit] } ON columns
     ,  ORDER( [Product].[Product Categories].[Bikes].[Touring Bikes].children, [Measures].[Reseller Gross Profit], BDESC )   ON rows
FROM [Adventure Works]

La query precedente restituisce i risultati seguenti: le righe della sezione centrale sono state rimosse per leggibilità.

Ora, se è stato richiesto di presentare le prime biciclette al 100% in base al profitto si scriverebbe una query come quella riportata di seguito.

SELECT { [Measures].[Reseller Sales Amount], [Measures].[Reseller Total Product Cost], [Measures].[Reseller Gross Profit] } ON columns
     ,  TOPPERCENT( [Product].[Product Categories].[Bikes].[Touring Bikes].children, 100,[Measures].[Reseller Gross Profit] )   ON rows
FROM [Adventure Works]

La query chiede il cento percento (100%), ossia tutte le righe devono essere restituite. Tuttavia, poiché ci sono valori negativi in Numeric_Expression , viene restituita solo una riga.

Vedere anche

Riferimento

Guida di riferimento alle funzioni MDX (MDX)