Insertion, mise à jour et suppression de membres (XMLA)

Vous pouvez utiliser les commandes Insert, Updateet Drop dans XML for Analysis (XMLA) pour insérer, mettre à jour ou supprimer des membres dans une dimension activée en écriture. Pour plus d’informations sur les dimensions activées en écriture, consultez Dimensions activées en écriture.

Insertion de nouveaux membres

La commande Insert insère de nouveaux membres dans les attributs spécifiés dans une dimension activée en écriture.

Avant de construire la commande Insert , vous devez disposer des informations suivantes pour les nouveaux membres à insérer :

• la dimension dans laquelle les nouveaux membres doivent être insérés ;

• l'attribut de dimension dans lequel insérer les nouveaux membres ;

• les noms des nouveaux membres, y compris les éventuelles traductions applicables au nom ;

• les clés des nouveaux membres. Si un attribut utilise une clé composite, la clé peut nécessiter plusieurs valeurs.

• les valeurs des propriétés d'attribut applicables qui ne sont pas implémentées en tant qu'autres attributs au sein de la dimension. Ces propriétés d'attribut peuvent consister en des opérations unaires, des traductions, des cumuls personnalisés, des propriétés de cumul personnalisé et des niveaux ignorés.

La commande Insert ne prend que deux propriétés :

• La propriété de l' objet , qui contient une référence d’objet pour la dimension dans laquelle les membres doivent être insérés. La référence d'objet contient l'identificateur de base de données, l'identificateur de cube et l'identificateur de la dimension.

• La propriété Attributes , qui contient un ou plusieurs éléments attribute pour identifier les attributs dans lesquels les membres doivent être insérés. Chaque élément d' attribut identifie un attribut et fournit le nom, la valeur, les traductions, l’opérateur unaire, le cumul personnalisé, les propriétés de cumul personnalisé et les niveaux ignorés pour qu’un seul membre soit ajouté à l’attribut identifié.

  Notes

  Toutes les propriétés de l’élément attribute doivent être incluses. Sinon, une erreur risque de se produire.

Mise à jour de membres existants

La commande Update met à jour les membres existants dans les attributs spécifiés, en fonction des relations avec d’autres membres dans d’autres attributs, dans une dimension activée en écriture. La commande de mise à jour peut déplacer des membres vers d’autres niveaux dans les hiérarchies contenues dans la dimension et peut être utilisée pour restructurer les hiérarchies parent-enfant définies par les attributs parents.

Avant de construire la commande Update , vous devez disposer des informations suivantes pour les membres à mettre à jour :

• la dimension dans laquelle les membres existants doivent être mis à jour ;

• les attributs de la dimension dans lesquels les membres existants doivent être mis à jour ;

• les clés des membres existants. Si un attribut utilise une clé composite, la clé peut nécessiter plusieurs valeurs.

• les valeurs des propriétés d'attribut applicables qui ne sont pas implémentées en tant qu'autres attributs au sein de la dimension. Ces propriétés d'attribut peuvent consister en des opérations unaires, des traductions, des cumuls personnalisés, des propriétés de cumul personnalisé et des niveaux ignorés.

La commande Update accepte uniquement trois propriétés obligatoires :

• La propriété de l' objet , qui contient une référence d’objet pour la dimension dans laquelle les membres doivent être mis à jour. La référence d'objet contient l'identificateur de base de données, l'identificateur de cube et l'identificateur de la dimension.

• La propriété Attributes, qui contient un ou plusieurs éléments attribute pour identifier les attributs dans lesquels les membres doivent être mis à jour. L’élément attribute identifie un attribut et fournit le nom, la valeur, les traductions, l’opérateur unaire, le cumul personnalisé, les propriétés de cumul personnalisé et les niveaux ignorés pour un membre unique mis à jour pour l’attribut identifié.

  Notes

  Toutes les propriétés de l’élément attribute doivent être incluses. Sinon, une erreur risque de se produire.

