• Article

Élément Alter (XMLA)

Contient des éléments ASSL (Analysis Services Scripting Language) utilisés par la méthode Execute pour modifier des objets dans une instance de Microsoft SQL Server Analysis Services.

Syntaxe

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

Caractéristiques de l'élément

Caractéristique

Description

Type de données et longueur

Aucun

Valeur par défaut

Aucune

Cardinalité

0-n : élément facultatif susceptible d'apparaître plusieurs fois.

Relations entre les éléments

Relation

Élément

Éléments parents

Command

Éléments enfants

Object, ObjectDefinition

Attributs

Attribut

Description

AllowCreate

(Attribut Boolean facultatif) Indique si les objets définis dans la commande Alter doivent être créés s'ils n'existent pas déjà.

S'il possède la valeur True, les objets définis dans l'élément ObjectDefinition sont créés dans l'instance Analysis Services s'ils n'existent pas déjà. En d'autres termes, la commande Alter est traitée comme une commande Create si les objets n'existent pas déjà dans l'instance.

Si cet attribut est omis ou possède la valeur false, une erreur survient si les objets n'existent pas déjà.

ObjectExpansion

(Attribut Enum facultatif) Définit l'étendue de la modification que doit effectuer la méthode Execute.

Si cet attribut est défini sur ObjectProperties, l'élément ObjectDefinition doit contenir uniquement la définition complète de l'objet principal à modifier, y compris les objets secondaires subordonnés. Les objets principaux subordonnés de l'objet à modifier restent inchangés.

RemarqueRemarque
Lorsque vous utilisez le paramètre ObjectProperties avec le type de données ClrAssembly, vous n'avez pas besoin de spécifier l'élément Data des types de données ClrAssemblyFile associés. Si vous ne le spécifiez pas, le type de données ClrAssembly utilise les fichiers existants.

Si cet attribut est défini sur ExpandFull, l'élément ObjectDefinition ne doit pas contenir seulement la définition de l'objet à modifier mais aussi les définitions de tous les objets principaux qui sont des descendants de l'objet à modifier.

RemarqueRemarque
Vous ne pouvez pas utiliser le paramètre ExpandFull avec l'élément Server.

Scope

(Attribut Enum facultatif) Définit la durée des objets définis dans l'élément ObjectDefinition.

S'il est défini sur Session, les objets définis dans l'élément ObjectDefinition existent uniquement pour la durée de la session XMLA.

RemarqueRemarque
Lorsque vous utilisez le paramètre Session, l'élément ObjectDefinition peut contenir uniquement les éléments ASSL Dimension, Cube ou MiningModel.

Si cet attribut est omis, les objets définis dans l'élément ObjectDefinition sont conservés dans l'instance Analysis Services.

Notes

Chaque commande Alter modifie la définition d'un objet principal sous l'objet parent spécifié par l'élément ParentObject.

Voir aussi

Concepts

Commandes (XMLA)