Freigeben über

  • Artikel

CREATE SET-Anweisung (MDX)

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.

Hinweise

Eine benannte Menge ist eine Menge von Dimensionselementen (oder ein Ausdruck, der eine Menge definiert), die Sie für die wiederholte Verwendung erstellen. Mit einer benannten Menge können Sie beispielsweise eine Menge von Dimensionselementen definieren, die aus den 10 umsatzstärksten Geschäften besteht. Diese Menge kann statisch oder mithilfe einer Funktion wie TopCount definiert werden. Diese benannte Menge kann anschließend immer dann verwendet werden, wenn die Menge der zehn führenden Geschäfte benötigt wird.

Die CREATE SET-Anweisung erstellt eine benannte Menge, die während der gesamten Sitzung verfügbar bleibt und somit für mehrere Abfragen innerhalb einer Sitzung verwendet werden kann. Weitere Informationen finden Sie unter Erstellen berechneter Elemente im Bereich einer Sitzung (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 Erstellen benannter Mengen im Bereich einer Abfrage (MDX).

Die Set_Expression-Klausel kann jede Funktion enthalten, die 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.

  • Bereich einer Abfrage
    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 Erstellen benannter Mengen im Bereich einer Abfrage (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 geringer als die Dauer der Sitzung, wenn eine DROP SET-Anweisung für die Menge ausgeführt wird.) Die CREATE SET-Anweisung erstellt eine Menge im Bereich einer Sitzung. Verwenden Sie die WITH-Klausel, um eine Menge mit Abfragebereich zu erstellen.

  • Globaler Bereich
    Um eine benannte Menge zu erstellen, deren Bereich über den Kontext der Benutzersitzung hinausgeht und stattdessen der Lebensdauer der ausgeführten Instanz entspricht, verwenden Sie die CREATE SET-Anweisung innerhalb des MDX-Standardskripts. Weitere Informationen finden Sie unter Grundlegendes MDX-Skript (MDX). Eine im MDX-Standardskript mit CREATE SET definierte benannte Menge steht allen Benutzern in jeder Sitzung für alle MDX-Abfragen zur Verfügung.

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.

Weitere Informationen finden Sie unter Erstellen von benannten Mengen in MDX (MDX).

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 MicrosoftAnalysis Services verbunden ist, werden die Standardeigenschaften je nach Festlegung durch den Administrator entweder unterstützt oder sind verfügbar, um unterstützt zu werden.

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 wird der umgekehrte Schrägstrich (\) als Ebenentrennzeichen verwendet. Um mehrere Anzeigeordner für eine definierte Menge bereitzustellen, verwenden Sie ein Semikolon (;) als Trennzeichen für die Ordner.