• La propriété Where , qui contient un ou plusieurs éléments attribut qui contraignent les attributs dans lesquels les membres doivent être mis à jour. La propriété Where est essentielle pour limiter une commande Update à des instances spécifiques d’un membre. Si la propriété Where n’est pas spécifiée, toutes les instances d’un membre donné sont mises à jour. Par exemple, supposons que vous voulez modifier le nom de la ville de trois clients (Bellevue à la place de Redmond). Pour modifier le nom de la ville, vous devez fournir une propriété Where qui identifie les trois membres de l’attribut Customer dont les membres de l’attribut City doivent être modifiés. Si vous ne fournissez pas cette propriété, chaque client dont le nom de ville est actuellement Redmond aura le nom de ville Bellevue après l’exécution de la commande de mise à jour .

  Notes

  À l’exception des nouveaux membres, la commande Update peut uniquement mettre à jour les valeurs de clé d’attribut pour les attributs qui ne sont pas inclus dans la clause Where . Par exemple, le nom de ville ne peut pas être mis à jour lors de la mise à jour d'un client ; sinon, le nom de ville est modifié pour tous les clients.

Mise à jour des membres d'attributs parents

Pour prendre en charge les attributs parents, la commande Update est la propriété facultative MoveWithDescendantsMoveWithDescendants. L’affectation de la valeur true à la propriété MoveWithDescendants indique que les descendants du membre parent doivent également être déplacés avec le membre parent lorsque l’identificateur de ce membre parent change. Si cette valeur est définie à false, le déplacement d'un membre parent entraîne la promotion des descendants immédiats de ce membre parent au niveau précédent du membre parent.

Lors de la mise à jour des membres d’un attribut parent, la commande Update ne peut pas mettre à jour les membres d’autres attributs.

Suppression de membres existants

Avant de construire la commande Drop , vous devez disposer des informations suivantes pour les membres à supprimer :

• La dimension dans laquelle les membres existants doivent être supprimés.

• Les attributs de la dimension dans lesquels les membres existants doivent être supprimés.

• Les clés des membres existants à supprimer. Si un attribut utilise une clé composite, la clé peut nécessiter plusieurs valeurs.

La commande Drop accepte uniquement deux propriétés obligatoires :

• La propriété de l' objet , qui contient une référence d’objet pour la dimension dans laquelle les membres doivent être supprimés. La référence d'objet contient l'identificateur de base de données, l'identificateur de cube et l'identificateur de la dimension.

• La propriété Where , qui contient un ou plusieurs éléments attribute pour contraindre les attributs dans lesquels les membres doivent être supprimés. La propriété Where est essentielle pour limiter une commande de déplacement à des instances spécifiques d’un membre. Si la commande Where n’est pas spécifiée, toutes les instances d’un membre donné sont supprimées. Par exemple, supposons que vous voulez supprimer tois clients de la ville de Redmond. Pour supprimer ces clients, vous devez fournir une propriété Where qui identifie les trois membres de l’attribut Customer à supprimer et le membre Redmond de l’attribut City duquel les trois clients doivent être supprimés. Si la propriété Where spécifie uniquement le membre Redmond de l’attribut City, chaque client associé à Redmond est supprimé par la commande Drop . Si la propriété Where spécifie uniquement les trois membres de l’attribut Customer, les trois clients sont entièrement supprimés par la commande Drop .

  Notes

  Les éléments d' attribut inclus dans une commande Drop doivent contenir uniquement les propriétés AttributeName et Keys . Sinon, une erreur risque de se produire.

Suppression de membres d'attributs parents

La définition de la propriété DeleteWithDescendants indique que les descendants d’un membre parent doivent également être supprimés avec le membre parent. Si cette valeur est définie à false, les descendants immédiats du membre parent sont alors promus au niveau antérieur du membre parent.

Voir aussi

Élément Drop (XMLA)
Élément Insert (XMLA)
Élément Update (XMLA)
Définition et identification d'objets (XMLA)
Développement avec XMLA dans Analysis Services