Einfügen, Aktualisieren und Löschen von Mitgliedern (XMLA)

Sie können die Befehle "Einfügen", " Aktualisieren" und " Ablegen " in XML for Analysis (XMLA) verwenden, um Elemente aus einer schreibfähigen Dimension einzufügen, zu aktualisieren oder zu löschen. Weitere Informationen zu schreibfähigen Dimensionen finden Sie unter Write-Enabled Dimensionen.

Einfügen neuer Elemente

Mit dem Insert Befehl werden neue Member in bestimmte Attribute in einer schreibfähigen Dimension eingefügt.

Bevor Sie den Insert Befehl erstellen, sollten Sie über die folgenden Informationen verfügen, damit die neuen Member eingefügt werden können:

• Die Dimension, in die die neuen Member eingefügt werden sollen.

• Das Dimensions-Attribut, in das die neuen Member eingefügt werden sollen.

• Die Namen der neuen Mitglieder, einschließlich aller anwendbaren Übersetzungen für den Namen.

• Die Schlüssel der neuen Mitglieder. Wenn ein Attribut einen zusammengesetzten Schlüssel verwendet, erfordert der Schlüssel möglicherweise mehrere Werte.

• Werte für alle anwendbaren Attributeigenschaften, die nicht als andere Attribute innerhalb der Dimension implementiert werden. Zu diesen Attributeigenschaften gehören unäre Vorgänge, Übersetzungen, benutzerdefinierte Rollups, benutzerdefinierte Rollupeigenschaften und übersprungene Ebenen.

Der Insert Befehl verwendet nur zwei Eigenschaften:

• Die Object-Eigenschaft , die einen Objektverweis für die Dimension enthält, in die die Member eingefügt werden sollen. Der Objektverweis enthält den Datenbankbezeichner, den Cubebezeichner und den Dimensionsbezeichner für die Dimension.

• Die Attributes-Eigenschaft , die mindestens ein Attributelement enthält, um die Attribute zu identifizieren, in die Elemente eingefügt werden sollen. Jedes Attribute Element identifiziert ein Attribut und stellt den Namen, wert, Übersetzungen, unäre Operator, benutzerdefinierte Rollup-, benutzerdefinierte Rollup-Eigenschaften und übersprungene Ebenen für ein einzelnes Element bereit, das dem identifizierten Attribut hinzugefügt werden soll.

  Hinweis

  Alle Eigenschaften für das Attribute Element müssen eingeschlossen werden. Andernfalls kann ein Fehler auftreten.

Aktualisieren vorhandener Member

Der Update Befehl aktualisiert vorhandene Member in angegebenen Attributen basierend auf Beziehungen mit anderen Membern in anderen Attributen in einer schreibfähigen Dimension. Der Update Befehl kann Elemente auf andere Ebenen in Hierarchien verschieben, die in der Dimension enthalten sind, und kann zum Umstrukturieren übergeordneter untergeordneter Hierarchien verwendet werden, die durch übergeordnete Attribute definiert sind.

Bevor Sie den Update Befehl erstellen, sollten Sie über die folgenden Informationen verfügen, damit die Member aktualisiert werden können:

• Die Dimension, in der vorhandene Member aktualisiert werden sollen.

• Die Dimensionsattribute, in denen vorhandene Member aktualisiert werden sollen.

• Die Schlüssel der vorhandenen Mitglieder. Wenn ein Attribut einen zusammengesetzten Schlüssel verwendet, erfordert der Schlüssel möglicherweise mehrere Werte.

• Werte für alle anwendbaren Attributeigenschaften, die nicht als andere Attribute innerhalb der Dimension implementiert werden. Zu diesen Attributeigenschaften gehören unäre Vorgänge, Übersetzungen, benutzerdefinierte Rollups, benutzerdefinierte Rollupeigenschaften und übersprungene Ebenen.

Der Update Befehl verwendet nur drei erforderliche Eigenschaften:

• Die Object Eigenschaft, die einen Objektverweis für die Dimension enthält, in der die Member aktualisiert werden sollen. Der Objektverweis enthält den Datenbankbezeichner, den Cubebezeichner und den Dimensionsbezeichner für die Dimension.

• Die Attributes Eigenschaft, die mindestens ein Attribute Element enthält, um die Attribute zu identifizieren, in denen Member aktualisiert werden sollen. Das Attribute Element identifiziert ein Attribut und stellt den Namen, wert, Übersetzungen, unärer Operator, benutzerdefinierte Rollup-, benutzerdefinierte Rollup-Eigenschaften und übersprungene Ebenen für ein einzelnes Element bereit, das für das identifizierte Attribut aktualisiert wurde.

  Hinweis

  Alle Eigenschaften für das Attribute Element müssen eingeschlossen werden. Andernfalls kann ein Fehler auftreten.

