ValidMeasure (MDX)ValidMeasure (MDX)

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

Restituisce il valore di una misura in un cubo forzando le dimensioni inapplicabili al livello Totale (o al membro predefinito se non aggregabile) al momento della restituzione del risultato per una tupla specificata.Returns the value of a measure in a cube by forcing inapplicable dimensions to their All level (or default member if not aggregatable) when returning the result for a specified tuple.

SintassiSyntax


ValidMeasure(Tuple_Expression)   

ArgomentiArguments

Tuple_ExpressionTuple_Expression
Espressione MDX (Multidimensional Expression) valida che restituisce una tupla.A valid Multidimensional Expressions (MDX) expression that returns a tuple.

OsservazioniRemarks

Il ValidMeasure funzione restituisce il valore di una tupla, ignorando attributi alcuna relazione con il gruppo di misure della misura il cui valore restituisce la tupla.The ValidMeasure function returns the value of a tuple, ignoring attributes that have no relationship with the measure group of the Measure whose value the tuple returns. Un attributo può non essere correlato a una misura per i due motivi riportati di seguito:An attribute can be unrelated to a measure for two reasons:

  • La dimensione dell'attributo non ha alcuna relazione con il gruppo di misure della misura nella tupla.The attribute's dimension has no relationship with the measure group of the measure in the tuple.

  • La dimensione dell'attributo non ha alcuna relazione con il gruppo di misure della misura, ma l'attributo di granularità non è l'attributo chiave e l'attributo di granularità non ha alcuna relazione diretta con l'attributo nella tupla.The attribute's dimension does not have a relationship with the measure group of the measure, but the granularity attribute is not the key attribute, and the granularity attribute does not have a direct relationship with the attribute in the tuple.

    Il comportamento specificato da questa funzione sul lato server per impostazione predefinita ed è controllato dal IgnoreUnrelatedDimensions proprietà sull'oggetto gruppo di misure.The behavior specified by this function is the default server-side behavior and is controlled by the IgnoreUnrelatedDimensions property on the measure group object.

    Per ogni attributo nella tupla specificata con granularità, ovvero in una tupla in cui il membro non corrisponde a quello Totale), la coordinata corrente viene spostata nel modo seguente:For each attribute in the specified tuple with granularity (that is to say, where the member in the tuple is not the All member), the current coordinate for each such attribute is moved as follows:

  • Gli attributi correlati al membro dell'attributo specificato vengono spostati al membro esistente con il membro corrente.Related attributes to the specified attribute member are moved to the member that exists with the current member.

  • Gli attributi che stabiliscono una correlazione con il membro dell'attributo specificato vengono spostati al membro Totale oppure al membro predefinito se la gerarchia non è aggregabile.Relating attributes to the specified attribute member are moved to the All member (or the default member if the hierarchy is not aggregatable).

  • Gli attributi non correlati vengono spostati al membro Totale (in base alla misura).Unrelated attributes are moved to the All member (based on measure).

EsempioExample

La query seguente illustra il modo in cui la funzione ValidMeasure può essere utilizzata per eseguire l'override del comportamento della proprietà IgnoreUnrelatedDimensions.The following query shows how the ValidMeasure function can be used to override the behavior of the IgnoreUnrelatedDimensions property. Nel cubo Adventure Works la proprietà IgnoreUnrelatedDimensions del gruppo di misure Sales Targets è impostata su False. Poiché il join tra la dimensione Date e questo gruppo di misure viene eseguito a livello di granularità Calendar Quarter, per impostazione predefinita la misura Sales Quota restituirà Null sotto il valore Calendar Quarter, sebbene sia presente un calcolo nello script MDX che alloca valori oltre il livello Month.In the Adventure Works cube, the Sales Targets measure group has IgnoreUnrelatedDimensions set to False; since the Date dimension joins to this measure group at the Calendar Quarter granularity, this means that the Sales Quota measure will , by default, return null below Calendar Quarter (although there is also a calculation in the MDX Script which allocates values down to the Month level too). La funzione ValidMeasure può essere utilizzata in una misura calcolata per fare in modo che la misura Sales Quota si comporti come se la proprietà IgnoreUnrelatedDimensions fosse impostata su True e per imporre la visualizzazione del valore dell'elemento Calendar Quarter corrente.Using the ValidMeasure function in a calculated measure can be used to make the Sales Quota measure behave as if IgnoreUnrelatedDimensions was set to True and force Sales Quota to display the value of the current Calendar Quarter.

WITH MEMBER MEASURES.VTEST AS VALIDMEASURE([Measures].[Sales Amount Quota])  
SELECT {[Measures].[Sales Amount Quota], MEASURES.VTEST} ON 0,  
[Date].[Calendar].MEMBERS ON 1  
FROM [Adventure Works]  

In modo analogo, poiché il gruppo di misure Sales Targets non ha alcuna relazione con la dimensione Promotion, sotto il membro Totale di ogni gerarchia relativa a Promotion restituirà Null.Similarly, the Sales Targets measure group has no relationship at all with the Promotion dimension, so below the All Member of any hierarchy on Promotion it will return null. Come indicato in precedenza, questo comportamento può essere modificato tramite la funzione ValidMeasure:Again, this behavior can be changed by using ValidMeasure:

WITH MEMBER MEASURES.VTEST AS VALIDMEASURE([Measures].[Sales Amount Quota])

SELECT {[Measures].[Sales Amount Quota], MEASURES.VTEST} ON 0,

[Promotion].[Promotions].members ON 1

FROM [Adventure Works]

Vedere ancheSee Also

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