Freigeben über

MDX-Datendefinition – ALTER CUBE

  • Artikel

Ändert die Struktur eines angegebenen Cubes, der normalerweise verwendet wird, um das Rückschreiben von Dimensionen zu unterstützen. Weitere Informationen zum Verwenden des Rückschreibens in einer Anwendung finden Sie in diesem Blogbeitrag: Erstellen einer Rückschreibanwendung mit Analysis Services (Blog)

Gleichzeitige Rückschreibevorgänge für Dimensionen können zu einem Deadlock führen. Dabei wird die erste Rückschreibung aufgrund der durch die zweite Rückschreibung aufrechterhaltene gemeinsame Sperre für ein Commit blockiert. In diesem Fall wird zwar kein Fehler generiert, allerdings kann keiner der Vorgänge fortgesetzt werden. Schließlich tritt für beide Rückschreibevorgänge ein Timeout auf, und es wird ein Rollback der Änderungen ausgeführt.

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.

Bemerkungen

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 berechneter Elemente, benannter Mengen, Aktionen und Zellenberechnungen finden Sie unter DROP MEMBER-Anweisung (MDX),DROP SET-Anweisung (MDX),DROP ACTION-Anweisung (MDX) und DROP CELL CALCULATION Statement (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.

Bemerkungen

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 Statement (MDX).

Weitere Informationen

MDX-Datendefinitionsanweisungen (MDX)