Proprietà delle celle MDX - Utilizzo delle proprietà delle celle

Si applica a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Nel linguaggio MDX (Multidimensional Expressions) le proprietà delle celle includono informazioni sul contenuto e il formato delle celle di un'origine dei dati multidimensionale, ad esempio un cubo.

MDX supporta l'utilizzo della parola chiave CELL PROPERTIES in un'istruzione MDX SELECT per il recupero delle proprietà intrinseche delle celle. Le proprietà intrinseche delle celle vengono in genere utilizzate per la presentazione visiva dei dati delle celle.

Sintassi della parola chiave CELL PROPERTIES

La sintassi della parola chiave CELL PROPERTIES dell'istruzione MDX SELECT è la seguente:

SELECT [<axis_specification>  
       [, <axis_specification>...]]  
  FROM [<cube_specification>]  
[WHERE [<slicer_specification>]]  
[<cell_props>]  

La sintassi seguente illustra il formato del valore <cell_props> e come tale valore usa la parola chiave CELL PROPERTIES insieme a una o più proprietà intrinseche delle celle:

<cell_props> ::= CELL PROPERTIES <property> [, <property>...]  

Proprietà intrinseche delle celle supportate

Nella tabella seguente sono elencate le proprietà intrinseche delle celle supportate che vengono utilizzate nel valore <property> .

Proprietà Descrizione
ACTION_TYPE Maschera di bit che indica i tipi di azioni esistenti sulla cella. Di seguito vengono indicati i possibili valori della proprietà.

MDACTION_TYPE_URL

MDACTION_TYPE_HTML

MDACTION_TYPE_STATEMENT

MDACTION_TYPE_DATASET

MDACTION_TYPE_ROWSET

MDACTION_TYPE_COMMANDLINE

MDACTION_TYPE_PROPRIETARY

MDACTION_TYPE_REPORT

MDACTION_TYPE_DRILLTHROUGH



Nota: le operazioni di drill-through non sono incluse per le query che contengono un set nella clausola WHERE.
BACK_COLOR Il colore di sfondo per la visualizzazione della proprietà VALUE o FORMATTED_VALUE. Per altre informazioni, vedere FORE_COLOR e BACK_COLOR Contents (MDX).
CELL_ORDINAL Numero ordinale della cella nel set di dati.
FONT_FLAGS Maschera di bit che indica in dettaglio gli effetti sul carattere. Il valore è il risultato di un'operazione con OR bit per bit su una o più delle costanti seguenti:

MDFF_BOLD = 1

MDFF_ITALIC = 2

MDFF_UNDERLINE = 4

MDFF_STRIKEOUT = 8



Il valore 5 rappresenta ad esempio l'applicazione combinata degli effetti grassetto (MDFF_BOLD) e sottolineato (MDFF_UNDERLINE) al carattere.
FONT_NAME Il tipo di carattere da usare per visualizzare la proprietà VALUE o FORMATTED_VALUE .
FONT_SIZE La dimensione del carattere da usare per visualizzare la proprietà VALUE o FORMATTED_VALUE .
FORE_COLOR Il colore di primo piano per la visualizzazione della proprietà VALUE o FORMATTED_VALUE. Per altre informazioni, vedere FORE_COLOR e BACK_COLOR Contents (MDX).
FORMAT Come FORMAT_STRING.
FORMAT_STRING La stringa di formato utilizzata per creare il valore della proprietà FORMATTED_VALUE. Per altre informazioni, vedere contenuto FORMAT_STRING (MDX).
FORMATTED_VALUE La stringa di caratteri che rappresenta una visualizzazione formattata della proprietà VALUE .
LANGUAGE Le impostazioni locali dove verrà applicato FORMAT_STRING . LANGUAGE si usa generalmente per la conversione della valuta.
AGGIORNABILE Valore che indica se la cella può essere aggiornata. Di seguito vengono indicati i possibili valori della proprietà.
MD_MASK_ENABLED (0x00000000) La cella può essere aggiornata.
MD_MASK_NOT_ENABLED (0x10000000) Impossibile aggiornare la cella.
CELL_UPDATE_ENABLED (0x00000001) Cella può essere aggiornata nel set di celle.
CELL_UPDATE_ENABLED_WITH_UPDATE (0x00000002) La cella può essere aggiornata con un'istruzione update. Se si aggiorna una cella foglia non abilitata per la scrittura, l'aggiornamento potrebbe non riuscire.
CELL_UPDATE_NOT_ENABLED_FORMULA (0x10000001) Impossibile aggiornare la cella perché la cella dispone di un membro calcolato tra le coordinate; la cella è stata recuperata con un set nella clausola where. È possibile aggiornare una cella anche se il suo valore è influenzato da una formula o da una cella calcolata, ovvero si trova in un punto qualsiasi del percorso di aggregazione. In questo scenario, il valore finale della cella potrebbe non essere il valore aggiornato, perché il risultato è influenzato dal calcolo.
CELL_UPDATE_NOT_ENABLED_NONSUM_MEASURE (0x10000002) Impossibile aggiornare la cella perché non è possibile aggiornare le misure non sommate (conteggio, min, max, conteggio dei valori distinti, semi-additivi).
CELL_UPDATE_NOT_ENABLED_NACELL_VIRTUALCUBE (0x10000003) La cella non può essere aggiornata perché la cella non esiste perché si trova all'intersezione di una misura e un membro della dimensione non correlato al gruppo di misure della misura.
CELL_UPDATE_NOT_ENABLED_SECURE (0x10000005) La cella non può essere aggiornata perché la cella è protetta.
CELL_UPDATE_NOT_ENABLED_CALCLEVEL (0x10000006) Riservato per uso futuro.
CELL_UPDATE_NOT_ENABLED_CANNOTUPDATE (0x10000007) La cella non può essere aggiornata a causa di motivi interni.
CELL_UPDATE_NOT_ENABLED_INVALIDDIMENSIONTYPE (0x10000009) La cella non può essere aggiornata perché l'aggiornamento non è supportato nelle dimensioni del modello di data mining, indiretto o di data mining.
VALUE Valore non formattato della cella.

