项目
12/14/2010

插入、更新和删除成员 (XMLA)

可以使用 XML for Analysis (XMLA) 中的 Insert、Update 和 Drop 命令，从启用写操作的维度中分别插入、更新或删除成员。有关启用写操作的维度的详细信息，请参阅启用写操作的维度。

插入新成员

Insert 命令可将新成员插入启用写操作的维度的指定特性中。

构造 Insert 命令之前，应提供要插入的新成员的以下信息：

要在其中插入新成员的维度。
要在其中插入新成员的维度特性。
新成员的名称，包括该名称的所有适用翻译。
新成员的键。如果某特性使用一个组合键，则该键可能需要多个值。
不作为该维度内的其他特性实现的所有适用特性属性的值。此类特性属性包括一元运算符、翻译、自定义汇总、自定义汇总属性以及已跳过的级别。

Insert 命令仅具有两个属性：

Object 属性，它包含对要在其中插入成员的维度的对象引用。该对象引用包含维度的数据库标识符、多维数据集标识符和维度标识符。
Attributes 属性，它包含用于标识要在其中插入成员的特性的一个或多个 Attribute 元素。每个 Attribute 元素都标识一个特性，并为要添加到已标识特性的单个成员提供名称、值、翻译、一元运算符、自定义汇总、自定义汇总属性以及已跳过的级别。

注意

必须包括 Attribute 元素的所有属性。否则，可能会出错。

注意
必须包括 Attribute 元素的所有属性。否则，可能会出错。

更新现有成员

Update 命令可在已启用写操作的维度中根据指定特性中现有成员与其他特性中其他成员的关系更新现有成员。Update 命令可将成员移到维度所包含层次结构中的其他级别，并可用于重新组织父特性所定义的父子层次结构。

构造 Update 命令之前，应提供要更新的成员的以下信息：

要在其中更新现有成员的维度。
要在其中更新现有成员的维度特性。
现有成员的键。如果某特性使用一个组合键，则该键可能需要多个值。
不作为该维度内的其他特性实现的所有适用特性属性的值。此类特性属性包括一元运算符、翻译、自定义汇总、自定义汇总属性以及已跳过的级别。

Update 命令仅具有三个必需属性：

Object 属性，它包含对要在其中更新成员的维度的对象引用。该对象引用包含维度的数据库标识符、多维数据集标识符和维度标识符。
Attributes 属性，它包含用于标识要在其中更新成员的特性的一个或多个 Attribute 元素。Attribute 元素可标识一个特性，并为已标识特性中更新的单个成员提供名称、值、翻译、一元运算符、自定义汇总、自定义汇总属性以及已跳过的级别。

注意

必须包括 Attribute 元素的所有属性。否则，可能会出错。

注意
必须包括 Attribute 元素的所有属性。否则，可能会出错。

Where 属性，它包含用于约束要在其中更新成员的特性的一个或多个 Attribute 元素。Where 属性对于将 Update 命令限制于某成员的特定实例来说至关重要。如果不指定 Where 属性，则将更新给定成员的所有实例。例如，有三个客户，您希望将他们的市县名称从 Redmond 更改为 Bellevue。若要更改市县名称，您必须提供 Where 属性，该属性将标识 Customer 特性的三个成员中应更改其 City 特性的成员。如果您不提供此 Where 属性，则运行 Update 命令后，其市县名称当前为 Redmond 的每个客户的市县名称都将更改为 Bellevue。

注意
除了新成员以外，Update 命令只能更新 Where 子句中未包括的特性的特性键值。例如，更新客户时不能更新市县名称；否则，会更改所有客户的市县名称。

更新父特性中的成员

为了支持父特性，Update 命令具有可选的 MoveWithDescendants 属性。如果将 MoveWithDescendants 属性设置为 True，则表示当父成员的标识符发生更改时，该父成员的后代也应与该父成员一起移动。如果将此值设置为 False，则移动某父成员将导致该父成员的直接后代提升到该父成员先前所处的级别。

更新父特性中的成员时，Update 命令无法更新其他特性中的成员。

删除现有成员

构造 Drop 命令之前，应该提供要删除的成员的以下信息：

要在其中删除现有成员的维度。
要在其中删除现有成员的维度特性。
要删除的现有成员的键。如果某特性使用一个组合键，则该键可能需要多个值。

Drop 命令仅具有两个必需属性：

Object 属性，它包含对要在其中删除成员的维度的对象引用。该对象引用包含维度的数据库标识符、多维数据集标识符和维度标识符。
Where 属性，它包含用于约束要在其中删除成员的特性的一个或多个 Attribute 元素。Where 属性对于将 Drop 命令限制于某成员的特定实例来说至关重要。如果不指定 Where 命令，则将删除给定成员的所有实例。例如，您希望从 Redmond 中删除三个客户。若要删除这三个客户，您必须提供 Where 属性，该属性将标识 Customer 特性中要删除的三个成员，以及要在其中删除三个客户的 City 特性的 Redmond 成员。如果 Where 属性仅指定 City 特性的 Redmond 成员，则 Drop 命令将删除与 Redmond 关联的每个客户。如果 Where 属性仅指定 Customer 特性中的三个成员，则 Drop 命令会将这三个客户全部删除。

注意

Drop 命令中包含的 Attribute 元素必须仅包含 AttributeName 和 Keys 属性。否则，可能会出错。