CoalesceEmpty (MDX)

Converte um valor de célula vazia em um valor específico de célula não vazia, que pode ser um número ou uma cadeia.

Sintaxe

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

Argumentos

Numeric_Expression1
Uma expressão numérica válida que normalmente é uma expressão de Expressões Multidimensionais (MDX) de coordenadas de célula que retornam um número.

Numeric_Expression2
Uma expressão numérica válida que normalmente é um valor numérico especificado.

String_Expression1
Uma expressão de string válida que normalmente é uma expressão de Expressões Multidimensionais (MDX) de coordenadas de célula que retorna uma string.

String_Expression2
Uma expressão de string válida que normalmente é um valor de string especificado e que é substituído por um NULL retornado pela primeira expressão de string.

Remarks

Se uma ou mais expressões numéricas forem especificadas, a função CoalesceEmpty retorna o valor numérico da primeira expressão numérica (da esquerda para a direita) que pode ser resolvido para um valor não vazio. Se nenhuma das expressões numéricas especificadas puder ser resolvida para um valor não vazio, a função retorna o valor da célula vazia. Normalmente, o valor da segunda expressão numérica é o valor numérico que substitui um NULL retornado pela primeira expressão numérica.

Se uma ou mais expressões de cadeia forem especificadas, a função retorna o valor da cadeia da primeira expressão de cadeia (da esquerda para a direita) que pode ser resolvido para um valor não vazio. Se nenhuma das expressões de string especificadas puder ser resolvida para um valor não vazio, a função retorna o valor da célula vazia. Normalmente, o valor para o valor da expressão da segunda cadeia é o valor da cadeia que substitui um NULL retornado pela expressão da primeira cadeia.

A função CoalesceEmpty só pode assumir valores do mesmo tipo. Em outras palavras, todas as expressões de valor especificadas devem ser avaliadas apenas para tipos de dados numéricos ou para um valor de célula vazia, ou todas as expressões de valor especificadas devem avaliar para tipos de dados em cadeia ou para um valor de célula vazio. Uma única chamada para essa função não pode incluir tanto expressões numéricas quanto expressões de string.

Para mais informações sobre células vazias, consulte a documentação do OLE DB.

Exemplo

O exemplo a seguir consulta o cubo Adventure Works . Este exemplo retorna a quantidade de pedido de cada produto e a porcentagem de quantidades de pedidos por categoria. A função CoalesceEmpty garante que os valores nulos sejam representados como zero (0) ao formatar os membros 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]}

Conteúdo relacionado

  • Last updated on