Inserindo, atualizando e descartando membros (XMLA)

Você pode usar os comandos Insert, Update e Drop no XMLA (XML for Analysis) para inserir, atualizar ou excluir membros respectivamente de uma dimensão habilitada para gravação. Para obter mais informações sobre dimensões com suporte para gravação, consulte Dimensões com Suporte para Gravação.

Inserindo novos membros

O comando Inserir insere novos membros em atributos especificados em uma dimensão habilitada para gravação.

Antes de construir o comando Insert , você deve ter as seguintes informações disponíveis para que os novos membros sejam inseridos:

• A dimensão na qual inserir os novos membros.

• O atributo de dimensão no qual inserir os novos membros.

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

• As chaves dos novos membros. Se um atributo usar uma chave composta, a chave poderá exigir vários valores.

• Valores para quaisquer propriedades de atributo aplicáveis que não são implementadas como outros atributos dentro da dimensão. Essas propriedades de atributo incluem operações unárias, traduções, rollups personalizados, propriedades de rollup personalizadas e níveis ignorados.

O comando Inserir usa apenas duas propriedades:

• A propriedade Object , que contém uma referência de objeto para a dimensão na qual os membros devem ser inseridos. A referência de objeto contém o identificador de banco de dados, o identificador de cubo e o identificador de dimensão para a dimensão.

• A propriedade Attributes , que contém um ou mais elementos attribute 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, a consolidação personalizada, as propriedades de consolidação customizadas, e os níveis ignorados, de forma que um único membro seja adicionado ao atributo identificado.

  Observação

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

Atualizando membros existentes

O comando Atualizar atualiza os membros existentes em atributos especificados, com base nas relações com outros membros em outros atributos, em uma dimensão onde a gravação é permitida. O comando Atualizar pode mover membros para outros níveis em hierarquias contidas na dimensão e pode ser usado para reestruturar hierarquias pai-filho definidas por atributos pai.

Antes de construir o comando Atualizar , você deve ter as seguintes informações disponíveis para que os membros sejam atualizados:

• A dimensão na qual atualizar os membros existentes.

• Os atributos de dimensão nos quais atualizar os membros existentes.

• As chaves dos membros existentes. Se um atributo usar uma chave composta, a chave poderá exigir vários valores.

• Valores para quaisquer propriedades de atributo aplicáveis que não são implementadas como outros atributos dentro da dimensão. Essas propriedades de atributo incluem operações unárias, traduções, rollups personalizados, propriedades de rollup personalizadas e níveis ignorados.

O comando Atualizar usa apenas três propriedades necessárias:

• A propriedade Object , que contém uma referência de objeto para a dimensão na qual os membros devem ser atualizados. A referência de objeto contém o identificador de banco de dados, o identificador de cubo e o identificador de dimensão para a dimensão.

• A propriedade Attributes , que contém um ou mais elementos attribute para identificar os atributos nos quais os membros devem ser atualizados. O elemento Attribute identifica um atributo e fornece o nome, o valor, as traduções, o operador unário, a agregação personalizada, as propriedades de agregação personalizadas e os níveis ignorados para um único membro atualizado para o atributo identificado.

  Observação

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

• A propriedade Where , que contém um ou mais elementos attribute que restringem os atributos nos quais 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 determinado membro serão atualizadas. Por exemplo, há três clientes para os quais você deseja alterar o nome da cidade de Redmond para Bellevue. Para alterar o nome da cidade, você deve fornecer uma propriedade Where que identifique os três membros no atributo Cliente para o qual os membros do atributo Cidade devem ser alterados. Se você não fornecer essa propriedade Where , cada cliente cujo nome de cidade atualmente é Redmond terá o nome da cidade de Bellevue após a execução do comando Update .

  Observação

  Com exceção de novos membros, o comando Atualizar só pode atualizar valores de chave de atributo 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 será alterado para todos os clientes.

Atualizando membros em atributos pais

Para dar suporte a atributos pai, o comando Atualizar utiliza as propriedades opcionais MoveWithDescendants. Definir a propriedade MoveWithDescendants como true indica que os descendentes do membro pai também devem ser movidos com o membro pai quando o identificador desse membro pai for alterado. Se esse valor for definido como false, mover um membro pai fará com que os descendentes imediatos desse membro pai sejam promovidos ao nível no qual o membro pai residia anteriormente.

Ao atualizar membros em um atributo pai, o comando Atualizar não pode atualizar membros em outros atributos.

Descartando membros existentes

Antes de construir o comando Drop , você deve ter as seguintes informações disponíveis para que os membros sejam removidos:

• A dimensão na qual remover membros existentes.

• Os atributos de dimensão nos quais remover membros existentes.

• As chaves dos membros existentes a serem removidas. Se um atributo usar uma chave composta, a chave poderá exigir vários valores.

O comando Drop usa apenas duas propriedades necessárias:

• A propriedade Object , que contém uma referência de objeto para a dimensão na qual os membros devem ser removidos. A referência de objeto contém o identificador de banco de dados, o identificador de cubo e o identificador de dimensão para a dimensão.

• A propriedade Where , que contém um ou mais elementos attribute para restringir os atributos nos quais os membros devem ser excluídos. 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 determinado membro serão removidas. Por exemplo, há três clientes que você deseja remover de Redmond. Para remover esses clientes, você deve fornecer uma propriedade Where que identifique os três membros no atributo Customer a serem removidos e o membro Redmond do atributo City do qual os três clientes devem ser removidos. Se a propriedade Where especificar apenas o membro Redmond do atributo City, todos os clientes associados a Redmond serão descartados pelo comando Drop . Se a propriedade Where especificar apenas os três membros no atributo Cliente, os três clientes serão totalmente excluídos pelo comando Drop .

  Observação

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

Descartando membros em atributos pai

Definir a propriedade DeleteWithDescendants indica que os descendentes de um membro pai também devem ser excluídos com o membro pai. Se esse valor for definido como false, os descendentes imediatos do membro pai serão promovidos ao nível no qual o membro pai residia anteriormente.

Consulte Também

Elemento Drop (XMLA)
Elemento Insert (XMLA)
Elemento de Atualização (XMLA)
Definindo e identificando objetos (XMLA)
Desenvolvendo com XMLA no serviço de análise