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 einbeziehen können, um zusätzliche Daten oder Metadaten zur Verwendung in einer benutzerdefinierten Anwendung zurückzugeben, oder um die Modelluntersuchung oder -konstruktion zu unterstützen. Wenn Sie die SQL Server-Clienttools verwenden, können Sie systeminterne Eigenschaften in SQL Server Management Studio (SSMS) anzeigen.

Zu den systeminternen Eigenschaften gehören ID, KEY, KEYx und NAME, die von jedem Element verfügbar gemacht werden, auf jeder Ebene. Sie können auch Positionsinformationen zurückgeben, z. B. LEVEL_NUMBER oder PARENT_UNIQUE_NAME, unter anderem.

Je nachdem, wie Sie die Abfrage erstellen und in der Clientanwendung, die Sie zum Ausführen von Abfragen verwenden, sind Membereigenschaften möglicherweise im Resultset sichtbar oder nicht sichtbar. Wenn Sie SQL Server Management Studio zum Testen oder Ausführen von Abfragen verwenden, können Sie auf ein Element im Resultset doppelklicken, um das Dialogfeld "Membereigenschaften" zu öffnen, in dem die Werte für jede systeminterne Membereigenschaft angezeigt werden.

Eine Einführung in die Verwendung und Anzeige von Elementeigenschaften für Dimensionelemente finden Sie unter Anzeigen von SSAS-Membereigenschaften in einem MDX-Abfragefenster in SSMS.

Typen von Membereigenschaften

Die systeminternen Membereigenschaften, die von SQL Server SQL Server Analysis Services unterstützt werden, sind von zwei Typen:

Kontextbezogene Membereigenschaften
Diese Membereigenschaften müssen im Kontext einer bestimmten Hierarchie oder Ebene verwendet werden und geben Werte für jedes Element der angegebenen Dimension oder Ebene an.

Beachten Sie, wie das folgende Beispiel den Pfad für die KEY-Eigenschaft enthält: MEMBER [Measures].[Parent Member Key] AS [Product].[Product Categories].CurrentMember.Parent.PROPERTIES("KEY").

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

Eigenständige Kontext-insensitive Eigenschaften und enthalten keine Pfadinformationen. Beachten Sie, dass im folgenden Beispiel keine Dimension oder Ebene für PARENT_UNIQUE_NAME angegeben ist: DIMENSION PROPERTIES PARENT_UNIQUE_NAME ON COLUMNS

Unabhängig davon, ob die systeminterne Membereigenschaft kontextsensitiv ist oder nicht, gelten die folgenden Verwendungsregeln:

• Sie können nur die systeminternen Membereigenschaften angeben, die sich auf Bemaßungselemente beziehen, die auf der Achse projiziert werden.

• Sie können Anforderungen für kontextabhängige Membereigenschaften in derselben Abfrage mit nicht kontextabhängigen systeminternen Membereigenschaften kombinieren.

• Sie verwenden das PROPERTIES-Schlüsselwort , um die Eigenschaften abzufragen.

In den folgenden Abschnitten werden die verschiedenen kontextsensitiven und nicht kontextabhängigen systeminternen Membereigenschaften beschrieben, die in SQL Server SQL Server Analysis Services verfügbar sind, und die Verwendung des PROPERTIES-Schlüsselworts mit jedem Eigenschaftentyp.

Kontextbezogene Membereigenschaften

Alle Dimensionsmember und Ebenenmember unterstützen eine Liste systeminterner Membereigenschaften, die kontextsensitiv sind. In der folgenden Tabelle sind diese kontextabhängigen Eigenschaften aufgeführt.

PROPERTIES-Syntax für kontextabhängige Eigenschaften

Sie verwenden diese Membereigenschaften im Kontext einer bestimmten Dimension oder Ebene und geben Werte für jedes Element der angegebenen Dimension oder Ebene an.

Für Dimensionsmemembeeigenschaften stellen Sie dem Namen der Eigenschaft den Namen der Dimension voran, auf die die Eigenschaft angewendet wird. Das folgende Beispiel zeigt die entsprechende Syntax:

DIMENSION PROPERTIES Dimension.Property_name

Bei einer Elementeigenschaft der Ebene können Sie dem Namen der Eigenschaft nur den Ebenennamen vorangehen oder für zusätzliche Spezifikation sowohl den Dimensions- als auch den Ebenennamen festlegen. Das folgende Beispiel zeigt die entsprechende Syntax:

DIMENSION PROPERTIES [Dimension.]Level.Property_name

Zur Veranschaulichung möchten Sie alle Namen der einzelnen Member, auf die verwiesen wird, in der [Sales] Dimension zurückgeben. Um diese Namen zurückzugeben, verwenden Sie die folgende Anweisung in einer MDX-Abfrage (Multidimensional Expressions):

DIMENSION PROPERTIES [Sales].Name

Nicht kontextbezogene Membereigenschaften

Alle Member unterstützen eine Liste systeminterner Membereigenschaften, die unabhängig vom Kontext identisch sind. Diese Eigenschaften stellen zusätzliche Informationen bereit, die von Anwendungen verwendet werden können, um die Benutzererfahrung 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 kontextbezogene vertrauliche Eigenschaften

Verwenden Sie die folgende Syntax, um eine systeminterne, nicht kontextabhängige Membereigenschaft mithilfe des PROPERTIES-Schlüsselworts anzugeben:

DIMENSION PROPERTIES Property

Beachten Sie, dass diese Syntax nicht zulässt, dass die Eigenschaft durch eine Dimension oder Ebene qualifiziert werden kann. Die Eigenschaft kann nicht qualifiziert werden, da eine systeminterne Membereigenschaft, die nicht kontextsensitiv ist, für alle Elemente einer Achse gilt.

Beispielsweise würde eine MDX-Anweisung, die die systeminterne DESCRIPTION-Membereigenschaft angibt, die folgende Syntax aufweisen:

DIMENSION PROPERTIES DESCRIPTION

Diese Anweisung gibt die Beschreibung der einzelnen Member 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.

Example

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

Beispiel 1: Verwenden kontextbezogener systeminterner Eigenschaften in der Abfrage

Im folgenden Beispiel werden die übergeordnete ID, der Schlüssel und der Name für jede Produktkategorie zurückgegeben. Beachten Sie, wie die Eigenschaften als Measures verfügbar gemacht werden. Auf diese Weise können Sie die Eigenschaften in einem Zellsatz anzeigen, wenn Sie die Abfrage ausführen, und nicht das Dialogfeld "Membereigenschaften" in SSMS. Möglicherweise führen Sie eine Abfrage wie diese aus, um Membermetadaten 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 kontextbezogene systeminterne Eigenschaften

Das folgende Beispiel ist die vollständige Liste der nicht kontextabhängigen systeminternen Eigenschaften. Klicken Sie nach dem Ausführen der Abfrage in SSMS auf einzelne Member, um Eigenschaften im Dialogfeld "Membereigenschaften" 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 Membereigenschaften als Daten in einem Resultset

Im folgenden Beispiel wird die übersetzte Beschriftung für das Produktkategorieelement in der Produktdimension im Adventure Works-Cube für angegebene 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]  
  

Siehe auch

PeriodEnToDate (MDX)
Untergeordnete Elemente (MDX)
Hierarchize (MDX)
Anzahl (Set) (MDX)
Filter (MDX)
AddCalculatedMembers (MDX)
DrilldownLevel (MDX)
Eigenschaften (MDX)
PrevMember (MDX)
Verwenden von Membereigenschaften (MDX)
MDX-Funktionsreferenz (MDX)