ALTER CUBE-Anweisung (MDX)

Ändert die Struktur eines bestimmten Cubes, normalerweise, um das Rückschreiben von Dimensionen zu unterstützen. Weitere Informationen zum Verwenden der Rückschreibefunktion in einer Anwendung finden Sie im Blogbeitrag Erstellen einer Rückschreibeanwendung mit Analysis Services (Blog).

Wenn zwei Rückschreibevorgänge für Dimensionen gleichzeitig ausgeführt werden, kann ein Deadlock auftreten, bei dem ein Commit für den ersten Rückschreibevorgang blockiert wird, weil vom zweiten Rückschreibevorgang eine gemeinsame Sperre aufrechterhalten wird. In diesem Fall wird weder ein Fehler ausgegeben, noch kann einer der Vorgänge fortgesetzt werden. Schließlich verursachen beide Vorgänge ein Timeout, sodass ein Rollback der Änderungen ausgeführt wird.

Syntax

ALTER CUBE
      Cube_Name | CURRENTCUBE
      <alter clause> 
            [ < alter clause> ...n]
 
< alter clause> ::= 
   <create dimension member clause> 
  | <remove dimension member clause>
  | <move dimension member clause> 
    | <update clause> 
    | <create cell calculation clause>
 
<create dimension member clause> ::=
CREATE DIMENSION MEMBER [ParentName.]MemberName
    , [[KEY = Key_Value] 
    | [Property_Name = Property_Value[, ...n]]
 
<dropping clause>::=
DROP 
      DIMENSION MEMBER Member_Name  
            Member_Name ...n ] 
      [WITH DESCENDANTS]
      | [ SESSION ] [ CALCULATED ] MEMBER Member_Name 
                  [ ,Member_Name,...n ] 
    | SET Set_Name
                  [ ,Set_Name,...n ] 
    | [ SESSION ] CELL CALCULATION CellCalc_Name
                  [ ,CellCalc_Name,...n ] 
    | ACTION Action_Name
 
<move dimension member clause> ::=
MOVE DIMENSION MEMBER MemberName
        [, SKIPPED_LEVELS = Unsigned_Integer] 
      [WITH DESCENDANTS]
    UNDER ParentName    
 
<update clause> ::=
UPDATE 
    CUSTOM ROLLUP FOR MEMBER MemberName 
      [,MemberName, ...n] AS MDX_Expression
   | DIMENSION Dimension_Name | Hierarchy_Name
      , DEFAULT_MEMBER = MDX_Expression
   | DIMENSION MEMBER MemberName AS
   [MDX_Expression]
   [Property_Name = Property_Value[, ...n]]
 
<create cell calculation clause>::=
CELL CALCULATION Calculation_Name 
   FOR Set_Expression AS MDX_Expression 
            [ [ CONDITION = 'Logical_Expression' ] 
    | [ DISABLED = { TRUE | FALSE } ] 
    | [ DESCRIPTION =String ] 
    | [ CALCULATION_PASS_NUMBER = Integer] 
    | [ CALCULATION_PASS_DEPTH = Integer] 
    | [ SOLVE_ORDER = Integer] 
    | [ Calculation_Name= Scalar_Expression ], ...n]

Erstellen eines Dimensionselements

Der zugrunde liegenden Dimensionstabelle wird eine neue Zeile hinzugefügt.

Argumente

• ParentName
  Ein gültiger Zeichenfolgenausdruck, der, sofern das neue Dimensionselement nicht auf der Stammebene erstellt wird, den Namen des ihm übergeordneten Elements bereitstellt.

• MemberName
  Ein gültiger Zeichenfolgenausdruck, der einen Elementnamen bereitstellt.

• Key_Value
  Ein gültiger Skalarausdruck, der den Schlüsselwert des neuen Dimensionselements definiert.

• Property_Name
  Ein gültiger MDX-Bezeichner (Multidimensional Expressions), der eine Elementeigenschaft darstellt.

• Property_Value
  Ein gültiger MDX-Skalarausdruck (Multidimensional Expressions), der den Wert der Eigenschaft eines berechneten Elements definiert.

