Executando operações em lote (XMLA)

Executando comandos em lote transacionais e não-transacionais

O comando Batch executa comandos de uma destas maneiras:

• Transacional
  Se o atributo Transaction do comando Batch for definido como verdadeiro, Batch executará todos os comandos contidos pelo comando Batch em uma única transação – um lote transacional.

  Se qualquer um dos comandos falhar em um lote transacional, o Analysis Services reverterá qualquer comando de Batch executado antes do comando que falhou e o comando Batch será imediatamente interrompido. Qualquer comando de Batch que ainda não tiver sido executado não o será. Após o término do comando Batch, Batch informará qualquer erro ocorrido no comando que falhou.

• Não-transacional
  Se o atributo Transaction for definido como falso, Batch executará todos os comandos contidos pelo comando Batch em uma transação separada – um lote não-transacional. Se qualquer comando falhar em um lote não-transacional, Batch comando continuará a executar comandos após o que falhou. Depois que o comando Batch tenta executar todos os comandos que contidos por Batch, o comando Batch informará qualquer erro ocorrido.

Todos os resultados retornados por comandos contidos em um comando Batch são retornados na mesma ordem em que os comandos estão contidos em Batch. Os resultados retornados por um comando Batch variam caso Batch seja transacional ou não-transacional.

Observação
Se um comando Batch contiver um comando que não retorna saída, como Lock, e se esse comando for executado com êxito, Batch retornará um elemento root no elemento de resultados. O elemento root vazio garante que cada comando contido em um Batch possa ser correspondido ao elemento root apropriado para os resultados desse comando.

Retornando resultados a partir de resultados em lote transacionais

Retornando resultados a partir de resultados em lote não-transacionais

Os resultados de comandos executados em um lote não-transacional são retornados na ordem em que estão contidos em Batch e como são retornados por cada comando. Se nenhum comando contido em Batch puder ser iniciado com êxito, o método Execute retornará uma falha SOAP com um erro para o comando Batch. Se pelo menos um comando for iniciado com êxito, o elemento return do elemento ExecuteResponse retornado pelo método Execute para o comando Batch conterá um elemento results que, por sua vez, conterá um elemento root para cada comando contido em Batch. Se um ou mais comandos de um lote não-transacional não puder ser iniciado ou se a sua conclusão falhar, o elemento root desse comando com falha conterá um elemento error com a descrição do erro.

Observação
Desde que pelo menos um comando de um lote não-transacional possa ser iniciado, o lote não-transacional terá sua execução considerada como bem-sucedida, mesmo que todos os comandos contidos no lote não-transacional retornem um erro nos resultados do comando Batch.

Usando a execução em série ou em paralelo

Você pode usar o comando Batch para executar comandos incluídos em série ou em paralelo. Quando os comandos são executados em série, o próximo comando incluído em Batch não poderá ser iniciado até que o comando em execução em Batch seja concluído. Quando os comandos são executados em paralelo, vários deles poderão ser executados simultaneamente por Batch.

Para executar comandos em paralelo, adicione os comandos a serem executados em paralelo à propriedade Parallel do comando Batch. Atualmente, o Analysis Services só pode executar comandos Process seqüenciais e contíguos em paralelo. Qualquer outro comando XMLA, como Create ou Alter, incluídos na propriedade Parallel serão executados em série.

O Analysis Services tenta executar comandos Process incluídos na propriedade Parallel em paralelo, mas não pode garantir que todos os comandos Process incluídos serão executados em paralelo. A instância analisa cada comando Process e, se a instância determinar que o comando não pode ser executado em paralelo, o comando Process será executado em série.

Observação
Para executar comandos em paralelo, o atributo Transaction do comando Batch deve ser definido como verdadeiro porque o Analysis Services só dá suporte a uma transação ativa por conexão e lotes não-transacionais executam cada comando em uma transação separada. Se você incluir a propriedade Parallel em um lote não transacional, ocorrerá um erro.

Limitando a execução em paralelo

Usando o comando em lotes para processar objetos

O comando Batch contém várias propriedades e atributos opcionais especificamente incluídos para dar suporte ao processamento de vários projetos do Analysis Services:

• O atributo ProcessAffectedObjects do comando Batch indica se a instância também deverá processar qualquer objeto que exija o reprocessamento de um resultado de um comando Process incluído no comando Batch que está processando um objeto especificado.

• A propriedade Bindings contém uma coleção de ligações fora de linha usada por todos os comandos Process de Batch.

• A propriedade DataSource contém uma ligação fora de linha para uma fonte de dados usada por todos os comandos Process de Batch.

• A propriedade DataSourceView contém uma ligação fora de linha para uma exibição de fonte de dados usada por todos os comandos Process de Batch.

• A propriedade ErrorConfiguration especifica o modo no qual o comando Batch manipula os erros encontrado por todos os comandos Process contidos no comando Batch.

  Importante
  Um comando Process não poderá incluir as propriedades Bindings, DataSource, DataSourceView ou ErrorConfiguration, se o comando Process estiver contido em um comando Batch. Se você precisar especificar essas propriedades para um comando Process, forneça as informações necessárias das propriedades correspondentes do comando Batch que contém Process.

Consulte também

Referência

Conceitos