Inserindo, atualizando e descartando membros (XMLA)

Pode usar os comandos Insert, Update e Drop em XML for Analysis (XMLA) para, respetivamente, inserir, atualizar ou eliminar membros de uma dimensão habilitada para escrita. Para mais informações sobre dimensões habilitadas para escrita, veja Dimensões Habilitadas para Escrita.

Inserção de Novos Membros

O comando Inserir insere novos membros em atributos especificados numa dimensão habilitada para escrita.

Antes de construir o comando Insert , deve ter a seguinte informação disponível para os novos membros a inserir:

• A dimensão em que inserir os novos membros.

• O atributo dimensional em que inserir os novos membros.

• Os nomes dos novos membros, incluindo quaisquer traduções aplicáveis para o nome.

• As chaves dos novos membros. Se um atributo usar uma chave composta, a chave pode exigir múltiplos valores.

• Valores para quaisquer propriedades de atributos aplicáveis que não sejam implementadas como outros atributos dentro da dimensão. Tais propriedades de atributos incluem operações unárias, translações, rollups personalizados, propriedades de rollup personalizadas e níveis saltados.

O comando Insert assume apenas duas propriedades:

• A propriedade Objecto , que contém uma referência de objeto para a dimensão em que os membros devem ser inseridos. A referência do objeto contém o identificador da base de dados, o identificador do cubo e o identificador de dimensão dessa dimensão.

• A propriedade Atributos, que contém um ou mais elementos Atributo para identificar os atributos nos quais os membros devem ser inseridos. Cada elemento Attribute identifica um atributo e fornece o nome, o valor, as traduções, o operador unário, o rollup personalizado, as propriedades de rollup personalizadas e os níveis ignorados para adicionar um único membro ao atributo identificado.

  Observação

  Todas as propriedades do elemento Atributo devem ser incluídas. Caso contrário, pode ocorrer um erro.

Atualização dos Membros Existentes

O comando Update atualiza os membros existentes em atributos especificados, com base nas relações com outros membros noutros atributos, numa dimensão habilitada para escrita. O comando Update pode mover membros para outros níveis nas hierarquias contidas pela dimensão, e pode ser usado para reestruturar hierarquias pai-filho definidas por atributos pais.

Antes de construir o comando Update , deve ter a seguinte informação disponível para os membros serem atualizados:

• A dimensão na qual atualizar membros existentes.

• Os atributos dimensionais nos quais atualizar os membros existentes.

• As chaves dos membros existentes. Se um atributo usar uma chave composta, a chave pode exigir múltiplos valores.

• Valores para quaisquer propriedades de atributos aplicáveis que não sejam implementadas como outros atributos dentro da dimensão. Tais propriedades de atributos incluem operações unárias, translações, rollups personalizados, propriedades de rollup personalizadas e níveis saltados.

O comando Update assume apenas três propriedades obrigatórias:

• A propriedade Objeto, que contém uma referência de objeto para a dimensão em que os membros devem ser atualizados. A referência do objeto contém o identificador da base de dados, o identificador do cubo e o identificador de dimensão dessa dimensão.

• A propriedade Atributos, que contém um ou mais elementos Atributo para identificar os atributos nos quais os membros serão atualizados. O elemento Atributo identifica um atributo e fornece o nome, valor, translações, operador unário, rollup personalizado, propriedades de rollup personalizadas e níveis saltados para um único membro atualizado para o atributo identificado.

  Observação

  Todas as propriedades do elemento Atributo devem ser incluídas. Caso contrário, pode ocorrer um erro.

• A propriedade Where contém um ou mais elementos de atributo que restringem os atributos em que os membros devem ser atualizados. A propriedade Where é crucial para limitar um comando Update a instâncias específicas de um membro. Se a propriedade Where não for especificada, todas as instâncias de um dado membro são atualizadas. Por exemplo, há três clientes para os quais quer mudar o nome da cidade de Redmond para Bellevue. Para alterar o nome da cidade, deve fornecer uma propriedade Where que identifique os três membros no atributo Cliente para os quais os membros do atributo Cidade devem ser alterados. Se não fornecer esta propriedade Where, todos os clientes cujo nome da sua cidade é neste momento Redmond receberão Bellevue como nome da sua cidade após a execução do comando Atualizar.

  Observação

  Com exceção dos novos membros, o comando Update só pode atualizar valores-chave de atributos para atributos não incluídos na cláusula Where . Por exemplo, o nome da cidade não pode ser atualizado quando um cliente é atualizado; caso contrário, o nome da cidade é alterado para todos os clientes.

Atualizando Membros nos Atributos-Pai

Para suportar atributos pais, o comando Update utiliza as propriedades opcionais MoveWithDescendantsMovewithDescedants. Definir a propriedade MoveWithDescendants como true indica que os descendentes do membro principal também devem ser movidos juntamente com este quando o identificador desse membro principal mudar. Se este valor for definido como falso, mover um membro pai faz com que os descendentes imediatos desse membro pai sejam promovidos ao nível em que o membro pai residia anteriormente.

Ao atualizar membros num atributo pai, o comando Update não pode atualizar membros noutros atributos.

Exclusão de Membros Existentes

Antes de construir o comando Drop , deve ter a seguinte informação disponível para os membros a serem retirados:

• A dimensão em que se eliminam os membros existentes.

• Os atributos dimensionais nos quais eliminar membros existentes.

• As chaves dos membros existentes serão retiradas. Se um atributo usar uma chave composta, a chave pode exigir múltiplos valores.

O comando Drop assume apenas duas propriedades obrigatórias:

• A propriedade Objeto, que contém uma referência de objeto para a dimensão em que os membros devem ser removidos. A referência do objeto contém o identificador da base de dados, o identificador do cubo e o identificador de dimensão dessa dimensão.

• A propriedade Where , que contém um ou mais elementos de Atributo para restringir os atributos em que os membros devem ser eliminados. A propriedade Where é crucial para limitar um comando Drop a instâncias específicas de um membro. Se o comando Where não for especificado, todas as instâncias de um dado membro são eliminadas. Por exemplo, há três clientes que pretende eliminar em Redmond. Para remover esses clientes, deve fornecer uma propriedade Where que identifique os três membros do atributo Cliente a serem removidos e o membro Redmond do atributo Cidade, do qual devem ser removidos os três clientes. Se a propriedade Where especificar apenas o membro Redmond do atributo Cidade, todos os clientes associados à cidade de Redmond seriam removidos pelo comando Drop. Se a propriedade Where especificar apenas os três membros no atributo Customer, os três clientes seriam completamente eliminados pelo comando Drop .

  Observação

  Os elementos Attribute incluídos num comando Drop devem conter apenas as propriedades AttributeName e Keys . Caso contrário, pode ocorrer um erro.

Remover membros nos atributos principais

Definir a propriedade DeleteWithDescendants indica que os descendentes de um membro pai também devem ser eliminados com o membro principal. Se este valor for definido como falso, os descendentes imediatos do membro pai são antes promovidos ao nível em que o membro pai residia anteriormente.

Ver também

Elemento de Queda (XMLA)
Inserir Elemento (XMLA)
Elemento de Atualização (XMLA)
Definição e Identificação de Objetos (XMLA)
Desenvolvimento com XMLA em Serviços de Análise