MDX-Membereigenschaften – Systeminterne Membereigenschaften

Artikel
05/08/2023

Gilt für: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

SQL Server Analysis Services macht systeminterne Eigenschaften für Dimensionsmember verfügbar, die Sie in eine Abfrage einschließen können, um zusätzliche Daten oder Metadaten für die Verwendung in einer benutzerdefinierten Anwendung zurückzugeben oder bei der Modelluntersuchung oder -konstruktion zu unterstützen. Wenn Sie die SQL Server-Clienttools verwenden, können Sie die systeminternen Eigenschaften in SQL Server Management Studio (SSMS) anzeigen lassen.

Systeminterne Eigenschaften sind ID, KEY, KEYxund NAMEund werden von jedem Element auf beliebigen Ebenen verfügbar gemacht. Sie können u.a. auch Positionsinformationen wie LEVEL_NUMBER oder PARENT_UNIQUE_NAMEzurückgeben.

Abhängig davon, wie Sie die Abfrage erstellen und mit welcher Clientanwendung Sie Abfragen auszuführen, sind die Elementeigenschaften im Resultset sichtbar bzw. nicht sichtbar. Wenn Sie SQL Server Management Studio verwenden, um Abfragen zu testen oder auszuführen, können Sie auf ein Element im Resultset doppelklicken, um das Dialogfeld Elementeigenschaften zu öffnen, in dem Werte für jede systeminterne Elementeigenschaft angezeigt werden.

Eine Einführung dazu, wie Sie Dimensionselementeigenschaften verwenden und anzeigen, finden Sie unter Anzeigen von SSAS-Elementeigenschaften innerhalb eines MDX-Abfragefensters in SSMS.

Hinweis

Als Anbieter, der mit dem OLAP-Abschnitt der OLE DB-Spezifikation vom März 1999 (2.6) konform ist, unterstützt Microsoft SQL Server SQL Server Analysis Services die in diesem Thema aufgeführten systeminternen Membereigenschaften.

Andere Anbieter als SQL ServerSQL Server Analysis Services unterstützen möglicherweise zusätzliche systeminterne Membereigenschaften. Weitere Informationen zu den systeminternen Elementeigenschaften, die von anderen Anbietern unterstützt werden, finden Sie in der Dokumentation des jeweiligen Anbieters.

Arten von Elementeigenschaften

Die von SQL Server SQL Server Analysis Services unterstützten systeminternen Membereigenschaften haben zwei Typen:

Kontextabhängige Elementeigenschaften
Diese Elementeigenschaften müssen im Kontext einer bestimmten Hierarchie oder Ebene verwendet werden und stellen Werte für jedes Element der angegebenen Dimension oder Ebene bereit.

Im folgenden Beispiel sehen Sie, wie der Pfad für die KEY -Eigenschaft eingefügt wird: MEMBER [Measures].[Parent Member Key] AS [Product].[Product Categories].CurrentMember.Parent.PROPERTIES("KEY").

Nicht kontextabhängige Elementeigenschaften
Diese Elementeigenschaften können nicht im Kontext einer bestimmten Dimension oder Ebene verwendet werden und geben Werte für alle Elemente auf einer Achse zurück.

Nicht kontextabhängige Eigenschaften sind eigenständig und enthalten keine Pfadinformationen. Beachten Sie, dass für PARENT_UNIQUE_NAME im folgenden Beispiel keine Dimension oder Ebene angegeben wird: DIMENSION PROPERTIES PARENT_UNIQUE_NAME ON COLUMNS

Für die Verwendung einer systeminternen Elementeigenschaft gelten unabhängig davon, ob sie kontextabhängig ist oder nicht, folgende Regeln:

Sie können nur solche systeminternen Elementeigenschaften angeben, die sich auf Dimensionselemente beziehen, die auf die Achse projiziert werden.
Sie können Anforderungen für kontextabhängige Elementeigenschaften in derselben Abfrage mit nicht kontextabhängigen systeminternen Elementeigenschaften mischen.
Zum Abfragen der Eigenschaften verwenden Sie das PROPERTIES -Schlüsselwort.

