Infoga, uppdatera och släppa medlemmar (XMLA)

Du kan använda kommandona Infoga, Uppdatera och Släpp i XML för analys (XMLA) för att infoga, uppdatera eller ta bort medlemmar från en skrivaktiverad dimension. Mer information om skrivaktiverade dimensioner finns i Skrivaktiverade Dimensioner.

Infoga nya medlemmar

Kommandot Infoga infogar nya medlemmar i angivna attribut i en skrivaktiverad dimension.

Innan du skapar kommandot Insert bör du ha följande information tillgänglig för de nya medlemmarna som ska infogas:

• Dimensionen där de nya medlemmarna ska infogas.

• Dimensionsattributet där de nya medlemmarna ska infogas.

• Namnen på de nya medlemmarna, inklusive eventuella översättningar för namnet.

• Nycklarna till de nya medlemmarna. Om ett attribut använder en sammansatt nyckel kan nyckeln kräva flera värden.

• Värden för tillämpliga attributegenskaper som inte implementeras som andra attribut inom dimensionen. Sådana attributegenskaper omfattar unära operationer, transformationer, anpassade aggregeringar, anpassade aggregeringsegenskaper och överhoppade nivåer.

Kommandot Insert har bara två egenskaper:

• Egenskapen Object, som innehåller en objektreferens för dimensionen där medlemmarna ska infogas. Objektreferensen innehåller databasidentifieraren, kubidentifieraren och dimensionsidentifieraren för dimensionen.

• Egenskapen Attribut , som innehåller ett eller flera attributelement för att identifiera de attribut som medlemmar ska infogas i. Varje attributelement identifierar ett attribut och innehåller namn, värde, översättningar, unary-operator, anpassad sammanslagning, anpassade sammanslagningsegenskaper och överhoppade nivåer för en enskild medlem som ska läggas till i det identifierade attributet.

  Anmärkning

  Alla egenskaper för attributelementet måste inkluderas. Annars kan ett fel inträffa.

Uppdatera befintliga medlemmar

Kommandot Uppdatera uppdaterar befintliga medlemmar i angivna attribut, baserat på relationer med andra medlemmar i andra attribut, i en skrivaktiverad dimension. Kommandot Uppdatera kan flytta medlemmar till andra nivåer i hierarkier som ingår i dimensionen och kan användas för att omstrukturera överordnade-underordnade hierarkier som definieras av överordnade attribut.

Innan du skapar kommandot Uppdatera bör du ha följande information tillgänglig för medlemmarna som ska uppdateras:

• Dimensionen där befintliga medlemmar ska uppdateras.

• Dimensionsattributen som befintliga medlemmar ska uppdateras i.

• Nycklarna för de befintliga medlemmarna. Om ett attribut använder en sammansatt nyckel kan nyckeln kräva flera värden.

• Värden för tillämpliga attributegenskaper som inte implementeras som andra attribut inom dimensionen. Sådana attributegenskaper omfattar unary-åtgärder, översättningar, anpassade sammanslagningar, anpassade sammanslagningsegenskaper och överhoppade nivåer.

Kommandot Uppdatera tar bara tre nödvändiga egenskaper:

• Egenskapen Object, som innehåller en objektreferens för dimensionen där medlemmarna ska uppdateras. Objektreferensen innehåller databasidentifieraren, kubidentifieraren och dimensionsidentifieraren för dimensionen.

• Egenskapen Attribut , som innehåller ett eller flera attributelement för att identifiera de attribut som medlemmarna ska uppdateras i. Attribute-elementet identifierar ett attribut och innehåller namn, värde, översättningar, unary-operator, anpassad sammanslagning, anpassade sammanslagningsegenskaper och överhoppade nivåer för en enskild medlem som uppdaterats för det identifierade attributet.

  Anmärkning

  Alla egenskaper för attributelementet måste inkluderas. Annars kan ett fel inträffa.

