Freigeben über


Verwenden von Zelleigenschaften (MDX)

Zelleigenschaften in multidimensionalen Ausdrücken (MDX) enthalten Informationen zum Inhalt und Format von Zellen in einer multidimensionalen Datenquelle, z. B. einem Cube.

MDX unterstützt das CELL PROPERTIES-Schlüsselwort in einer MDX SELECT-Anweisung, um systeminterne Zelleigenschaften abzurufen. Systeminterne Zelleigenschaften werden am häufigsten verwendet, um die visuelle Darstellung von Zelldaten zu unterstützen.

CELL PROPERTIES-Schlüsselwortsyntax

Verwenden Sie die folgende Syntax für das CELL PROPERTIES Schlüsselwort der MDX-Anweisung SELECT :

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

Die folgende Syntax zeigt das Format des <cell_props> Werts und wie dieser Wert das CELL PROPERTIES Schlüsselwort zusammen mit einer oder mehreren systemintrinsischen Zelleigenschaften verwendet.

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

Unterstützte intrinsische Zelleigenschaften

Die folgende Tabelle listet die unterstützten intrinsischen Zelleigenschaften auf, die im <property> Wert verwendet werden.

Eigentum BESCHREIBUNG
ACTION_TYPE Eine Bitmaske, die angibt, welche Arten von Aktionen in der Zelle vorhanden sind. Diese Eigenschaft kann einen der folgenden Werte haben:

MDACTION_TYPE_URL

MDACTION_TYPE_HTML

MDACTION_TYPE_STATEMENT

MDACTION_TYPE_DATASET

MDACTION_TYPE_ROWSET

MDACTION_TYP_BEFHELSZEILE

MDACTION_TYPE_PROPRIETARY

MDACTION_TYPE_REPORT

MDACTION_TYPE_DRILLTHROUGH



Hinweis: Drillthrough-Aktionen werden nicht für Abfragen berücksichtigt, die ein Set in der WHERE-Klausel haben.
BACK_COLOR Die Hintergrundfarbe zum Anzeigen der VALUE- oder FORMATTED_VALUE-Eigenschaft. Weitere Informationen finden Sie unter FORE_COLOR und BACK_COLOR Contents (MDX).For more information, see FORE_COLOR and BACK_COLOR Contents (MDX).
CELL_ORDINAL Die Ordnungszahl der Zelle im Dataset.
FONT_FLAGS Die Bitmaske, die die Effekte auf die Schriftart beschreibt. Beispielsweise stellt der Wert 5 die Kombination aus fett (MDFF_BOLD) und unterstrichenen (MDFF_UNDERLINE) Schriftarteffekten dar. Der Wert ist das Ergebnis eines bitweisen OR-Vorgangs einer oder mehrerer der folgenden Konstanten:

MDFF_BOLD = 1

MDFF_ITALIC = 2

MDFF_UNDERLINE = 4

MDFF_STRIKEOUT = 8
FONT_NAME Die Schriftart, die zum Anzeigen der Eigenschaft VALUE oder FORMATTED_VALUE verwendet werden soll.
FONT_SIZE Schriftgröße, die zum Anzeigen der VALUE- oder FORMATTED_VALUE-Eigenschaft verwendet werden soll.
FORE_COLOR Die Vordergrundfarbe für die Anzeige der VALUE- oder FORMATTED_VALUE-Eigenschaft. Weitere Informationen finden Sie unter FORE_COLOR und BACK_COLOR Contents (MDX).For more information, see FORE_COLOR and BACK_COLOR Contents (MDX).
FORMAT Dasselbe wie FORMAT_STRING.
FORMAT_STRING Die Zum Erstellen des FORMATTED_VALUE Eigenschaftswerts verwendete Formatzeichenfolge. Weitere Informationen finden Sie unter FORMAT_STRING Inhalt (MDX).
FORMATTED_VALUE Die Zeichenfolge, die eine formatierte Anzeige der VALUE Eigenschaft darstellt.
LANGUAGE Das Gebiet, auf das das FORMAT_STRING angewendet wird. LANGUAGE wird in der Regel für die Währungsumrechnung verwendet.
UPDATEABLE Ein Wert, der angibt, ob die Zelle aktualisiert werden kann. Diese Eigenschaft kann einen der folgenden Werte haben:

MD_MASK_ENABLED (0x00000000) Die Zelle kann aktualisiert werden.

MD_MASK_NOT_ENABLED (0x10000000) Die Zelle kann nicht aktualisiert werden.

CELL_UPDATE_ENABLED (0x00000001) Zelle kann in der Zellmenge aktualisiert werden.