In den folgenden Abschnitten werden sowohl die verschiedenen kontextabhängigen und nicht kontextabhängigen systeminternen Membereigenschaften beschrieben, die in SQL Server SQL Server Analysis Services verfügbar sind, als auch die Verwendung des PROPERTIES-Schlüsselwort (keyword) mit jedem Eigenschaftstyp.

Kontextabhängige Elementeigenschaften

Alle Dimensionselemente und Ebenenelemente unterstützen eine Reihe von systeminternen Elementeigenschaften, die kontextabhängig sind. In der folgenden Tabelle sind diese kontextabhängigen Eigenschaften aufgelistet.

Eigenschaft	BESCHREIBUNG
ID	Die intern verwaltete ID für das Element.
Schlüssel	Der Wert des Elementschlüssels im ursprünglichen Datentyp. MEMBER_KEY wird für Abwärtskompatibilität verwendet. MEMBER_KEY hat für nicht zusammengesetzte Schlüssel denselben Wert wie KEY0, und die MEMBER_KEY-Eigenschaft ist für zusammengesetzte Schlüssel NULL.
KEYx	Der Schlüssel des Elements, wobei x die nullbasierte Ordnungszahl des Schlüssels ist. KEY0 ist für zusammengesetzte und nicht zusammengesetzte Schlüssel verfügbar, wird jedoch hauptsächlich für zusammengesetzte Schlüssel verwendet. Bei diesem Schlüsseltyp bilden KEY0, KEY1, KEY2 usw. gemeinsam den zusammengesetzten Schlüssel. Die einzelnen Schlüssel können in einer Abfrage unabhängig voneinander verwendet werden, um den betreffenden Teil des zusammengesetzten Schlüssels zurückzugeben. Beispielsweise wird durch Angabe von KEY0 der erste Teil des zusammengesetzten Schlüssels zurückgegeben und durch Angabe von KEY1 der nächste Teil usw. Wenn der Schlüssel nicht zusammengesetzt ist, dann ist KEY0 gleich Key. Beachten Sie, dass KEYx im Kontext sowie ohne Kontext verwendet werden kann. Aus diesem Grund wird der Schlüssel in beiden Listen angezeigt. Ein Beispiel zur Verwendung dieser Elementeigenschaft finden Sie unter Ein einfacher MDX-Trick: Key0, Key1, Key2.
Name	Der Name des Members.

PROPERTIES-Syntax für kontextabhängige Eigenschaften

Sie verwenden diese Elementeigenschaften im Kontext einer bestimmten Dimension oder Ebene und stellen Werte für jedes Element der angegebenen Dimension oder Ebene bereit.

Bei einer Eigenschaft eines Dimensionselements setzen Sie vor den Namen der Eigenschaft den Namen der Dimension, für die die Eigenschaft gilt. Das folgende Beispiel zeigt die entsprechende Syntax:

DIMENSION PROPERTIES Dimension.Property_name

Bei einer Eigenschaft eines Ebenenelements genügt es, wenn Sie vor den Namen der Eigenschaft den Namen der Ebene setzen. Zur zusätzlichen Spezifikation können Sie dort aber auch den Dimensions- und den Ebenennamen angeben. Das folgende Beispiel zeigt die entsprechende Syntax:

DIMENSION PROPERTIES [Dimension.]Level.Property_name

Um dies zu verdeutlichen, sollen alle Namen jedes Elements der [Sales] -Dimension zurückgegeben werden, auf das verwiesen wird. Zum Zurückgeben dieser Namen verwenden Sie folgende Anweisung in einer MDX-Abfrage (Multidimensional Expressions):

DIMENSION PROPERTIES [Sales].Name

Nicht kontextabhängige Elementeigenschaften

Alle Elemente unterstützen eine Reihe von systeminternen Elementeigenschaften, die unabhängig vom Kontext gleich sind. Diese Eigenschaften stellen zusätzliche Informationen bereit, die in Anwendungen dazu verwendet werden können, die Benutzerfreundlichkeit zu verbessern.

