MDX-Datendefinition – CREATE SET

Erstellt eine benannte Menge mit Sitzungsbereich für den aktuellen Cube.

Syntax

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

Argumente

Cube_name
Ein gültiger Zeichenfolgenausdruck, der den Namen des Cubes bereitstellt.

Set_Name
Ein gültiger Zeichenfolgenausdruck, der einen Namen für die zu erstellende benannte Menge bereitstellt.

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

Property_Name
Eine gültige Zeichenfolge, die den Namen einer Mengeneigenschaft bereitstellt.

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

Bemerkungen

Eine benannte Menge ist eine Menge von Dimensionselementen (oder ein Ausdruck, der eine Menge definiert), die Sie erstellen, um sie später wieder zu verwenden. Mit einer benannten Menge können Sie beispielsweise eine Menge von Dimensionselementen definieren, die aus den 10 umsatzstärksten Geschäften besteht. Dieser Satz kann statisch oder mithilfe einer Funktion wie TopCount definiert werden. Diese benannte Menge kann dann überall verwendet werden, wo die Menge der ersten 10 Geschäfte benötigt wird.

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

Sie können auch eine benannte Menge zum Verwenden in einer einzelnen Abfrage definieren. Zur Definition einer solchen Menge verwenden Sie die WITH-Klausel in der SELECT-Anweisung. Weitere Informationen zur WITH-Klausel finden Sie unter Creating Query-Scoped Named Sets (MDX).

Die Set_Expression-Klausel kann jede Funktion enthalten, die MDX-Syntax unterstützt. Mengen, die mit der CREATE SET-Anweisung ohne Angabe der SESSION-Klausel erstellt wurden, haben die Sitzung als Bereich. Verwenden Sie die WITH-Klausel, um eine Menge mit Abfragebereich zu erstellen.

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.

Bereich

Eine benutzerdefinierte Menge kann in einem der Bereiche auftreten, die in der folgenden Tabelle aufgeführt sind.

Abfragebereich
Die Sichtbarkeit und Lebensdauer der Menge ist auf die Abfrage beschränkt. Die Menge ist in einer einzelnen Abfrage definiert. Der Abfragebereich hat Vorrang vor dem Sitzungsbereich. Weitere Informationen finden Sie unter Creating Query-Scoped Named Sets (MDX).

Bereich einer Sitzung
Die Sichtbarkeit und Lebensdauer der Menge ist auf die Sitzung beschränkt, in der die Menge erstellt wurde. (Die Lebensdauer ist kleiner als die Sitzungsdauer, wenn eine DROP SET-Anweisung für den Satz ausgegeben wird.) Die CREATE SET-Anweisung erstellt einen Satz mit Sitzungsbereich. Verwenden Sie die WITH-Klausel, um eine Menge mit Abfragebereich zu erstellen.

Beispiel

Im folgenden Beispiel wird eine Menge mit dem Namen Core Products erstellt. Die SELECT-Abfrage veranschaulicht, wie die neu erstellte Menge aufgerufen wird. Die CREATE SET-Anweisung muss vor der SELECT-Abfrage ausgeführt werden – es können nicht beide im gleichen Batch ausgeführt werden.

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

Mengenauswertung

Die Mengenauswertung kann so definiert werden, dass sie auf unterschiedliche Weise ausgeführt wird, nämlich entweder einmal bei der Mengenerstellung oder bei jeder Verwendung der Menge.

STATIC
Gibt an, dass die Menge nur einmal ausgewertet wird, nämlich, wenn die CREATE SET-Anweisung ausgewertet wird.

DYNAMIC
Gibt an, dass die Menge bei jeder Verwendung in einer Abfrage ausgewertet wird.

Sichtbarkeit der Menge

Die Menge kann für andere Benutzer, die den Cube abfragen, sichtbar oder unsichtbar sein.

HIDDEN
Gibt an, dass die Menge für Benutzer, die den Cube abfragen, nicht sichtbar ist.

Standardeigenschaften

Jede Menge verfügt über Standardeigenschaften. Wenn eine Clientanwendung mit Analysis Services verbunden ist, werden die Standardeigenschaften entweder unterstützt oder nach Auswahl des Administrators unterstützt.

Eigenschaftsbezeichner	Bedeutung
CAPTION	Eine Zeichenfolge, die von der Clientanwendung als Beschriftung für die Menge verwendet wird.
DISPLAY_FOLDER	Eine Zeichenfolge, die den Pfad des Anzeigeordners angibt, der von der Clientanwendung zum Anzeigen der Menge verwendet wird. Das Trennzeichen für Ordnerebenen wird von der Clientanwendung definiert. Für die von Analysis Services bereitgestellten Tools und Clients ist der umgekehrte Schrägstrich (\) das Ebenentrennzeichen. Um mehrere Anzeigeordner für eine definierte Menge bereitzustellen, verwenden Sie ein Semikolon (;) als Trennzeichen für die Ordner.

Weitere Informationen

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