MDX-Membereigenschaften – Systeminterne Membereigenschaften

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.

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.

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.

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)