TopPercent (MDX)

Ordena un conjunto de forma descendente y devuelve un conjunto de tuplas con los valores más altos con un total acumulado mayor o igual a un porcentaje especificado.

Sintaxis

TopPercent(Set_Expression, Percentage, Numeric_Expression) 

Argumentos

• Set_Expression
  Expresión MDX válida que devuelve un conjunto.

• Percentage
  Expresión numérica válida que especifica el porcentaje de tuplas que serán devueltas.

  Importante
  Percentage debe ser un valor positivo; los valores negativos generan errores.

• Numeric_Expression
  Expresión numérica válida que suele ser una expresión MDX de las coordenadas de celdas que devuelven un número.

Comentarios

La función TopPercent calcula la suma de la expresión numérica especificada evaluada sobre el conjunto especificado, ordenando el conjunto de forma descendente. A continuación, la función devuelve los elementos con los valores más altos cuyo porcentaje acumulado del valor total sumado sea al menos el porcentaje especificado. Esta función devuelve el subconjunto más pequeño de un conjunto cuyo total acumulado sea al menos el porcentaje especificado. Los elementos devueltos se ordenan de mayor a menor.

Advertencia
Si Numeric_Expression devuelve un valor negativo, TopPercent devuelve una (1) sola fila. Vea en el segundo ejemplo una presentación detallada de este comportamiento.

Importante
Al igual que la función BottomPercent, la función TopPercent siempre rompe la jerarquía.

Ejemplo

En el ejemplo siguiente se devuelven las mejores ciudades que contribuyen a realizar el 10% principal de ventas de los distribuidores en la categoría Bike. El resultado se mostrará en orden descendente, empezando por la ciudad que tiene el valor de ventas más elevado.

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])

La expresión anterior devuelve los siguientes resultados:

	Reseller Sales Amount
Toronto	$3,508,904.84
London	$1,521,530.09
Seattle	$1,209,418.16
Paris	$1,170,425.18

El conjunto de datos original se puede obtener con la siguiente consulta y devuelve 588 filas:

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])

Ejemplo

El siguiente tutorial le ayudará a entender el efecto de los valores negativos en Numeric_Expression. En primer lugar, crearemos cierto contexto donde podamos mostrar el comportamiento.

La consulta siguiente devuelve una tabla con el importe de las ventas, el costo total del producto y el beneficio bruto de los distribuidores en orden descendente en función del beneficio. Tenga en cuenta que solo hay valores negativos en el beneficio; por tanto, la pérdida más pequeña aparece en la parte superior.

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 consulta anterior devuelve los siguientes resultados (las filas de la sección intermedia se han quitado para facilitar la lectura).

	Reseller Sales Amount	Reseller Total Product Cost	Reseller Gross Profit
Touring-2000 Blue, 50	$157,444.56	$163,112.57	($5,668.01)
Touring-2000 Blue, 46	$321,027.03	$333,021.50	($11,994.47)
Touring-3000 Blue, 62	$87,773.61	$100,133.52	($12,359.91)
…	…	…	…
Touring-1000 Yellow, 46	$1,016,312.83	$1,234,454.27	($218,141.44)
Touring-1000 Yellow, 60	$1,184,363.30	$1,443,407.51	($259,044.21)

Ahora, si le pidieran que presentara el 100% de las mejores bicicletas según el beneficio, escribiría una consulta como esta:

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]

Tenga en cuenta que la consulta solicita el cien por cien (100%); esto significa que deben devolverse todas las filas. Sin embargo, dado que hay valores negativos en Numeric_Expression , solo se devuelve una fila.

	Reseller Sales Amount	Reseller Total Product Cost	Reseller Gross Profit
Touring-2000 Blue, 50	$157,444.56	$163,112.57	($5,668.01)

Vea también

Referencia

Referencia de funciones MDX (MDX)