Élément Create (XMLA)

  • Article

Contient les éléments ASSL (Analysis Services Scripting Language) utilisés par la méthode Execute pour créer des objets sur une instance Analysis Services.

Syntaxe

  
<Command>  
   <Create Scope="enum" AllowOverwrite="boolean">  
      <ParentObject>...</ParentObject>  
      <ObjectDefinition>...</ObjectDefinition>  
   </Create>  
</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 ObjectDefinition, ParentObject

Attributs

Attribut Description
AllowOverwrite Attribut Boolean facultatif. Si la valeur est true, les objets définis dans l’élément ObjectDefinition peuvent remplacer des objets existants sur l’instance Analysis Services. Si cet attribut est omis ou possède la valeur False, la présence d'un objet existant génère une erreur.
Étendue Attribut Enum facultatif. Définit la durée des objets définis dans l'élément ObjectDefinition . Si cet attribut est omis, les objets définis dans l’élément ObjectDefinition sont rendus persistants sur l’instance Analysis Services. La valeur suivante est disponible :

Session: les objets définis dans l’élément ObjectDefinition existent uniquement pour la durée de la session XML for Analysis (XMLA).
Notez que lorsque vous utilisez le paramètre session , l’élément ObjectDefinition peut contenir uniquement des éléments dimension, cubeou MiningModel ASSL.

Remarques

Chaque opération Create crée un objet principal sous un parent défini par l'élément ParentObject . Si l’objet parent est omis, il est supposé être l’instance de Analysis Services de destination. Ceci génère une erreur si le parent d'un objet principal ne correspond pas à l'instance de destination.

Exemple

L’exemple suivant crée une base de données vide nommée test Database sur une instance de Analysis Services.

  
      <Create xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
   <ObjectDefinition>  
      <Database xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
         <Name>Test Database</Name>  
         <Description>A test database.</Description>  
      </Database>  
   </ObjectDefinition>  
</Create>