Élément Alter (XMLA)

Article
05/08/2023

Contient les éléments ASSL (Analysis Services Scripting Language) utilisés par la méthode Execute pour modifier des objets sur une instance de 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	None
Valeur par défaut	None
Cardinalité	0-n : élément facultatif pouvant apparaître plusieurs fois.

Relations d’éléments

Relation	Élément
Éléments parents	Commande
É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à. Si la valeur est true, les objets définis dans l’élément ObjectDefinition sont créés sur 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 : quand vous utilisez le paramètre ObjectProperties avec le type de données ClrAssembly , l’élément de données des types de données ClrAssemblyFile associés n’a pas besoin d’être spécifié. 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 : le paramètre ExpandFull ne peut pas être utilisé avec l’élément Server .
Étendue	(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 : quand vous utilisez le paramètre session , l’élément ObjectDefinition peut contenir uniquement des éléments dimension, cubeou MiningModel ASSL. Si cet attribut est omis, les objets définis dans l’élément ObjectDefinition sont rendus persistants sur l’instance Analysis Services.

Remarques

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

Partager via