共用方式為

Alter 元素 (XMLA)

  • 發行項

包含「Analysis Services 指令碼語言」(ASSL) 元素，而這些元素可讓 Execute 方法用來更改 Microsoft SQL Server Analysis Services 執行個體上的物件。

語法

<Command>
   <Alter Scope="enum" AllowCreate="boolean" ObjectExpansion="enum">
      <Object>...</Object>
      <ObjectDefinition>...</ObjectDefinition>
   </Alter>
</Command>

元素特性

特性

說明

資料類型和長度

無

預設值

無

基數

0-n：出現一次以上的選擇性元素。

元素關聯性

關聯性

元素

父元素

Command

子元素

Object、ObjectDefinition

屬性

屬性

說明

AllowCreate

(選擇性 Boolean 屬性) 指出是否應該建立 Alter 命令中定義的物件 (如果它們原本不存在的話)。

如果設定為 true，系統就會在 Analysis Services 執行個體上建立 ObjectDefinition 元素中定義的物件 (如果它們原本不存在的話)。 換言之，如果這些物件原本不存在執行個體上，Alter 命令就會被視為 Create 命令。

如果這個屬性被省略或設定為 false，當這些物件原本不存在時，就會發生錯誤。

ObjectExpansion

(選擇性 Enum 屬性) 定義要由 Execute 方法執行的更改範圍。

如果設定為 ObjectProperties，ObjectDefinition 元素應該僅包含要更改之主要物件 (包括從屬次要物件) 的完整定義。 要更改之物件的從屬主要物件會維持不變。

[!附註]

當您使用 ObjectProperties 設定搭配 ClrAssembly 資料類型時，不需要指定相關聯 ClrAssemblyFile 資料類型的 Data 元素。 如果沒有指定，ClrAssembly 就會使用現有檔案。

如果設定為 ExpandFull，ObjectDefinition 元素不僅包含要更改之物件的定義，還會包含屬於要更改之物件下階的所有主要物件的定義。

[!附註]

ExpandFull 設定無法搭配 Server 元素使用。

Scope

(選擇性 Enum 屬性) 定義 ObjectDefinition 元素中定義之物件的持續時間。

如果設定為 Session，ObjectDefinition 元素中定義的物件只會在 XMLA 工作階段的持續時間內存在。

[!附註]

當您使用 Session 設定時，ObjectDefinition 元素只能包含 Dimension、Cube 或 MiningModel ASSL 元素。

如果這屬性被省略，ObjectDefinition 元素中定義的物件就會保存在 Analysis Services 執行個體上。

備註

每個 Alter 命令都會變更 ParentObject 元素所指定之父物件底下某個主要物件的定義。

請參閱

概念

命令 (XMLA)