Élément Alter (XMLA)

Article
08/01/2012

Contient des éléments ASSL (Analysis Services Scripting Language) utilisés par la méthode Execute pour modifier des objets sur 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. [!REMARQUE] 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. [!REMARQUE] 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. [!REMARQUE] 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.

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.

[!REMARQUE]

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.

[!REMARQUE]

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.

[!REMARQUE]

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)

Partager via