CoalesceEmpty (MDX)

Convierte un valor de celda vacía en un valor de celda no vacío especificado, que puede ser un número o una cadena.

Sintaxis

  
Numeric syntax  
CoalesceEmpty( Numeric_Expression1 [ ,Numeric_Expression2,...n] )  
  
String syntax  
CoalesceEmpty(String_Expression1 [ ,String_Expression2,...n] )

Argumentos

Numeric_Expression1
Una expresión numérica válida que normalmente es una expresión de Expresiones Multidimensionales (MDX) de coordenadas de celda que devuelven un número.

Numeric_Expression2
Una expresión numérica válida que suele ser un valor numérico especificado.

String_Expression1
Una expresión de cadena válida que normalmente es una expresión de coordenadas de celda mediante Expresiones Multidimensionales (MDX) que devuelve una cadena.

String_Expression2
Una expresión de cadena válida que normalmente es un valor de cadena especificado que sustituye a un NULL devuelto por la primera expresión de cadena.

Remarks

Si se especifican una o más expresiones numéricas, la función CoalesceEmpty devuelve el valor numérico de la primera expresión numérica (de izquierda a derecha) que puede resolverse en un valor no vacío. Si ninguna de las expresiones numéricas especificadas puede resolverse a un valor no vacío, la función devuelve el valor de la celda vacía. Normalmente, el valor de la segunda expresión numérica es el valor numérico que sustituye a un NULL devuelto por la primera expresión numérica.

Si se especifican una o más expresiones de cadena, la función devuelve el valor de cadena de la primera expresión de cadena (de izquierda a derecha) que puede resolverse a un valor no vacío. Si ninguna de las expresiones de cadena especificadas puede resolverse a un valor no vacío, la función devuelve el valor de la celda vacía. Normalmente, el valor para el valor de expresión de la segunda cadena es el valor de la cadena que sustituye a un NULL devuelto por la primera expresión de cadena.

La función CoalesceEmpty solo puede tomar valores del mismo tipo. En otras palabras, todas las expresiones de valor especificadas deben evaluar solo a tipos de datos numéricos o a un valor de celda vacío, o todas las expresiones de valor especificadas deben evaluar a tipos de datos de cadena o a un valor de celda vacío. Una sola llamada a esta función no puede incluir tanto expresiones numéricas como de cadena.

Para más información sobre celdas vacías, consulte la documentación de OLE DB.

Example

El siguiente ejemplo consulta el cubo Adventure Works . Este ejemplo devuelve la cantidad de pedido de cada producto y el porcentaje de cantidades de pedido por categoría. La función CoalesceEmpty asegura que los valores nulos se representen como cero (0) al formatear los miembros calculados.

WITH   
   MEMBER [Measures].[Order Percent by Category] AS  
   CoalesceEmpty(   
      ([Product].[Product Categories].CurrentMember,  
        Measures.[Order Quantity]) /   
          (  
           Ancestor  
           ( [Product].[Product Categories].CurrentMember,   
             [Product].[Product Categories].[Category]  
           ), Measures.[Order Quantity]  
       ), 0  
   ), FORMAT_STRING='Percent'  
SELECT   
   {Measures.[Order Quantity],  
      [Measures].[Order Percent by Category]} ON COLUMNS,  
{[Product].[Product].Members} ON ROWS  
FROM [Adventure Works]  
WHERE {[Date].[Calendar Year].[Calendar Year].&[2003]}

Contenido relacionado

  • Last updated on