• Die Where-Eigenschaft , die ein oder Attribute mehrere Elemente enthält, die die Attribute einschränken, in denen Member aktualisiert werden sollen. Die Where Eigenschaft ist entscheidend, um einen Update Befehl auf bestimmte Instanzen eines Elements zu beschränken. Wenn die Where Eigenschaft nicht angegeben ist, werden alle Instanzen eines bestimmten Elements aktualisiert. Beispielsweise gibt es drei Kunden, für die Sie den Stadtnamen von Redmond nach Bellevue ändern möchten. Um den Ortsnamen zu ändern, müssen Sie eine Where Eigenschaft angeben, die die drei Elemente im Attribut "Customer" angibt, für die die Mitglieder im Attribut "City" geändert werden sollen. Wenn Sie diese Where Immobilie nicht angeben, hätte jeder Kunde, dessen Stadtname derzeit Redmond ist, den Stadtnamen von Bellevue nach ausführung des Update Befehls.

  Hinweis

  Mit Ausnahme neuer Member kann der Update Befehl nur Attributschlüsselwerte für Attribute aktualisieren, die nicht in der Where Klausel enthalten sind. Der Ortsname kann beispielsweise nicht aktualisiert werden, wenn ein Kunde aktualisiert wird; andernfalls wird der Ortsname für alle Kunden geändert.

Aktualisieren von Mitgliedern in übergeordneten Attributen

Um übergeordnete Attribute zu unterstützen, führt der Update Befehl die optionalen MoveWithDescendantsMovewithDescedants-Eigenschaften aus. Wenn Sie die MoveWithDescendants Eigenschaft auf "true" festlegen, wird angegeben, dass die Nachfolger des übergeordneten Elements auch mit dem übergeordneten Element verschoben werden sollen, wenn sich der Bezeichner dieses übergeordneten Elements ändert. Wenn dieser Wert auf "false" festgelegt ist, bewirkt das Verschieben eines übergeordneten Elements, dass die unmittelbaren Nachfolger dieses übergeordneten Elements auf die Ebene heraufgestuft werden, in der sich das übergeordnete Element zuvor befand.

Beim Aktualisieren von Mitgliedern in einem übergeordneten Attribut kann der Update Befehl keine Member in anderen Attributen aktualisieren.

Löschen vorhandener Member

Bevor Sie den Drop Befehl erstellen, sollten Sie über die folgenden Informationen verfügen, damit die Mitglieder gelöscht werden können:

• Die Dimension, in der vorhandene Member abzulegen sind.

• Die Dimensionsattribute, in denen vorhandene Member abzulegen sind.

• Die Schlüssel der vorhandenen Mitglieder, die gelöscht werden sollen. Wenn ein Attribut einen zusammengesetzten Schlüssel verwendet, erfordert der Schlüssel möglicherweise mehrere Werte.

Der Drop Befehl verwendet nur zwei erforderliche Eigenschaften:

• Die Object Eigenschaft, die einen Objektverweis für die Dimension enthält, in der die Member abgelegt werden sollen. Der Objektverweis enthält den Datenbankbezeichner, den Cubebezeichner und den Dimensionsbezeichner für die Dimension.

• Die Where Eigenschaft, die ein oder Attribute mehrere Elemente enthält, um die Attribute einzuschränken, in denen Elemente gelöscht werden sollen. Die Where Eigenschaft ist entscheidend, um einen Drop Befehl auf bestimmte Instanzen eines Elements zu beschränken. Wenn der Where Befehl nicht angegeben ist, werden alle Instanzen eines bestimmten Elements gelöscht. Beispielsweise gibt es drei Kunden, die Sie von Redmond ablegen möchten. Um diese Kunden abzulegen, müssen Sie eine Where Eigenschaft bereitstellen, die die drei Mitglieder im Attribut "Customer" identifiziert, die entfernt werden sollen, und das Redmond-Element des City-Attributs, aus dem die drei Kunden entfernt werden sollen. Wenn die Where Eigenschaft nur das Element "Redmond" des Attributs "City" angibt, wird jeder kunde, der Drop Redmond zugeordnet ist, vom Befehl gelöscht. Wenn die Where Eigenschaft nur die drei Elemente im Attribut "Customer" angibt, werden die drei Kunden vollständig vom Drop Befehl gelöscht.

  Hinweis

  Die Attribute in einem Drop Befehl enthaltenen Elemente dürfen nur die und Keys die AttributeName Eigenschaften enthalten. Andernfalls kann ein Fehler auftreten.

Ablegen von Elementen in übergeordneten Attributen

Durch Festlegen der DeleteWithDescendants-Eigenschaft wird angegeben, dass die Nachfolger eines übergeordneten Elements ebenfalls mit dem übergeordneten Element gelöscht werden sollen. Wenn dieser Wert auf "false" festgelegt ist, werden die unmittelbaren Nachfolger des übergeordneten Elements stattdessen auf die Ebene heraufgestuft, in der sich das übergeordnete Element vormals befindet.

Von Bedeutung

Ein Benutzer muss nur über Löschberechtigungen für das übergeordnete Mitglied verfügen, um sowohl das übergeordnete Element als auch dessen Nachfolger zu löschen. Ein Benutzer benötigt keine Löschberechtigungen für die Nachfolger.

Siehe auch

Drop-Element (XMLA)
Insert-Element (XMLA)
Update-Element (XMLA)
Definieren und Identifizieren von Objekten (XMLA)
Entwickeln mit XMLA in Analysis Services