Löschen eines Dimensionselements

Beim Löschen eines Dimensionselements aus einer Dimension mit aktiviertem Schreibzugriff wird das Element sowie die dazugehörige Zeile in der zugrunde liegenden Dimensionstabelle gelöscht.

Argumente

• Cube_Name
  Ein gültiger Zeichenfolgenausdruck, der einen Cubenamen bereitstellt.

• Member_Name
  Ein gültiger Zeichenfolgenausdruck, der einen Elementnamen oder Elementschlüssel bereitstellt.

Hinweise

Wenn die WITH DESCENDANTS-Klausel nicht verwendet wird, werden aus den untergeordneten Elementen eines gelöschten Elements untergeordnete Elemente des diesem übergeordneten Elements. Wenn die WITH DESCENDANTS-Klausel verwendet wird, werden alle nachfolgenden Werte einschließlich ihrer Zeilen in der Dimensionstabelle ebenfalls gelöscht.

Hinweis
Informationen zum Löschen von berechneten Elementen, benannten Mengen, Aktionen und Zellenberechnungen finden Sie unter DROP MEMBER-Anweisung (MDX), DROP SET-Anweisung (MDX), DROP ACTION-Anweisung (MDX) und DROP CELL CALCULATION-Anweisung (MDX).

Aktualisieren des Standardelements einer Dimension

Diese Klausel aktualisiert das Standardelement eines Cubes und wird im MDX-Berechnungsskript zum Definieren eines Standardelements verwendet. Das Standardelement kann für die Datenbankdimension, eine Cubedimension oder einen Anmeldenamen angegeben werden. Das Standardelement kann auch während einer Sitzung geändert werden.

Argumente

• Dimension_Name
  Eine gültige Zeichenfolge, die den Namen einer Dimension bereitstellt.

• MDX_Expression
  Ein gültiger MDX-Ausdruck, der ein einzelnes Element zurückgibt.

Hinweise

Der angegebene MDX-Ausdruck kann statisch oder dynamisch sein.

Verschieben eines Dimensionselements

In der zugrunde liegenden Dimensionstabelle wird eine Zeile geändert.

Argumente

• ParentName
  Ein gültiger Zeichenfolgenausdruck, der den Namen des neuen übergeordneten Elements des zu verschiebenden Dimensionselements bereitstellt.

• MemberName
  Ein gültiger Zeichenfolgenausdruck, der einen Elementnamen bereitstellt.

• Unsigned_Integer
  Eine gültige Zahl, die die Anzahl der auszulassenden Ebenen angibt.

Wenn die WITH DESCENDANTS-Klausel angegeben ist, wird die gesamte Struktur verschoben. Wenn die WITH DESCENDANTS-Klausel nicht angegeben ist, werden aus den untergeordneten Elementen des verschobenen übergeordneten Elements untergeordnete Elemente des dem verschobenen Element übergeordneten Elements. Die Verschiebung wirkt sich einfach dahin gehend aus, dass die Werte der übergeordneten Schlüsselspalte in der zugrunde liegenden Dimensionstabelle aktualisiert werden.

Aktualisieren eines Dimensionselements

Mit der UPDATE DIMENSION MEMBER-Klausel können Sie Eigenschaften eines Elements sowie die einem Element zugeordnete benutzerdefinierte Elementformel ändern.

Argumente

• MemberName
  Ein gültiger Zeichenfolgenausdruck, der einen Elementnamen bereitstellt.

• MDX_Expression
  Ein gültiger MDX-Ausdruck, der ein einzelnes Element zurückgibt.

• Property_Value
  Ein gültiger MDX-Skalarausdruck, der den Wert der Eigenschaft eines berechneten Elements definiert.

Erstellen einer Zellenberechnung

Weitere Informationen zum Erstellen einer Zellenberechnung mithilfe der ALTER CUBE-Anweisung finden Sie unter DROP CELL CALCULATION-Anweisung (MDX).

Siehe auch

Andere Ressourcen

MDX-Datendefinitionsanweisungen (MDX)