In der folgenden Tabelle sind die nicht kontextabhängigen systeminternen Eigenschaften aufgeführt, die von SQL Server SQL Server Analysis Services unterstützt werden.

Hinweis

Die Spalten im MEMBERS-Schemarowset unterstützen die systeminternen Elementeigenschaften, die in der folgenden Tabelle aufgelistet sind. Weitere Informationen zum MEMBERS-Schemarowset finden Sie unter MDSCHEMA_MEMBERS Rowset.

Eigenschaft	BESCHREIBUNG
CATALOG_NAME	Der Name des Cubes, zu dem dieses Element gehört.
CHILDREN_CARDINALITY	Die Anzahl der untergeordneten Elemente des Elements. Dies kann eine Schätzung sein, daher sollten Sie sich nicht darauf verlassen, dass es sich um die exakte Anzahl handelt. Anbieter sollten die bestmögliche Schätzung zurückgeben.
CUSTOM_ROLLUP	Der benutzerdefinierte Elementausdruck.
CUSTOM_ROLLUP_PROPERTIES	Die benutzerdefinierten Elementeigenschaften.
BESCHREIBUNG	Eine lesbare Beschreibung des Elements.
DIMENSION_UNIQUE_NAME	Der eindeutige Name der Dimension, zu der dieses Element gehört. Für Anbieter, die eindeutige Namen durch eine Einschränkung generieren, ist jede Komponente dieses Namens begrenzt.
HIERARCHY_UNIQUE_NAME	Der eindeutige Name der Hierarchie. Wenn das Element zu mehreren Hierarchien gehört, gibt es eine Zeile für jede Hierarchie, zu der das Element gehört. Für Anbieter, die eindeutige Namen durch eine Einschränkung generieren, ist jede Komponente dieses Namens begrenzt.
IS_DATAMEMBER	Ein boolescher Wert, der angibt, ob das Element ein Datenelement ist.
IS_PLACEHOLDERMEMBER	Ein boolescher Wert, der angibt, ob das Element ein Platzhalter ist.
KEYx	Der Schlüssel des Elements, wobei x die nullbasierte Ordnungszahl des Schlüssels ist. KEY0 ist für zusammengesetzte und nicht zusammengesetzte Schlüssel verfügbar. Wenn der Schlüssel nicht zusammengesetzt ist, dann ist KEY0 gleich Key. Bei diesem Schlüsseltyp bilden KEY0, KEY1, KEY2 usw. gemeinsam den zusammengesetzten Schlüssel. Sie können auf jeden einzelnen Schlüssel in einer Abfrage verweisen, um diesen Teil des zusammengesetzten Schlüssels zurückzugeben. Beispielsweise wird durch Angabe von KEY0 der erste Teil des zusammengesetzten Schlüssels zurückgegeben und durch Angabe von KEY1 der nächste Teil usw. Beachten Sie, dass KEYx im Kontext sowie ohne Kontext verwendet werden kann. Aus diesem Grund wird der Schlüssel in beiden Listen angezeigt. Ein Beispiel zur Verwendung dieser Elementeigenschaft finden Sie unter Ein einfacher MDX-Trick: Key0, Key1, Key2.
LCIDx	Die Übersetzung der Elementbeschriftung in den hexadezimalen Wert der Gebietsschema-ID, wobei x der dezimale Wert der Gebietsschema-ID ist (z.B. LCID1009 als Englisch-Kanada). Dies ist nur verfügbar, wenn die Beschriftungsspalte der Übersetzung an die Datenquelle gebunden ist.
LEVEL_NUMBER	Der Abstand des Elements vom Stamm der Hierarchie. Die Stammebene entspricht null.
LEVEL_UNIQUE_NAME	Der eindeutige Name der Ebene, zu der das Element gehört. Für Anbieter, die eindeutige Namen durch eine Einschränkung generieren, ist jede Komponente dieses Namens begrenzt.
MEMBER_CAPTION	Eine Bezeichnung oder Beschriftung, die dem Element zugeordnet ist. Die Beschriftung dient hauptsächlich zu Anzeigezwecken. Ist keine Beschriftung vorhanden, gibt die Abfrage den Wert von MEMBER_NAMEzurück.
MEMBER_KEY	Der Wert des Elementschlüssels im ursprünglichen Datentyp. MEMBER_KEY wird für Abwärtskompatibilität verwendet. MEMBER_KEY hat für nicht zusammengesetzte Schlüssel denselben Wert wie KEY0, und die MEMBER_KEY-Eigenschaft ist für zusammengesetzte Schlüssel NULL.
MEMBER_NAME	Der Name des Members.
MEMBER_TYPE	Der Typ des Elements. Diese Eigenschaft kann einen der folgenden Werte haben: MDMEMBER_TYPE_REGULAR MDMEMBER_TYPE_ALL MDMEMBER_TYPE_FORMULA MDMEMBER_TYPE_MEASURE MDMEMBER_TYPE_UNKNOWN Hinweis: MDMEMBER_TYPE_FORMULA hat Vorrang vor MDMEMBER_TYPE_MEASURE. Daher hat die MEMBER_TYPE -Eigenschaft, wenn es ein Formelelement (berechnetes Element) in der Measures-Dimension gibt, für das berechnete Element den Wert MDMEMBER_TYPE_FORMULA.
MEMBER_UNIQUE_NAME	Der eindeutige Name des Elements. Für Anbieter, die eindeutige Namen durch eine Einschränkung generieren, ist jede Komponente dieses Namens begrenzt.
MEMBER_VALUE	Der Wert des Elements im ursprünglichen Typ.
PARENT_COUNT	Die Anzahl der übergeordneten Elemente des Elements.
PARENT_LEVEL	Der Abstand des dem Element übergeordneten Elements von der Stammebene der Hierarchie. Die Stammebene entspricht null.
PARENT_UNIQUE_NAME	Der eindeutige Name des dem Element übergeordneten Elements. Für sämtliche Elemente auf der Stammebene wirdNULL zurückgegeben. Für Anbieter, die eindeutige Namen durch eine Einschränkung generieren, ist jede Komponente dieses Namens begrenzt.
SKIPPED_LEVELS	Die Anzahl übersprungener Ebenen für das Element.
UNARY_OPERATOR	Der unäre Operator für das Element.
UNIQUE_NAME	Der vollqualifizierte Name des Elements im folgenden Format: [dimension].[level].[key6.].

