Utilizzo delle proprietà delle celle (MDX)
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>]
Nella sintassi seguente è illustrato il formato del valore <cell_props> e come tale valore utilizza 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. I possibili valori della proprietà sono i seguenti:
|
BACK_COLOR |
Colore di sfondo per la visualizzazione della proprietà VALUE o FORMATTED_VALUE. Per ulteriori informazioni, vedere Contenuto di FORE_COLOR e BACK_COLOR (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:
Il valore 5 rappresenta ad esempio l'applicazione combinata degli effetti grassetto (MDFF_BOLD) e sottolineato (MDFF_UNDERLINE) al carattere. |
FONT_NAME |
Tipo di carattere da utilizzare per la visualizzazione della proprietà VALUE o FORMATTED_VALUE. |
FONT_SIZE |
Dimensioni del carattere da utilizzare per la visualizzazione della proprietà VALUE o FORMATTED_VALUE. |
FORE_COLOR |
Colore di primo piano per la visualizzazione della proprietà VALUE o FORMATTED_VALUE. Per ulteriori informazioni, vedere Contenuto di FORE_COLOR e BACK_COLOR (MDX). |
FORMAT |
Come per FORMAT_STRING. |
FORMAT_STRING |
Stringa di formato utilizzata per creare il valore della proprietà FORMATTED_VALUE. Per ulteriori informazioni, vedere Contenuto di FORMAT_STRING (MDX). |
FORMATTED_VALUE |
Stringa di caratteri che rappresenta una visualizzazione formattata della proprietà VALUE. |
LANGUAGE |
Le impostazioni locali dove verrà applicato FORMAT_STRING. LANGUAGE è utilizzato generalmente per la conversione della valuta. |
UPDATEABLE |
Valore che indica se la cella può essere aggiornata. I possibili valori della proprietà sono i seguenti:
|
VALUE |
Valore non formattato della cella. |
Sono obbligatorie solo le proprietà CELL_ORDINAL, FORMATTED_VALUE e 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 ulteriori informazioni sul set di righe dello schema PROPERTIES, vedere Set di righe MDSCHEMA_PROPERTIES.
Per impostazione predefinita, se non viene utilizzata la parola chiave CELL PROPERTIES verranno restituite, nell'ordine, le proprietà delle celle VALUE, FORMATTED_VALUE e CELL_ORDINAL. 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
In Microsoft SQL Server Analysis Services è possibile impostare le proprietà di cella in diverse posizioni. È possibile, ad esempio, impostare la proprietà Stringa di formato per misure regolari nella scheda Struttura cubo dell'Editor di cubi in SQL Server Data Tools (SSDT). La stessa proprietà può essere impostata per misure calcolate definite nel cubo nella scheda Calcoli dell'Editor di cubi. La stringa di formato delle misure calcolate definite nella clausola WITH di una query è anch'essa definita in questa clausola. Nella query seguente si illustra come è possibile impostare le proprietà di cella in 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