發行項
09/24/2010

插入、更新和卸除成員 (XMLA)

您可以使用 XML for Analysis (XMLA) 中的 Insert、Update 和 Drop 命令，從可寫入的維度分別插入、更新或是刪除成員。如需有關可寫入維度的詳細資訊，請參閱＜可寫入維度＞。

插入新成員

Insert 命令會將新的成員插入可寫入維度中的特定屬性。

在建構 Insert 命令之前，您應該有下列可用於插入新成員的資訊：

要在其中插入新成員的維度。
要在其中插入新成員的維度屬性。
新成員的名稱，包括任何適用的名稱翻譯。
新成員的索引鍵。如果屬性使用複合索引鍵，索引鍵可能需要多個值。
並未像其他的屬性已實作在維度中，但適用的任何屬性值。這樣的屬性包括一元運算、翻譯、自訂積存、自訂積存屬性以及略過的層級。

Insert 命令只使用兩個屬性：

Object 屬性，包含要在其中插入成員之維度的物件參考。物件參考包含資料庫識別碼、Cube 識別碼以及維度的維度識別碼。
Attributes 屬性，包含一或多個 Attribute 元素，以識別要在其中插入成員的屬性。每個 Attribute 元素可識別屬性，並為要加入識別屬性的單一成員提供名稱、值、翻譯、一元運算子、自訂積存、自訂積存屬性以及略過的層級。

[!附註]

Attribute 元素的所有屬性都必須包含在內。否則，系統可能會發生錯誤。

更新現有的成員

Update 命令會根據與其他屬性中其他成員的關係，在可寫入的維度之指定屬性中更新現有的成員。Update 命令可以將成員移到維度所含的階層中之其他層級，而且可用以重新設定父屬性所定義的父子式階層之結構。

在建構 Update 命令之前，您應該有下列可用於更新成員的資訊：

要在其中更新現有成員的維度。
要在其中更新現有成員的維度屬性。
現有成員的索引鍵。如果屬性使用複合索引鍵，索引鍵可能需要多個值。
並未像其他的屬性已實作在維度中，但適用的任何屬性值。這樣的屬性包括一元運算、翻譯、自訂積存、自訂積存屬性以及略過的層級。

Update 命令只使用三個必要的屬性：

Object 屬性，包含要在其中更新成員之維度的物件參考。物件參考包含資料庫識別碼、Cube 識別碼以及維度的維度識別碼。
Attributes 屬性，包含一或多個 Attribute 元素，以識別要在其中更新成員的屬性。Attribute 元素可識別屬性，並為識別屬性要更新的單一成員提供名稱、值、翻譯、一元運算子、自訂積存、自訂積存屬性以及略過的層級。

[!附註]

Attribute 元素的所有屬性都必須包含在內。否則，系統可能會發生錯誤。
Where 屬性包含一或多個 Attribute 元素，這類元素會限制要在其中更新成員的屬性。Where 屬性對於將 Update 命令限制在成員的特定執行個體來說十分重要。如果未指定 Where 屬性，指定成員的所有執行個體都會更新。例如，您要將三個客戶的城市名稱從 Redmond 變更為 Bellevue。若要變更城市名稱，您必須提供 Where 屬性以識別 Customer 屬性中應該變更的三個 City 屬性成員。如果您沒有提供這個 Where 屬性，則城市名稱目前為 Redmond 的每個客戶，在執行 Update 命令之後，其城市名稱都將變成 Bellevue。

[!附註]

除了新成員之外，Update 命令只能為不包含在 Where 子句中的屬性更新屬性索引鍵值。例如，更新客戶時無法更新城市名稱，否則會為所有客戶變更城市名稱。

更新父屬性中的成員

為了支援父屬性，Update 命令有選擇性的 MoveWithDescendantsMovewithDescedants 屬性。將 MoveWithDescendants 屬性設定為 true，以指定在該父成員識別碼變更時，父成員的下階也應該隨父成員一起移動。如果這個值是設定為 false，移動父成員會造成該父成員的直接下階升級為父成員先前所在的層級。

在父屬性中更新成員時，Update 命令無法更新其他屬性中的成員。

卸除現有的成員

在建構 Drop 命令之前，您應該有下列可用於卸除成員的資訊：

要在其中卸除現有成員的維度。
要在其中卸除現有成員的維度屬性。
要卸除之現有成員的索引鍵。如果屬性使用複合索引鍵，索引鍵可能需要多個值。

Drop 命令只使用兩個必要的屬性：

Object 屬性，包含要在其中卸除成員之維度的物件參考。物件參考包含資料庫識別碼、Cube 識別碼以及維度的維度識別碼。
Where 屬性包含一或多個 Attribute 元素，會限制要在其中刪除成員的屬性。Where 屬性對於將 Drop 命令限制在成員的特定執行個體來說十分重要。如果未指定 Where 命令，指定成員的所有執行個體都會卸除。例如，您要從 Redmond 卸除三個客戶。若要卸除這些客戶，您必須提供 Where 屬性以識別 Customer 屬性中要移除的三個成員，以及要從 City 屬性之 Redmond 成員中移除的三個客戶。如果 Where 屬性只指定 City 屬性的 Redmond 成員，則 Drop 命令會卸除與 Redmond 關聯的每個客戶。如果 Where 屬性只在 Customer 屬性中指定三個成員，則 Drop 命令會完全刪除這三個客戶。

[!附註]

包括在 Drop 命令中的 Attribute 元素必須只包含 AttributeName 與 Keys 屬性。否則，系統可能會發生錯誤。