PROPERTIES-Syntax für nicht kontextabhängige Eigenschaften

Verwenden Sie die folgende Syntax, wenn Sie eine systeminterne nicht kontextabhängige Elementeigenschaft mit dem Schlüsselwort PROPERTIES angeben möchten:

DIMENSION PROPERTIES Property

In dieser Syntax ist es nicht zulässig, die Eigenschaft durch eine Dimension oder Ebene zu qualifizieren. Die Eigenschaft kann nicht qualifiziert werden, weil eine systeminterne Elementeigenschaft, die nicht kontextabhängig ist, für alle Elemente einer Achse gilt.

Beispielsweise hat eine MDX-Anweisung, in der die systeminterne Elementeigenschaft DESCRIPTION angegeben ist, die folgende Syntax:

DIMENSION PROPERTIES DESCRIPTION

Diese Anweisung gibt die Beschreibung für jedes Element in der Achsendimension zurück. Wenn Sie versucht haben, die Eigenschaft mit einer Dimension oder Ebene zu qualifizieren, wie in Dimension.DESCRIPTION oder Level.DESCRIPTION, würde die Anweisung nicht überprüft.

Beispiel

Die folgenden Beispiele zeigen MDX-Abfragen, die systeminterne Eigenschaften zurückgeben.

Beispiel 1: Verwenden kontextabhängiger systeminterner Eigenschaften in Abfragen

