CREATE MEMBER-Anweisung (MDX)
Erstellt ein berechnetes Element.
Syntax
CREATE [ SESSION ] [HIDDDEN] [ CALCULATED ] MEMBER CURRENTCUBE | Cube_Name.Member_Name
AS MDX_Expression
[,Property_Name = Property_Value, ...n]
......[,SCOPE_ISOLATION = CUBE]
Argumente
Cube_Name
Ein gültiger Zeichenfolgenausdruck, der den Namen des Cubes bereitstellt, in dem das Element erstellt wird.Member_Name
Ein gültiger Zeichenfolgenausdruck, der einen Elementnamen bereitstellt. Geben Sie einen vollqualifizierten Namen an, um ein Element in einer anderen Dimension als der Measures-Dimension zu erstellen. Wenn Sie keinen vollqualifizierten Elementnamen angeben, wird das Element in der Measures-Dimension erstellt.MDX_Expression
Ein gültiger MDX-Ausdruck (Multidimensional Expressions).Property_Name
Eine gültige Zeichenfolge, die den Namen einer Eigenschaft eines berechneten Elements bereitstellt.Property_Value
Ein gültiger Skalarausdruck, der den Wert der Eigenschaft eines berechneten Elements definiert.
Hinweise
Die CREATE MEMBER-Anweisung definiert berechnete Elemente, die während der gesamten Sitzung verfügbar sind und somit in mehreren Abfragen im Verlauf der Sitzung verwendet werden können. Weitere Informationen finden Sie unter Erstellen berechneter Elemente im Bereich einer Sitzung (MDX).
Sie können auch ein berechnetes Element definieren, das in einer einzelnen Abfrage verwendet wird. Wenn Sie ein berechnetes Element definieren möchten, das auf eine einzelne Abfrage beschränkt ist, verwenden Sie die WITH-Klausel in der SELECT-Anweisung. Weitere Informationen finden Sie unter Erstellen berechneter Elemente im Bereich einer Abfrage (MDX).
Property_Name kann auf standardmäßige oder auf optionale berechnete Elementeigenschaften verweisen. Standardelementeigenschaften sind in diesem Thema weiter unten aufgelistet. Berechnete Elemente, die mit CREATE MEMBER ohne einen SESSION-Wert erstellt wurden, haben den Gültigkeitsbereich Sitzung (Sitzungsbereich). Außerdem müssen Zeichenfolgen, die in der Definition eines berechneten Elements stehen, in doppelte Anführungszeichen gesetzt werden. Dies unterscheidet sich von der für OLE DB definierten Methode, die angibt, dass Zeichenfolgen in einfachen Anführungszeichen stehen müssen.
Die Angabe eines anderen als des aktuell verbundenen Cubes verursacht einen Fehler. Daher sollten Sie den aktuellen Cube mithilfe von CURRENTCUBE statt mit dem Cubenamen angeben.
Weitere Informationen zu Elementeigenschaften, die durch OLE DB definiert sind, finden Sie in der OLE DB-Dokumentation.
Bereich
Ein berechnetes Element kann in einem der Gültigkeitsbereiche auftreten, die in der folgenden Tabelle aufgeführt sind.
Bereich einer Abfrage
Die Sichtbarkeit und Lebensdauer des berechneten Elements ist auf die Abfrage beschränkt. Das berechnete Element ist in einer einzelnen Abfrage definiert. Der Abfragebereich hat Vorrang vor dem Sitzungsbereich. Weitere Informationen finden Sie unter Erstellen berechneter Elemente im Bereich einer Abfrage (MDX).Bereich einer Sitzung
Die Sichtbarkeit und Lebensdauer des berechneten Elements ist auf die Sitzung beschränkt, in der das Element erstellt wurde. (Die Lebensdauer ist geringer als die Dauer der Sitzung, wenn eine DROP MEMBER-Anweisung für das berechnete Element ausgegeben wird.) Die CREATE MEMBER-Anweisung erstellt ein berechnetes Element im Sitzungsbereich.
Bereichsisolation
Wenn ein MDX-Cubeskript (Multidimensional Expressions) berechnete Elemente enthält, werden die berechneten Elemente standardmäßig aufgelöst, bevor Berechnungen im Sitzungsbereich aufgelöst werden und bevor abfragedefinierte Berechnungen aufgelöst werden.
.gif "Hinweis") Hinweis |
|---|
In bestimmten Szenarien weisen die Aggregate (MDX)-Funktion und die VisualTotals (MDX)-Funktion dieses Verhalten nicht auf. |
Durch das Verhalten können in generischen Clientanwendungen Cubes mit komplexen Berechnungen verwendet werden, ohne dass die spezielle Implementierung der Berechnungen berücksichtigt werden muss. In bestimmten Szenarien möchten Sie jedoch möglicherweise berechnete Elemente im Sitzungs- oder Abfragebereich vor bestimmten Berechnungen im Cube ausführen, und weder die Aggregate-Funktion noch die VisualTotals-Funktion sind anwendbar. Um das zu erreichen, verwenden Sie die SCOPE_ISOLATION-Berechnungseigenschaft.
Beispiel
Das folgende Skript stellt ein Beispiel für ein Szenario dar, in dem die SCOPE_ISOLATION-Berechnungseigenschaft erforderlich ist, damit das richtige Ergebnis entsteht.
MDX-Skript des Cubes:
CREATE MEMBER CURRENTCUBE.Measures.ProfitRatio AS 'Measures.[Store Sales]/Measures.[Store Cost]', SOLVE_ORDER = 10
MDX-Abfrage:
WITH MEMBER [Customer].[Customers].[USA]. USAWithoutWA AS
[Customer].[Customers].[Country].&[USA] - [Customer].[Customers].[State Province.&[WA], SOLVE_ORDER=5
SELECT {USAWithoutWA} ON 0 FROM SALES
WHERE ProfitRatio
Das gewünschte Ergebnis der vorherigen Abfrage entspricht dem Verhältnis für die Verkäufe der USA ohne WA, damit die Kosten für die USA ohne WA gespeichert werden können. Die vorherige Abfrage gibt nicht das gewünschte Ergebnis zurück, sondern das Verhältnis für die USA abzüglich des Verhältnisses für WA. Dies stellt ein bedeutungsloses Ergebnis dar. Wenn das gewünschte Ergebnis erzielt werden soll, können Sie die SCOPE_ISOLATION-Berechnungseigenschaft verwenden.
MDX-Abfrage mit SCOPE_ISOLATION-Berechnungseigenschaft:
WITH MEMBER [Customer].[Customers].[USA]. USAWithoutWA AS
[Customer].[Customers].[Country].&[USA] - [Customer].[Customers].[State Province.&[WA], SOLVE_ORDER=5
,SCOPE_ISOLATION=CUBE
SELECT {USAWithoutWA} ON 0 FROM SALES
WHERE ProfitRatio
Standardeigenschaften
Jedes berechnete Element hat eine Reihe von Standardeigenschaften. Wenn eine Clientanwendung mit Microsoft Analysis Services verbunden ist, werden die Standardeigenschaften je nach Festlegung durch den Administrator entweder unterstützt oder sind verfügbar, um unterstützt zu werden.
Abhängig von der Cubedefinition sind möglicherweise weitere Elementeigenschaften verfügbar. Die folgenden Eigenschaften enthalten Informationen, die für die Dimensionsebene im Cube relevant sind.
Eigenschaftsbezeichner |
Bedeutung |
||
|---|---|---|---|
SOLVE_ORDER |
Die Reihenfolge, in der das berechnete Element in Fällen gelöst wird, in denen ein berechnetes Element auf ein anderes berechnetes Element verweist (also in Fällen, in denen berechnete Elemente sich überschneiden). |
||
FORMAT_STRING |
Eine Formatzeichenfolge im Microsoft Office-Stil, die die Clientanwendung für das Anzeigen von Zellwerten verwenden kann. |
||
VISIBLE |
Ein Wert, der bestimmt, ob das berechnete Element in einem Schemarowset sichtbar ist. Sichtbare berechnete Elemente können einer Menge mit der AddCalculatedMembers-Funktion hinzugefügt werden. Ein Wert ungleich 0 zeigt an, dass das berechnete Element sichtbar ist. Der Standardwert dieser Eigenschaft ist Visible. Berechnete Elemente, die nicht sichtbar sind (für die dieser Wert auf 0 festgelegt ist), werden üblicherweise als Zwischenschritte in komplexeren berechneten Elementen verwendet. Auf diese berechneten Elemente können auch andere Arten von Elementen (z. B. Measures) verweisen. |
||
NON_EMPTY_BEHAVIOR |
Das Measure oder die Menge, mit dem oder der beim Auflösen leerer Zellen das Verhalten berechneter Elemente bestimmt wird.
|
||
CAPTION |
Eine Zeichenfolge, die von der Clientanwendung als Beschriftung für das Element verwendet wird. |
||
DISPLAY_FOLDER |
Eine Zeichenfolge, die den Pfad des Anzeigeordners angibt, der von der Clientanwendung zum Anzeigen des Elements verwendet wird. Das Trennzeichen für Ordnerebenen wird von der Clientanwendung definiert. In den von Analysis Services bereitgestellten Tools und Clients wird der umgekehrte Schrägstrich (\) als Ebenentrennzeichen verwendet. Wenn Sie für ein definiertes Element mehrere Anzeigeordner angeben möchten, verwenden Sie ein Semikolon (;) um die Ordner zu trennen. |
||
ASSOCIATED_MEASURE_GROUP |
Der Name der Measuregruppe, der dieses Element zugeordnet wird. |
.gif "Vorsichtshinweis")
Vorsicht