CELL_UPDATE_ENABLED_WITH_UPDATE (0x00000002) Die Zelle kann mit einer Aktualisierungsanweisung aktualisiert werden. Das Update schlägt möglicherweise fehl, wenn eine Blattzelle aktualisiert wird, die nicht zum Schreiben aktiviert ist.

CELL_UPDATE_NOT_ENABLED_FORMULA (0x10000001) Die Zelle kann nicht aktualisiert werden, da die Zelle ein berechnetes Element zwischen den Koordinaten aufweist; die Zelle wurde mit einem Satz in der Where-Klausel abgerufen. Eine Zelle kann aktualisiert werden, auch wenn eine Formel Einfluss hat oder eine berechnete Zelle den Wert einer Zelle beeinflusst (ist irgendwo entlang des Aggregationspfades). In diesem Szenario ist der endgültige Wert der Zelle möglicherweise nicht der aktualisierte Wert, da sich die Berechnung auf das Ergebnis auswirkt.

CELL_UPDATE_NOT_ENABLED_NONSUM_MEASURE (0x10000002) Die Zelle kann nicht aktualisiert werden, da Nicht-Summen-Measures (Anzahl, Min., Max., unterschiedliche Anzahl, semi-additiv) nicht aktualisiert werden können.

CELL_UPDATE_NOT_ENABLED_NACELL_VIRTUALCUBE (0x10000003) Die Zelle kann nicht aktualisiert werden, da sie nicht existiert, weil sie sich am Schnittpunkt eines Maßes und eines Dimensionselements befindet, das nicht mit der Maßgruppe des Maßes verknüpft ist.

CELL_UPDATE_NOT_ENABLED_SECURE (0x10000005) Die Zelle kann nicht aktualisiert werden, da die Zelle gesichert ist.

CELL_UPDATE_NOT_ENABLED_CALCLEVEL (0x10000006) Reserviert für die zukünftige Verwendung.

CELL_UPDATE_NOT_ENABLED_CANNOTUPDATE (0x10000007) Die Zelle kann aus internen Gründen nicht aktualisiert werden.

CELL_UPDATE_NOT_ENABLED_INVALIDDIMENSIONTYPE (0x10000009) Die Zelle kann nicht aktualisiert werden, da Updates in Miningmodellen, indirekten Dimensionen oder Data Mining-Dimensionen nicht unterstützt werden.
VALUE Der unformatierte Wert der Zelle.

Es sind nur die CELL_ORDINAL, FORMATTED_VALUE und VALUE Zelleigenschaften erforderlich. Alle Zelleigenschaften, systemintern oder anbieterspezifisch, werden im PROPERTIES Schema-Rowset definiert, einschließlich deren Datentypen und Anbieterunterstützung. Weitere Informationen zum PROPERTIES Schema-Rowset finden Sie unter MDSCHEMA_PROPERTIES Rowset.

Wenn das CELL PROPERTIES Schlüsselwort nicht verwendet wird, sind die standardmäßig zurückgegebenen Zelleigenschaften VALUE, FORMATTED_VALUE und CELL_ORDINAL (in dieser Reihenfolge). Wenn das CELL PROPERTIES Schlüsselwort verwendet wird, werden nur die mit dem Schlüsselwort explizit angegebenen Zelleigenschaften zurückgegeben.

Im folgenden Beispiel wird die Verwendung des CELL PROPERTIES Schlüsselworts in einer MDX-Abfrage veranschaulicht:

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  

Zelleigenschaften werden nicht für MDX-Abfragen zurückgegeben, die flache Rowsets zurückgeben; in diesem Fall wird jede Zelle so dargestellt, als ob nur die FORMATTED_VALUE Zelleigenschaft zurückgegeben wurde.

Festlegen von Zelleigenschaften

Zelleigenschaften können an verschiedenen Stellen in Microsoft SQL Server Analysis Services festgelegt werden. Beispielsweise kann die Eigenschaft "Formatzeichenfolge" für reguläre Messwerte auf der Registerkarte "Cubestruktur" des Cube-Editors in SQL Server Data Tools (SSDT) festgelegt werden. Die gleiche Eigenschaft kann für berechnete Messwerte festgelegt werden, die im Cube auf der Registerkarte "Berechnungen" des Cube-Editors definiert sind. Berechnete Messwerte, die in der WITH-Klausel einer Abfrage definiert sind, haben auch dort ihre Formatzeichenfolge definiert. Die folgende Abfrage veranschaulicht, wie Zelleigenschaften für ein berechnetes Messwert festgelegt werden können::

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  

Siehe auch

MDX Query Fundamentals (Analysis Services)