Usar Comandos de Cálculo

Os comandos de cálculo do Essbase ajudam a calcular com flexibilidade os dados no cubo de armazenamento em blocos. Você pode criar scripts para calcular dados com base no outline, calcular iterativamente ou em paralelo, restringir a subconjuntos e declarar variáveis. Você pode personalizar o comportamento de diferentes recursos dentro do script de cálculo.

Calcular o Outline do Essbase

Os comandos de cálculo do Essbase a seguir calculam um cubo de armazenamento em blocos com base na estrutura e nas fórmulas em seu outline.

Tabela 23-1 Lista de Comandos para Cálculo do Outline do Cubo

Comando Cálculo

CALCULAR TUDO

O cubo inteiro, com base no outline

CALC DIM

Uma dimensão ou dimensões especificadas

CALC TWOPASS

Todos os membros marcados como two-pass na dimensão marcada como contas

Observação:

Não use cálculo em duas etapas com cubos de modo híbrido. Use apenas a ordem de solução.

membername

A fórmula aplicada a um membro no outline do cubo, em que membername é o nome do membro ao qual a fórmula é aplicada

CALC AVERAGE

Todos os membros marcados como Média na dimensão marcados como contas

CALC FIRST

Todos os membros marcados como Primeiro na dimensão marcados como contas

CALC LAST

Todos os membros marcados como Último na dimensão marcados como contas

CCONV

Conversões de Moeda

Controlar o Fluxo de Cálculos

Os comandos de fluxo de controle nos scripts de cálculo do Essbase de armazenamento em bloco ajudam a iterar cálculos, calcular em paralelo ou restringir cálculos a um subconjunto do cubo.

Os seguintes comandos manipulam o fluxo de cálculos:

Tabela 23-2 Lista de Comandos para Controlar o Fluxo de Cálculos

Comando Cálculo

CORRIGIR...ENDFIX

Calcular um subconjunto de um banco de dados por inclusão

EXCLUDE...ENDEXCLUDE

Calcular um subconjunto de um banco de dados por exclusão

LOOP...ENDLOOP

Especifique o número de vezes que os comandos são iterados

FIXPARALLEL...ENDFIXPARALLEL

Ativar cálculo paralelo em um bloco de comandos

Você também pode usar os comandos IF e ENDIF para especificar cálculos condicionais.

Observação:

O Essbase não permite a ramificação de um script de cálculo para outro.

Declarar Variáveis de Dados Durante o Cálculo

Use comandos de declaração de dados em scripts de cálculo de armazenamento em bloco do Essbase para declarar e definir os valores iniciais de variáveis temporárias, que armazenam os resultados de cálculos intermediários.

Também é possível usar variáveis de substituição em um script de cálculo. Consulte Variáveis de Substituição em Scripts de Cálculo.

Tabela 23-3 Lista de Comandos para Declarar Variáveis de Dados

Comando Cálculo

ARRAY

Declarar variáveis da matriz unidimensional

VAR

Declare uma variável temporária que contém um único valor

VAR. THREAD

Declare uma variável temporária que pode ser usada dentro de um bloco FIXPARALLEL...ENDFIXPARALLEL.

Os valores armazenados em variáveis temporárias só existem enquanto o script de cálculo está em execução. Não é possível reportar os valores de variáveis temporárias.

Os nomes de variáveis e matrizes são strings de caracteres que contêm qualquer um dos seguintes caracteres:

  • Letras a–z

  • Numerais 0–9

  • Caracteres especiais: $ (sinal de dólar), # (sinal de libra) e _ (sublinhado)

Geralmente, matrizes são usadas para armazenar variáveis como parta de uma fórmula de membro. O tamanho da variável da matriz é determinado pelo número de membros na dimensão correspondente. Por exemplo, se a dimensão Cenário tiver quatro membros, o comando a seguir criará uma matriz chamada Discount com quatro entradas:

ARRAY Discount[Scenario];

Você pode usar vários arrays de cada vez.

Especificar Definições Globais para um Cálculo

Os comandos SET para scripts de cálculo do Essbase ajudam a definir o comportamento de diferentes aspectos funcionais dos cálculos de armazenamento em blocos. A primeira ocorrência de um comando SET permanece em vigor até a próxima ocorrência do mesmo comando SET no script.

Os comandos a seguir definem o comportamento do cálculo:

Tabela 23-4 Lista de Comandos para Definição do Comportamento de Cálculo

Comando Cálculo

DEFINIR AGGMISSG

Especifique como o Essbase trata os valores #MISSING durante um cálculo.

DEFINIR CACHE

Ajuste o tamanho do cache da calculadora padrão. Consulte Caches do Essbase e Desempenho de Cálculo.

DEFINIR CALCPARALLEL

Ative o cálculo paralelo. Consulte Ativar Cálculo Paralelo CALCPARALLEL.

DEFINIR CALCTASKDIMS

Aumente o número de dimensões usadas para identificar tarefas para cálculo paralelo. Consulte Identificar Tarefas Adicionais para Cálculo Paralelo.

SET CLEARUPDATESTATUS

Controle como o Essbase marca blocos de dados para Cálculo Inteligente. Consulte O Comando SET CLEARUPDATESTATUS.

SET CREATEBLOCKONEQ

Ative e desative a configuração Criar Blocos na Equação, que controla a criação de blocos quando você atribui valores não constantes a membros de uma dimensão esparsa. Consulte Valores Não Constantes Atribuídos a Membros em uma Dimensão Esparsa.

DEFINIR CREATENONMISSINGBLK

Ative cálculos em blocos de dados potenciais e salve esses blocos quando o resultado não for #MISSING.

DEFINIR FRMLBOTTOMUP

Otimize o cálculo de fórmulas de dimensão esparsa em contornos de banco de dados grandes. Consulte Fórmulas em Dimensões Esparsas em Tópicos Grandes.

DEFINIR MENSAGEM

DEFINIR AVISO

SET TRACE

Exiba mensagens para monitorar e rastrear um cálculo.

SET RUNTIMESUBVARS

Declare as variáveis de substituição de tempo de execução usadas em um script de cálculo. Consulte Variáveis de Substituição em Runtime na Execução de Scripts de Cálculo no Essbase e Variáveis de Substituição em Runtime na Execução de Scripts de Cálculo no Smart View

DEFINIR ATUALIZAÇÃO

Ativar ou Desativar Cálculo Inteligente.

No seguinte script de cálculo, o Essbase exibe mensagens no nível de detalhe (SET MSG DETAIL;) ao calcular a dimensão Ano e exibe mensagens no nível de resumo (SET MSG SUMMARY;) ao calcular a dimensão Medidas:

SET MSG DETAIL;
CALC DIM(Year);

DEFINIR RESUMO DA MENSAGEM;

CALC DIM(Medidas);

Alguns comandos de cálculo SET acionam passagens adicionais pelo banco de dados.

No script de cálculo a seguir, o Essbase calcula combinações de membros para o Trimestre 1 com SET AGGMISSG ativado e, em seguida, faz um segundo cálculo passar pelo banco de dados e calcula combinações de membros para Leste com SET AGGMISSG desativado:

SET AGGMISSG ON;
Qtr1;
SET AGGMISSG OFF;
East;

Consulte Também

Comandos SET