Inserindo, atualizando e descartando membros (XMLA)

Artigo
05/08/2023

Você pode usar os comandos Inserir , Atualizar e Remover no XML for Analysis (XMLA) para inserir, atualizar ou excluir membros de uma dimensão habilitada para gravação, respectivamente. Para obter mais informações sobre dimensões habilitadas para gravação, consulte Dimensões habilitadas para gravação.

Inserindo membros novos

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 os novos membros a serem inseridos:

A dimensão na qual os membros novos serão inseridos.
O atributo da dimensão no qual os membros novos serão inseridos.
Os nomes dos membros novos, incluindo qualquer tradução aplicável para o nome.
As chaves dos membros novos. Se um atributo usar uma chave composta, ela poderá exigir diversos valores.
Os valores para qualquer propriedade de atributo aplicável que não são implementados como outros atributos dentro da dimensão. Tais propriedades de atributo incluem operações unárias, traduções, rollups personalizados, propriedades de rollup personalizadas e níveis ignorados.

O comando Insert tem 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, o rollup personalizado, as propriedades de rollup personalizadas e os níveis ignorados para um único membro a ser 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 membros existentes em atributos especificados, com base em relações com outros membros em outros atributos, em uma dimensão habilitada para gravação. O comando Update pode mover membros para outros níveis em hierarquias contidas pela dimensão e pode ser usado para reestruturar hierarquias pai-filho definidas por atributos pai.

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

A dimensão na qual os membros existentes serão atualizados.
Os atributos de dimensão nos quais os membros existentes serão atualizados.
As chaves dos membros existentes. Se um atributo usar uma chave composta, ela poderá exigir diversos valores.
Os valores para qualquer propriedade de atributo aplicável que não são implementados como outros atributos dentro da dimensão. Tais propriedades de atributo incluem operações unárias, traduções, rollups personalizados, propriedades de rollup personalizadas e níveis ignorados.

O comando Update leva 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, o rollup personalizado, as propriedades de rollup 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, existem três clientes para quem você deseja alterar o nome da cidade de Redmond para Bellevue. Para alterar o nome da cidade, você deve fornecer uma propriedade Where que identifica os três membros no atributo Customer para o qual os membros no atributo City 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 depois que o comando Update for executado.

Observação

Com exceção de novos membros, o comando Update 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 seria alterado para todos os clientes.

Atualizando membros em atributos pai

Para dar suporte a atributos pai, o comando Atualizar as propriedades opcionais MoveWithDescendantsMovewithDescedants. 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 mudado. Se esse valor for definido como falso, 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 Update 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 os membros serem descartados:

A dimensão na qual os membros existentes serão descartados.
Os atributos de dimensão nos quais os membros existentes serão descartados.
As chaves dos membros existentes serem descartados. Se um atributo usar uma chave composta, ela poderá exigir diversos valores.

O comando Drop leva 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 descartados. 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 descartados. Por exemplo, existem três clientes que você deseja descartar de Redmond. Para remover esses clientes, você deve fornecer uma propriedade Where que identifica 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, cada cliente associado a Redmond será descartado pelo comando Drop . Se a propriedade Where especificar apenas os três membros no atributo Customer, os três clientes serão excluídos inteiramente pelo comando Drop .

Observação

Os elementos Attribute incluídos em um comando Drop devem conter apenas as propriedades AttributeNamee 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 falso, os descendentes imediatos do membro pai serão promovidos ao nível no qual o membro pai residia anteriormente.

Importante

Um usuário só precisa ter permissões de exclusão para o membro pai para poder excluir o membro pai e seus descendentes. Um usuário não precisa excluir permissões nos descendentes.

Consulte Também

Elemento Drop (XMLA)
Elemento Insert (XMLA)
Elemento Update (XMLA)
Definindo e identificando objetos (XMLA)
Desenvolvendo com XMLA no Analysis Services

Compartilhar via