MDX-Datendefinition – CREATE SET

Erstellt eine benannte Menge mit Session-Scope für den aktuellen Würfel.

Syntax

  
CREATE [SESSION] [ STATIC | DYNAMIC ] [HIDDEN] SET   
   CURRENTCUBE | Cube_Name  
      .Set_Name AS 'Set_Expression'  
      [,Property_Name = Property_Value, ...n]  

Arguments

Cube_Name
Ein gültiger String-Ausdruck, der den Namen des Würfels liefert.

Set_Name
Ein gültiger String-Ausdruck, der den Namen für die zu erstellende benannte Menge liefert.

Set_Expression
Ein gültiger Multidimensional Expressions (MDX)-Ausdruck, der eine Menge zurückgibt.

Property_Name
Eine gültige Zeichenkette, die den Namen einer Mengeneigenschaft liefert.

Property_Value
Ein gültiger skalarer Ausdruck, der den Wert der Mengeneigenschaft definiert.

Bemerkungen

Eine benannte Menge ist eine Menge von Dimensionsmitgliedern (oder ein Ausdruck, der eine Menge definiert), die Sie erstellen, um sie erneut zu verwenden. Zum Beispiel ermöglicht eine benannte Menge es, eine Menge von Dimensionsmitgliedern zu definieren, die aus der Menge der zehn größten Filialen nach Umsatz bestehen. Diese Menge kann statisch oder mittels einer Funktion wie TopCount definiert werden. Diese benannte Menge kann dann überall dort verwendet werden, wo die Liste der Top 10 Stores benötigt wird.

Die CREATE-Anweisung SET erstellt eine benannte Menge, die während der gesamten Sitzung verfügbar bleibt und daher in mehreren Abfragen einer Sitzung verwendet werden kann. Weitere Informationen finden Sie unter Erstellung Session-Scoped berechneter Mitglieder (MDX).

Man kann auch eine benannte Menge für eine einzelne Abfrage definieren. Um eine solche Menge zu definieren, verwendet man die WITH-Klausel in der SELECT-Anweisung. Für weitere Informationen zur WITH-Klausel siehe Creating Query-Scoped Named Sets (MDX).

Die Set_Expression-Klausel kann jede Funktion enthalten, die MDX-Syntax unterstützt. Sets, die mit der CREATE-Anweisung SET erstellt werden und die SESSION-Klausel nicht spezifizieren, haben einen Sitzungsbereich. Verwenden Sie die WITH-Klausel, um eine Menge mit Abfragebereich zu erstellen.

Die Angabe eines anderen Würfels als des aktuell verbundenen Würfels verursacht einen Fehler. Daher solltest du CURRENTCUBE anstelle eines Cube-Namens verwenden, um den aktuellen Cube zu kennzeichnen.

Geltungsbereich

Eine benutzerdefinierte Menge kann innerhalb eines der in der folgenden Tabelle aufgeführten Scopes auftreten.

Abfragebereich
Die Sichtbarkeit und Lebensdauer des Sets sind auf die Abfrage beschränkt. Die Menge wird in einer individuellen Abfrage definiert. Der Abfragebereich überschreibt den Sitzungsumfang. Weitere Informationen finden Sie unter Erstellung Query-Scoped benannten Sets (MDX).

Umfang der Sitzungen
Die Sichtbarkeit und Lebensdauer des Sets sind auf die Session beschränkt, in der es erstellt wird. (Die Lebensdauer ist kürzer als die Sitzungsdauer, wenn eine DROP-Anweisung SET auf dem Set ausgegeben wird.) Die CREATE-Anweisung SET erstellt eine Menge mit Session-Scope. Verwenden Sie die WITH-Klausel, um eine Menge mit Abfragebereich zu erstellen.

Example

Das folgende Beispiel erstellt eine Menge namens Core Products. Die SELECT-Abfrage demonstriert dann, wie die neu erstellte Menge aufgerufen wird. Die CREATE-Anweisung SET muss ausgeführt werden, bevor die SELECT-Abfrage ausgeführt werden kann – sie können nicht im selben Batch ausgeführt werden.

CREATE SET [Adventure Works].[Core Products] AS '{[Product].[Category].[Bikes]}'  
  
SELECT [Core Products] ON 0  
  FROM [Adventure Works]  

Set-Bewertung

Die Mengenbewertung kann so definiert werden, dass sie anders stattfindet; Sie kann so definiert werden, dass sie nur einmal bei der Mengenerstellung auftritt oder jedes Mal, wenn die Menge verwendet wird.

STATISCHE
Zeigt an, dass die Menge nur einmal zum Zeitpunkt der Auswertung der CREATE-Anweisung SET ausgewertet wird.

DYNAMIC
Gibt an, dass die Menge jedes Mal ausgewertet werden soll, wenn sie in einer Abfrage verwendet wird.

Sichtbarkeit festlegen

Die Menge kann für andere Nutzer sichtbar sein oder nicht, wenn sie den Würfel abfragen.

VERSTECKT
Es gibt an, dass die Menge für Nutzer, die den Würfel abfragen, nicht sichtbar ist.

Standardeigenschaften

Jede Menge hat eine Reihe von Standardeigenschaften. Wenn eine Client-Anwendung mit Analysis Services verbunden ist, werden die Standardeigenschaften entweder unterstützt oder können unterstützt werden, je nach Wahl des Administrators.

Grundstückskennzeichen Bedeutung
BILDUNTERSCHRIFT Eine Zeichenkette, die die Client-Anwendung als Bildunterschrift für die Menge verwendet.
DISPLAY_FOLDER Eine Zeichenkette, die den Pfad des Anzeigeordners identifiziert, den die Client-Anwendung zur Anzeige der Menge verwendet. Der Ordner-Level-Separator wird von der Client-Anwendung definiert. Für die von Analysis Services bereitgestellten Tools und Clients ist der Backslash (\) der Level-Trenner. Um mehrere Anzeigeordner für eine definierte Menge bereitzustellen, verwenden Sie ein Semikolon (;) zur Trennung der Ordner.

Siehe auch

DROP-Anweisung SET (MDX)
MDX-Datendefinitionsanweisungen (MDX)