MDX-Datendefinition – ALTER CUBE
Ä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).