• Egenskapen Where , som innehåller ett eller flera attributelement som begränsar de attribut som medlemmarna ska uppdateras i. Egenskapen Where är avgörande för att begränsa ett uppdateringskommando till specifika instanser av en medlem. Om egenskapen Where inte har angetts uppdateras alla instanser av en viss medlem. Det finns till exempel tre kunder som du vill ändra stadsnamnet för från Redmond till Bellevue. Om du vill ändra ortnamnet måste du ange egenskapen Where som identifierar de tre medlemmarna i kundattributet som medlemmarna i city-attributet ska ändras för. Om du inte anger egenskapen Where skulle varje kund vars stadsnamn för närvarande är Redmond ha stadsnamnet Bellevue när kommandot Uppdatera körs.

  Anmärkning

  Med undantag för nya medlemmar kan kommandot Uppdatera endast uppdatera attributnyckelvärden för attribut som inte ingår i Where-satsen . Stadens namn kan till exempel inte uppdateras när en kund uppdateras. Annars ändras stadens namn för alla kunder.

Uppdatera medlemmar i överordnade attribut

För att stödja överordnade attribut, kommandot Uppdatera valfria MoveWithDescendantsMovewithDescedants egenskaper. Om egenskapen MoveWithDescendants anges till true betyder det att underordnade till den överordnade medlemmen också ska flyttas med den överordnade medlemmen när identifieraren för den överordnade medlemmen ändras. Om det här värdet är inställt på falskt, innebär en flytt av en överordnad medlem att de omedelbara underordnade till den överordnade medlemmen höjs till den nivå där den överordnade medlemmen tidigare bodde.

När du uppdaterar medlemmar i ett överordnat attribut kan kommandot Uppdatera inte uppdatera medlemmar i andra attribut.

Ta bort befintliga medlemmar

Innan du skapar kommandot Släpp bör du ha följande information tillgänglig för medlemmar som ska tas bort:

• Dimensionen där befintliga medlemmar ska tas bort.

• Dimensionsegenskaperna där befintliga medlemmar ska släppas.

• Nycklarna för de befintliga medlemmar som ska tas bort. Om ett attribut använder en sammansatt nyckel kan nyckeln kräva flera värden.

Kommandot Släpp tar bara två nödvändiga egenskaper:

• Egenskapen Object, som innehåller en objektreferens för den dimension där medlemmarna ska tas bort. Objektreferensen innehåller databasidentifieraren, kubidentifieraren och dimensionsidentifieraren för dimensionen.

• Egenskapen Where , som innehåller ett eller flera attributelement för att begränsa de attribut där medlemmar ska tas bort. Egenskapen Where är avgörande för att begränsa ett drop-kommando till specifika instanser av en medlem. Om kommandot Where inte har angetts tas alla instanser av en viss medlem bort. Det finns till exempel tre kunder som du vill släppa från Redmond. Om du vill släppa dessa kunder måste du ange egenskapen Where som identifierar de tre medlemmarna i kundattributet som ska tas bort och Redmond-medlemmen i city-attributet som de tre kunderna ska tas bort från. Om egenskapen Where endast anger Redmond-medlemmen i attributet City, skulle varje kund som är associerad med Redmond tas bort av kommandot Släpp . Om egenskapen Where endast anger de tre medlemmarna i attributet Kund tas de tre kunderna bort helt av kommandot Släpp .

  Anmärkning

  Attributelementen som ingår i ett Drop-kommando får endast innehålla egenskaperna AttributeName och Keys. Annars kan ett fel inträffa.

Ta bort medlemmar i överordnade attribut

Om du anger egenskapen DeleteWithDescendants anger du att underordnade till en överordnad medlem också ska tas bort med den överordnade medlemmen. Om det här värdet är inställt på false höjs de omedelbara underordnade till den överordnade medlemmen i stället till den nivå där den överordnade medlemmen tidigare bodde.

Se även

Ta bort element (XMLA)
Infoga element (XMLA)
Uppdateringselement (XMLA)
Definiera och identifiera objekt (XMLA)
Utveckla med XMLA i Analysis Services