CoalesceEmpty (MDX)

Converte um valor de célula vazia num valor de célula não vazia especificado, que pode ser um número ou uma cadeia.

Syntax

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

Arguments

Numeric_Expression1
Uma expressão numérica válida que é tipicamente 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 cadeia válida que é tipicamente uma expressão de Expressões Multidimensionais (MDX) de coordenadas de célula que devolve uma cadeia.

String_Expression2
Uma expressão de cadeia válida que é tipicamente um valor de cadeia especificado que é substituído por um NULL devolvido pela primeira expressão de cadeia.

Observações

Se uma ou mais expressões numéricas forem especificadas, a função CoalesceEmpty devolve 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 devolve o valor da célula vazia. Normalmente, o valor da segunda expressão numérica é o valor numérico que substitui um NULL devolvido pela primeira expressão numérica.

Se uma ou mais expressões de cadeia forem especificadas, a função devolve 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 cadeia especificadas puder ser resolvida para um valor não vazio, a função devolve 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 devolvido pela expressão da primeira cadeia.

A função CoalesceEmpty só pode assumir valores do mesmo tipo. Por 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 vazio, 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 a esta função não pode incluir simultaneamente expressões numéricas e de string.

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

Example

O exemplo seguinte consulta o cubo Adventure Works . Este exemplo devolve a quantidade encomendada de cada produto e a percentagem das quantidades encomendadas por categoria. A função CoalesceEmpty garante que os valores nulos são 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