Im folgenden Beispiel werden die übergeordnete ID, der Schlüssel und der Name jeder Produktkategorie zurückgegeben. Beachten Sie, dass die Eigenschaften als Measures verfügbar gemacht werden. Auf diese Weise können Sie die Eigenschaften bei Ausführen der Abfrage in einem Cellset anzeigen, anstatt das Dialogfeld Elementeigenschaften in SSMS zu öffnen. Sie können eine mit der folgenden Abfrage vergleichbare Abfrage ausführen, um Elementmetadaten aus einem bereits bereitgestellten Cube abzurufen.

WITH  
MEMBER [Measures].[Parent Member ID] AS  
 [Product].[Product Categories].CurrentMember.Parent.PROPERTIES("ID")  
MEMBER [Measures].[Parent Member Key] AS  
 [Product].[Product Categories].CurrentMember.Parent.PROPERTIES("KEY")  
MEMBER [Measures].[Parent Member Name] AS  
 [Product].[Product Categories].CurrentMember.Parent.PROPERTIES("Name")  
SELECT  
 {[Measures].[Parent Member ID], [Measures].[Parent Member Key], [Measures].[Parent Member Name] } on COLUMNS,   
 [Product].[Product Categories].AllMembers on ROWS  
FROM [Adventure Works]

Beispiel 2: Nicht kontextabhängige, systeminterne Eigenschaften

Das folgende Beispiel enthält eine vollständige Liste der nicht kontextabhängigen, systeminternen Eigenschaften. Nachdem Sie die Abfrage in SSMS ausgeführt haben, klicken Sie auf die einzelnen Elemente, um die Eigenschaften im Dialogfeld Elementeigenschaften anzuzeigen.

SELECT [Measures].[Sales Amount Quota] on COLUMNS,  
[Employee].[Employees].members  
DIMENSION PROPERTIES  
 CATALOG_NAME ,   
 CHILDREN_CARDINALITY ,  
 CUSTOM_ROLLUP ,   
 CUSTOM_ROLLUP_PROPERTIES ,   
 DESCRIPTION ,   
 DIMENSION_UNIQUE_NAME ,   
 HIERARCHY_UNIQUE_NAME ,  
 IS_DATAMEMBER ,   
 IS_PLACEHOLDERMEMBER ,   
 KEY0 ,  
 LCID ,  
 LEVEL_NUMBER ,  
 LEVEL_UNIQUE_NAME ,  
 MEMBER_CAPTION ,   
 MEMBER_KEY ,   
 MEMBER_NAME ,   
 MEMBER_TYPE ,  
 MEMBER_UNIQUE_NAME ,   
 MEMBER_VALUE ,   
 PARENT_COUNT ,   
 PARENT_LEVEL ,   
 PARENT_UNIQUE_NAME ,  
 SKIPPED_LEVELS ,   
 UNARY_OPERATOR ,   
 UNIQUE_NAME    
 ON ROWS  
FROM [Adventure Works]  
WHERE [Employee].[Employee Department].[Department].&[Sales]

Beispiel 3: Zurückgeben von Elementeigenschaften als Daten in einem Resultset

Im folgenden Beispiel wird die übersetzte Beschriftung für das Product Category-Element in der Product-Dimension im Adventure Works-Cube für bestimmte Gebietsschemas zurückgegeben.

WITH   
MEMBER Measures.CategoryCaption AS Product.Category.CurrentMember.MEMBER_CAPTION  
MEMBER Measures.SpanishCategoryCaption AS Product.Category.CurrentMember.Properties("LCID3082")  
MEMBER Measures.FrenchCategoryCaption AS Product.Category.CurrentMember.Properties("LCID1036")  
SELECT   
{ Measures.CategoryCaption, Measures.SpanishCategoryCaption, Measures.FrenchCategoryCaption } ON 0  
,[Product].[Category].MEMBERS ON 1  
FROM [Adventure Works]

Weitere Informationen

PeriodsToDate (MDX)
Children (MDX)
Hierarchize (MDX)
Count (Menge) (MDX)
Filter (MDX)
AddCalculatedMembers (MDX)
DrilldownLevel (MDX)
Properties (MDX)
PrevMember (MDX)
Verwenden von Elementeigenschaften (MDX)
MDX-Funktionsreferenz (MDX)