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 schreibaktivierten Dimensionen finden Sie unter Schreibaktivierte Dimensionen.

Einfügen neuer Mitglieder

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

Vor dem Erstellen des Befehls "Einfügen " sollten die folgenden Informationen verfügbar sein, damit die neuen Member eingefügt werden können:

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

• Das Dimensionsattribut, in das die neuen Mitglieder 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 Befehl "Einfügen" akzeptiert 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ären Operator, benutzerdefinierte Rollup-Eigenschaften und übersprungene Ebenen für ein einzelnes Mitglied bereit, das dem identifizierten Attribut hinzugefügt werden soll.

  Hinweis

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

Aktualisieren vorhandener Mitglieder

Der Befehl Aktualisieren aktualisiert vorhandene Member in angegebenen Attributen basierend auf Beziehungen mit anderen Membern in anderen Attributen in einer schreibfähigen Dimension. Der Befehl "Aktualisieren" kann Elemente auf andere Ebenen in Hierarchien verschieben, die in der Dimension enthalten sind, und kann verwendet werden, um übergeordnete und untergeordnete Hierarchien neu zu strukturieren, die durch übergeordnete Attribute definiert sind.

Bevor Sie den Befehl "Aktualisieren" erstellen, sollten Sie die folgenden Informationen für die Zu aktualisierenden Mitglieder zur Verfügung haben:

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

• Die Dimensionsattribute, in denen vorhandene Mitglieder 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 Befehl "Aktualisieren" akzeptiert 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, welche ein oder mehrere Attributselemente enthält, um die Attribute zu identifizieren, in denen die Mitglieder aktualisiert werden sollen. Das Attribut-Element identifiziert ein Attribut und stellt den Namen, Wert, Übersetzungen, unären Operator, 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 Attributelement müssen eingeschlossen werden. Andernfalls kann ein Fehler auftreten.

• Die Where-Eigenschaft, die ein oder mehrere Attributelemente enthält, die Attribute einschränken, in denen die 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 Member im Attribut "Customer" angibt, für die die Mitglieder im Attribut "City" geändert werden sollen. Wenn Sie die "Where"-Eigenschaft nicht angeben, hätte jeder Kunde, dessen Stadtname derzeit Redmond ist, den Stadtnamen in Bellevue nach Ausführung des Update-Befehls.

  Hinweis

  Mit Ausnahme neuer Member kann der Befehl "Aktualisieren" 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 Elterneigenschaften

Um übergeordnete Attribute zu unterstützen, verwendet der Befehl Update die optionalen MoveWithDescendants-Eigenschaften. Durch Festlegen der MoveWithDescendants-Eigenschaft auf "true" 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 Befehl "Aktualisieren " keine Elemente in anderen Attributen aktualisieren.

Entfernen vorhandener Mitglieder

Bevor Sie den Befehl "Ablegen " erstellen, sollten Die folgenden Informationen verfügbar sein, damit die Mitglieder gelöscht werden können:

• Die Dimension, in der vorhandene Mitglieder zu entfernen sind.

• Die Dimensionsattribute, in denen vorhandene Mitglieder entfernt werden sollen.

• 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 akzeptiert nur zwei erforderliche Eigenschaften:

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

• Die Where-Eigenschaft, die mindestens ein Attributselement enthält, um die Attribute einzuschränken, in denen Mitglieder gelöscht werden sollen. Die Where-Eigenschaft ist entscheidend, um einen Drop-Befehl auf bestimmte Instanzen eines Elements zu beschränken. Wenn der Befehl "Wo" 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 angeben, die die drei Elemente im Attribut "Customer" identifiziert, die entfernt werden sollen, und das Element "Redmond" des Attributs "City", aus dem die drei Kunden entfernt werden sollen. Wenn die Where-Eigenschaft nur das Element "Redmond" des Attributs "City" angibt, wird jeder Kunde, der Redmond zugeordnet ist, vom Befehl 'Ablegen' entfernt. Wenn die Where-Eigenschaft nur die drei Mitglieder im Customer-Attribut angibt, werden die drei Kunden vollständig vom Befehl "Ablegen" gelöscht.

  Hinweis

  Die attribute-Elemente, die in einem Drop-Befehl enthalten sind, dürfen nur die AttributeName- und Keys-Eigenschaften enthalten. Andernfalls kann ein Fehler auftreten.

Entfernen von Elementen aus ü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.

Siehe auch

Drop-Element (XMLA)
Einfügen von Element (XMLA)
Updateelement (XMLA)
Definieren und Identifizieren von Objekten (XMLA)
Entwickeln mit XMLA in Analysis Services