CoalesceEmpty (MDX)CoalesceEmpty (MDX)

SI APPLICA A:sìSQL Server Analysis ServicesnoAzure Analysis ServicesAPPLIES TO:yesSQL Server Analysis ServicesnoAzure Analysis Services

Converte un valore di cella vuota in un valore di cella non vuota specificato, che può corrispondere a un numero o una stringa.Converts an empty cell value to a specified nonempty cell value, which can be either a number or string.

SintassiSyntax


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

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

ArgomentiArguments

Numeric_Expression1Numeric_Expression1
Espressione numerica valida che in genere è un'espressione MDX (Multidimensional Expression) di coordinate di celle che restituisce un numero.A valid numeric expression that is typically a Multidimensional Expressions (MDX) expression of cell coordinates that return a number.

Numeric_Expression2Numeric_Expression2
Espressione numerica valida che in genere è un valore numerico specificato.A valid numeric expression that is typically a specified numeric value.

String_Expression1String_Expression1
Espressione stringa valida che in genere è un'espressione MDX (Multidimensional Expression) di coordinate di celle che restituisce una stringa.A valid string expression that is typically a Multidimensional Expressions (MDX) expression of cell coordinates that returns a string.

String_Expression2String_Expression2
Espressione stringa valida che in genere è un valore stringa specificato con cui viene sostituito un valore NULL restituito dalla prima espressione stringa.A valid string expression that is typically a specified string value that is substituted for a NULL returned by the first string expression.

OsservazioniRemarks

Se vengono specificate uno o più espressioni numeriche, di CoalesceEmpty funzione restituisce il valore numerico della prima espressione numerica, da sinistra a destra, che può essere risolta in un valore non vuoto.If one or more numeric expressions are specified, the CoalesceEmpty function returns the numeric value of the first numeric expression (from left to right) that can be resolved to a nonempty value. Se nessuna delle espressioni numeriche specificate può essere risolta in un valore non vuoto, la funzione restituisce il valore di cella vuota.If none of the specified numeric expressions can be resolved to a nonempty value, the function returns the empty cell value. Il valore della seconda espressione numerica è in genere il valore numerico con cui viene sostituito un valore NULL restituito dalla prima espressione numerica.Typically, the value for the second numeric expression is the numeric value that is substituted for a NULL returned by the first numeric expression.

Se vengono specificate una o più espressioni stringa, la funzione restituisce il valore stringa della prima espressione stringa, da sinistra a destra, che può essere risolta in un valore non vuoto.If one or more string expressions are specified, the function returns the string value of the first string expression (from left to right) that can be resolved to a nonempty value. Se nessuna delle espressioni stringa specificate può essere risolta in un valore non vuoto, la funzione restituisce il valore di cella vuota.If none of the specified string expressions can be resolved to a nonempty value, the function returns the empty cell value. Il valore della seconda espressione stringa è in genere il valore stringa con cui viene sostituito un valore NULL restituito dalla prima espressione stringa.Typically, the value for the second string expression value is the string value that is substituted for a NULL returned by the first string expression.

Il CoalesceEmpty funzione può accettare solo valori dello stesso tipo.The CoalesceEmpty function can only take values of the same type. In altre parole, tutte le espressioni valore specificate devono restituire solo tipi di dati numerici o un valore di cella vuota oppure tutte le espressioni valore specificate devono restituire tipi di dati stringa o un valore di cella vuota.In other words, all specified value expressions must evaluate to only numeric data types or an empty cell value, or all specified value expressions must evaluate to string data types or to an empty cell value. Nella stessa chiamata a questa funzione non possono essere incluse espressioni numeriche e stringa.A single call to this function cannot include both numeric and string expressions.

Per ulteriori informazioni sulle celle vuote, vedere la documentazione relativa a OLE DB.For more information about empty cells, see the OLE DB documentation.

EsempioExample

Le query di esempio seguente il Adventure Works cubo.The following example queries the Adventure Works cube. Nell'esempio viene restituito il quantitativo ordinato di ogni prodotto e la percentuale di quantitativi ordinati per categoria.This example returns the order quantity of each product and the percentage of order quantities by category. Il CoalesceEmpty funzione assicura che i valori null vengono rappresentati come zero (0) durante la formattazione dei membri calcolati.The CoalesceEmpty function ensures that null values are represented as zero (0) when formatting the calculated members.

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

Vedere ancheSee Also

Riferimento alla funzione MDX ( MDX )MDX Function Reference (MDX)