Article
09/27/2010

É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 MicrosoftSQL ServerAnalysis 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). Remarque Lorsque vous utilisez le paramètre Session, l'élément ObjectDefinition peut contenir uniquement les éléments ASSL Dimension, Cube ou MiningModel.

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).

Remarque

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)

Partager via