Utilizzo delle proprietà delle celle (MDX)

  • Articolo

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:

  • 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

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:

  • 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

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:

  • MD_MASK_ENABLED (0x00000000)   La cella può essere aggiornata.

  • MD_MASK_NOT_ENABLED (0x10000000)   La cella non può essere aggiornata.

  • CELL_UPDATE_ENABLED (0x00000001)   La cella può essere aggiornata nel set di celle.

  • CELL_UPDATE_ENABLED_WITH_UPDATE (0x00000002)   La cella può essere aggiornata tramite un'istruzione di aggiornamento. Se si aggiorna una cella foglia non abilitata per la scrittura, l'aggiornamento potrebbe non riuscire.

  • CELL_UPDATE_NOT_ENABLED_FORMULA (0x10000001)   La cella non può essere aggiornata perché le sue coordinate includono un membro calcolato, ovvero la cella era 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)   La cella non può essere aggiornata perché non è possibile aggiornare misure non Sum (min, max, Distinct Count, semiadditive e di conteggio).

  • CELL_UPDATE_NOT_ENABLED_NACELL_VIRTUALCUBE (0x10000003)   La cella non può essere aggiornata perché non esiste, poiché si trova all'intersezione tra 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é è protetta.

  • CELL_UPDATE_NOT_ENABLED_CALCLEVEL (0x10000006)   Riservata per utilizzi futuri.

  • CELL_UPDATE_NOT_ENABLED_CANNOTUPDATE (0x10000007)   La cella non può essere aggiornata per motivi interni.

  • CELL_UPDATE_NOT_ENABLED_INVALIDDIMENSIONTYPE (0x10000009)   La cella non può essere aggiornata perché l'aggiornamento non è supportato nelle dimensioni dei modelli di data mining, indirette o di data mining.

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

Vedere anche

Altre risorse

Nozioni fondamentali sulle query MDX (Analysis Services)