• Article

Élément Create (XMLA)

Contient des éléments ASSL (Analysis Services Scripting Language) utilisés par la méthode Execute pour créer des objets dans une instance Microsoft SQL Server 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

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

ObjectDefinition, ParentObject

Attributs

Attribut

Description

AllowOverwrite

Attribut Boolean facultatif. S'il possède la valeur 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.

Scope

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 conservés dans l'instance Analysis Services. Les valeurs suivantes sont disponibles :

  • Session

    Les objets définis dans l'élément ObjectDefinition existent uniquement pendant la durée de la session XMLA (XML for Analysis).

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

Notes

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 considéré comme l'instance 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="https://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>

Voir aussi

Concepts

Commandes (XMLA)