MDX-Zelleigenschaften: Verwenden von Zelleigenschaften
Gilt für:
SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium
Zelleigenschaften in MDX (Multidimensional Expressions) enthalten Informationen zum Inhalt und Format von Zellen in einer mehrdimensionalen Datenquelle, wie einem Cube.
MDX unterstützt das CELL PROPERTIES-Schlüsselwort in einer MDX-Anweisung zum Abrufen von systeminternen Zelleigenschaften. Systeminterne Zelleigenschaften werden am häufigsten für die visuelle Darstellung von Zellendaten verwendet.
Syntax des CELL PROPERTIES-Schlüsselworts
Das CELL PROPERTIES -Schlüsselwort der MDX- SELECT -Anweisung hat folgende Syntax:
SELECT [<axis_specification>
[, <axis_specification>...]]
FROM [<cube_specification>]
[WHERE [<slicer_specification>]]
[<cell_props>]
Die folgende Syntax zeigt das Format des <cell_props> -Werts und zeigt, wie für diesen Wert das CELL PROPERTIES -Schlüsselwort zusammen mit intrinsischen Zelleigenschaften verwendet wird:
<cell_props> ::= CELL PROPERTIES <property> [, <property>...]
Unterstützte systeminterne Zelleigenschaften
In der folgenden Tabelle sind die unterstützten systeminternen Zelleigenschaften aufgelistet, die im <property> -Wert verwendet werden.
| Eigenschaft | Beschreibung |
|---|---|
| ACTION_TYPE | Eine Bitmaske, die die Arten der Aktionen für die Zelle angibt. Diese Eigenschaft kann einen der folgenden Werte haben: 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 Hinweis: Drillthroughaktionen werden nicht für Abfragen eingeschlossen, die in der WHERE-Klausel eine Menge enthalten. |
| BACK_COLOR | Die Hintergrundfarbe zum Anzeigen der VALUE- oder der FORMATTED_VALUE-Eigenschaft. Weitere Informationen finden Sie unter FORE_COLOR und BACK_COLOR Contents (MDX). |
| CELL_ORDINAL | Die Ordinalzahl der Zelle im Dataset. |
| FONT_FLAGS | Die Bitmaske, die Auswirkungen auf die Schriftart detailliert angibt. Der Wert ist das Ergebnis einer bitweisen OR-Operation von einem oder mehreren der folgenden Konstanten: MDFF_BOLD = 1 MDFF_ITALIC = 2 MDFF_UNDERLINE = 4 MDFF_STRIKEOUT = 8 Der Wert 5 stellt z.B. die Kombination der Schriftarteffekte Fett (MDFF_BOLD) und Unterstrichen (MDFF_UNDERLINE) dar. |
| FONT_NAME | Die Schriftart, die zum Anzeigen der Eigenschaft VALUE oder FORMATTED_VALUE verwendet werden sollte. |
| FONT_SIZE | Die Schriftgröße, die zum Anzeigen der Eigenschaft VALUE oder FORMATTED_VALUE verwendet werden sollte. |
| FORE_COLOR | Die Vordergrundfarbe zum Anzeigen der VALUE- oder FORMATTED_VALUE-Eigenschaft. Weitere Informationen finden Sie unter FORE_COLOR und BACK_COLOR Contents (MDX). |
| FORMAT | Identisch mit FORMAT_STRING. |
| FORMAT_STRING | Die Formatzeichenfolge, mit der der Wert der FORMATTED_VALUE-Eigenschaft erstellt wird. Weitere Informationen finden Sie unter FORMAT_STRING Contents (MDX). |
| FORMATTED_VALUE | Die Zeichenfolge, die eine formatierte Anzeige der VALUE -Eigenschaft darstellt. |
| LANGUAGE | Das Gebietsschema, in dem FORMAT_STRING angewendet wird. LANGUAGE wird i. d. R. zur Währungskonvertierung verwendet. |
| AKTUALISIERBARE | 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 Zelle (0x00000001) kann im Cellset aktualisiert werden. | |
| CELL_UPDATE_ENABLED_WITH_UPDATE (0x00000002) Die Zelle kann mit einer update-Anweisung aktualisiert werden. Das Update kann einen Fehler erzeugen, wenn eine Blattzelle aktualisiert werden soll, für die der Schreibzugriff nicht aktiviert ist. | |
| CELL_UPDATE_NOT_ENABLED_FORMULA (0x10000001) Die Zelle kann nicht aktualisiert werden, da die Zelle über einen berechneten Member zwischen ihren Koordinaten verfügt. die Zelle wurde mit einem Satz in der where-Klausel abgerufen. Eine Zelle kann selbst dann aktualisiert werden, wenn sich eine Formel oder eine berechnete Zelle auf den Wert der Zelle auswirkt (sich irgendwo im Verlauf des Aggregationspfades befindet). In diesem Szenario ist der endgültige Wert der Zelle möglicherweise nicht mit dem aktualisierten Wert identisch, weil sich die Berechnung auf das Ergebnis ausgewirkt hat. | |
| CELL_UPDATE_NOT_ENABLED_NONSUM_MEASURE (0x10000002) Die Zelle kann nicht aktualisiert werden, da nicht summenbezogene Measures (Count, min, max, distinct count, semi-additiv) nicht aktualisiert werden können. | |
| CELL_UPDATE_NOT_ENABLED_NACELL_VIRTUALCUBE (0x10000003) Die Zelle kann nicht aktualisiert werden, da die Zelle nicht vorhanden ist, da sie sich am Schnittpunkt eines Measures und eines Dimensionselements befindet, das nicht mit der Measuregruppe des Measures zusammenhängt. | |
| CELL_UPDATE_NOT_ENABLED_SECURE (0x10000005) Die Zelle kann nicht aktualisiert werden, da die Zelle gesichert ist. | |
| CELL_UPDATE_NOT_ENABLED_CALCLEVEL (0x10000006) Für zukünftige Verwendung reserviert. | |
| 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 das Update in Miningmodell-, indirekten oder Data Mining-Dimensionen nicht unterstützt wird. | |
| VALUE | Der unformatierte Wert der Zelle. |
Nur die Zelleigenschaften CELL_ORDINAL, FORMATTED_VALUEund VALUE werden benötigt. Alle Zelleigenschaften, intrinsische wie anbieterspezifische, sind einschließlich ihrer Datentypen und der Anbieterunterstützung im PROPERTIES -Schemarowset definiert.
Wenn das Schlüsselwort CELL PROPERTIES nicht verwendet wird, sind die zurückgegebenen Zelleigenschaften standardmäßig VALUE, FORMATTED_VALUEund CELL_ORDINAL (in dieser Reihenfolge). Ist das CELL PROPERTIES -Schlüsselwort angegeben, werden nur die Zelleigenschaften zurückgegeben, die explizit mit dem Schlüsselwort angegeben sind.
Das folgende Beispiel zeigt die Verwendung des CELL PROPERTIES -Schlüsselworts in einer MDX-Abfrage:
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
Für MDX-Abfragen, die vereinfachte Rowsets zurückgeben, werden keine Zelleigenschaften zurückgegeben. In diesem Fall wird jede Zelle so dargestellt, als würde nur die Zelleigenschaft FORMATTED_VALUE zurückgegeben.
Festlegen von Zelleigenschaften
Zelleneigenschaften können in Microsoft SQL Server SQL Server Analysis Services an verschiedenen Stellen festgelegt werden. Die Format String-Eigenschaft kann beispielsweise für reguläre Measures auf der Registerkarte Cubestruktur des Cube-Editors in SQL Server Data Tools festgelegt werden. Die gleiche Eigenschaft kann für berechnete Measures festgelegt werden, die für den Cube auf der Registerkarte Berechnungen des Cube-Editors definiert sind. Berechnete Measures, die in der WITH-Klausel einer Abfrage definiert sind, haben auch dort ihre Formatzeichenfolge definiert. Die folgende Abfrage veranschaulicht, wie Zelleneigenschaften für ein berechnetes Measure 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