Sono richieste solo le proprietà di cella CELL_ORDINAL, FORMATTED_VALUEe VALUE . Tutte le proprietà delle celle, intrinseche o specifiche del provider, sono definite nel set di righe dello schema PROPERTIES , inclusi i tipi di dati e il supporto del provider.

Per impostazione predefinita, se non viene usata la parola chiave CELL PROPERTIES , le proprietà di cella restituite sono VALUE, FORMATTED_VALUEe CELL_ORDINAL (in questo ordine). Se è specificata la parola chiave CELL PROPERTIES , verranno restituite solo le proprietà delle celle indicate in modo esplicito con la parola chiave.

Nell'esempio seguente viene illustrato l'utilizzo della parola chiave CELL PROPERTIES in una query MDX:

SELECT  
   {[Measures].[Reseller Gross Profit]} ON COLUMNS,  
   {[Reseller].[Reseller Type].[Reseller Name].Members} ON ROWS  
FROM [Adventure Works]  
CELL PROPERTIES VALUE, FORMATTED_VALUE, FORMAT_STRING, FORE_COLOR, BACK_COLOR  

Le proprietà delle celle non vengono restituite per le query MDX che restituiscono set di righe bidimensionali. In questo caso ogni cella viene rappresentata come se fosse restituita solo la proprietà FORMATTED_VALUE della cella.

Impostazione delle proprietà delle celle

Le proprietà delle celle possono essere impostate in Microsoft SQL Server SQL Server Analysis Services in varie posizioni. Ad esempio, la proprietà Format String può essere impostata per le misure regolari nella scheda Struttura cubo dell'Editor cubi in SQL Server Data Tools. La stessa proprietà può essere impostata per le misure calcolate definite nel cubo nella scheda Calcoli dell'Editor cubi. Le misure calcolate definite nella clausola WITH di una query hanno anche la stringa di formato definita. La query seguente illustra come impostare le proprietà delle celle su una misura calcolata:

WITH MEMBER MEASURES.CELLPROPERTYDEMO AS [Measures].[Internet Sales Amount]  
, FORE_COLOR=RGB(0,0,255)  
, BACK_COLOR=IIF([Measures].[Internet Sales Amount]>7000000, RGB(255,0,0), RGB(0,255,0))  
, FONT_SIZE=10  
, FORMAT_STRING='#,#.000'  
SELECT MEASURES.CELLPROPERTYDEMO ON 0,  
[Date].[Calendar Year].[Calendar Year].MEMBERS ON 1  
FROM [Adventure Works]  
CELL PROPERTIES VALUE, FORMATTED_VALUE, FORE_COLOR, BACK_COLOR, FONT_SIZE  

Vedere anche

Nozioni fondamentali sulle query MDX (Analysis Services)