MDX-Datendefinition – ALTER CUBE

Verändert die Struktur eines bestimmten Würfels, der typischerweise zur Unterstützung des Dimensions-Writebacks verwendet wird. Weitere Informationen zur Verwendung von Writeback in einer Anwendung finden Sie in diesem Blogbeitrag: Building a Writeback Application with Analysis Services (Blog)

Beachten Sie, dass Writebacks mit gleichzeitiger Dimension zu einem Deadlock führen können, bei dem der erste Writeback von einem Commit blockiert wird, weil die gemeinsame Sperre vom zweiten Writeback gehalten wird. In dieser Situation wird kein Fehler erzeugt, aber keine der Operationen kann voranschreiten. Schließlich gibt es beide Timeouts und die Änderungen werden rückgängig gemacht.

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]  

Erstellung eines Dimensionsmitglieds

Eine neue Zeile wird der zugrunde liegenden Dimensionstabelle hinzugefügt.

Arguments

ParentName
Ein gültiger String-Ausdruck, der den Namen des Elternteils des neuen Dimensionsmitglieds angibt, es sei denn, das Dimensionsmitglied wird an der Wurzel erstellt.

MitgliedsName
Ein gültiger String-Ausdruck, der einen Mitgliedsnamen liefert.

Key_Value
Ein gültiger skalarer Ausdruck, der den Schlüsselwert des neuen Dimensionsmitglieds definiert.

Property_Name
Ein gültiger Multidimensional Expressions (MDX)-Identifikator, der eine Mitgliedseigenschaft darstellt.

Property_Value
Ein gültiger Multidimensional Expressions (MDX) skalarer Ausdruck, der den Wert der berechneten Mitgliedseigenschaft definiert.

Entfernen eines Dimensionselements

Das Entfernen eines Dimensionsmitglieds aus einer schreibfähigen Dimension löscht das Element und seine entsprechende Zeile aus der zugrunde liegenden Dimensionstabelle.

Arguments

Cube_Name
Ein gültiger Zeichenkettenausdruck, der einen Würfelnamen angibt.

Member_Name
Ein gültiger String-Ausdruck, der einen Mitgliedsnamen oder einen Mitgliedsschlüssel angibt.

Bemerkungen

Wenn die Klausel "MIT NACHKOMMEN" nicht verwendet wird, werden die Kinder eines ausgeschiedenen Mitglieds zu Kindern des Elternteils des gestrichenen Mitglieds. Wenn die Klausel WITH DESCENDANTS verwendet wird, werden auch alle Nachkommen und ihre Zeilen in der Dimensionstabelle weggelassen.

Aktualisierung des Standard-Dimensionsmitglieds

Diese Klausel aktualisiert das Standardmitglied eines Würfels und wird im MDX-Berechnungsskript verwendet, um ein Standardmitglied zu definieren. Das Standardmitglied kann für die Datenbankdimension, eine Cube-Dimension oder für den Benutzer-Login angegeben werden. Das Standardmitglied kann auch während einer Sitzung gewechselt werden.

Arguments

Dimension_Name
Eine gültige Zeichenkette, die den Namen einer Dimension angibt.

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

Bemerkungen

Der angegebene MDX-Ausdruck kann statisch oder dynamisch sein.

Bewegung eines Dimensionselements

Eine Zeile wird in der zugrunde liegenden Dimensionstabelle modifiziert.

Arguments

ParentName
Ein gültiger String-Ausdruck, der den Namen des neuen Elternteils für das zu verschiebende Dimensionsmitglied angibt.

MitgliedsName
Ein gültiger String-Ausdruck, der einen Mitgliedsnamen liefert.

Unsigned_Ganzzahl
Eine gültige Zahl, die die Anzahl der Levels angibt, die übersprungen werden sollen.

Wenn die Klausel WITH DESCENDANTS angegeben ist, wird der gesamte Baum verschoben. Wenn die Klausel "Mit Nachkommen" nicht angegeben ist, werden die Kinder eines umgezogenen Elternteils zu den Kindern des umgezogenen Elternteils. Die Wirkung eines Umzugs besteht einfach darin, die Werte für die Spalte des übergeordneten Schlüssels in der zugrunde liegenden Dimensionstabelle zu aktualisieren.

Aktualisierung eines Dimensionsmitglieds

Die UPDATE Klausel DIMENSION MEMBER erlaubt es, Eigenschaften eines Mitglieds sowie die benutzerdefinierte Mitgliedsformel zu ändern, die einem Mitglied zugeordnet ist.

Arguments

MitgliedsName
Ein gültiger String-Ausdruck, der einen Mitgliedsnamen liefert.

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

Property_Value
Ein gültiger MDX-Skalarausdruck, der den Wert der berechneten Mitgliedseigenschaft definiert.

Erstellung einer Zellberechnung

Weitere Informationen zur Erstellung einer Zellberechnung mit der ALTER CUBE-Anweisung finden Sie unter DROP CELL CALCULATION Statement (MDX).

Siehe auch

MDX-Datendefinitionsanweisungen (MDX)