Élément Create (XMLA)

Article
05/08/2023

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.

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>

Partager via