Essbase: Consultar cubo

Descrição

A etapa Essbase: Consultar cubo executa um SELECT MDX em um cubo do Oracle Essbase e grava a grade retornada em uma tabela de destino. É uma consulta ao vivo de verdade: a etapa envia o MDX e lê a grade resultante de forma síncrona, de modo que cada execução reflete os números atuais do cubo. Não é uma extração nem um polling: não há trabalho de preparação a aguardar nem instantâneo que fique desatualizado entre execuções.

Use-a para trazer uma fatia específica de um cubo (um conjunto de contas por período, uma comparação de cenários, um conjunto de direcionadores para uma alocação) para uma tabela do PlaidCloud que você pode então transformar, juntar ou usar em relatórios junto com o restante dos seus dados.

Pré-requisitos

• Uma conexão do Oracle Essbase apontando para o Essbase 21c+ ou o Oracle Analytics Cloud (OAC), com uma conta de serviço que possa ler o aplicativo e o cubo que você quer consultar.

O MDX é executado ao vivo no cubo; a grade retornada vai para a tabela de destino com colunas derivadas da própria grade.

Configuração

• Conexão — uma conexão do Oracle Essbase. O atalho de edição ao lado do seletor abre o editor de conexão para visualizar ou editar.
• Aplicativo — o aplicativo Essbase a consultar. O seletor lista os aplicativos que a conta de serviço da conexão consegue ver; se a conexão define um aplicativo padrão, ele já vem selecionado.
• Cubo (banco de dados) — o cubo, dentro do aplicativo escolhido, em que a consulta será executada.
• MDX — a instrução SELECT MDX a executar. Monte-a com a seleção guiada de membros ou escreva-a diretamente (veja abaixo).
• Tabela de destino — a tabela em que a grade retornada é gravada.

Montando a consulta

Você pode produzir o MDX de duas maneiras:

• Seleção guiada de membros. Navegue pelas dimensões e membros do cubo e escolha o que vai nas colunas e nas linhas; a etapa monta o MDX para você. Os membros são carregados um nível por vez à medida que você os expande, para que um esboço grande continue responsivo.
• MDX bruto. Escreva ou cole um SELECT MDX diretamente: a saída para tudo o que o seletor guiado não cobre, como membros calculados, funções ou operadores de conjunto.

Os dois caminhos produzem o mesmo valor MDX que a etapa executa; o seletor guiado é um ponto de partida que você sempre pode editar manualmente.

Opções

Campo	Padrão	Observações
Suprimir células #Missing	Desativado	No servidor: descarta #Missing e outras células estruturalmente irrelevantes antes que trafeguem pela rede. É seguro: nunca descarta um zero lançado.
Suprimir também células zero (com perdas)	Desativado	Um filtro separado e opcional que também descarta qualquer célula cujo valor já seja exatamente 0, depois que ela é buscada. Com perdas: um zero lançado é um fato real em um cubo de planejamento, não ausência de dados; ative somente se quiser especificamente excluir zeros do resultado.
Limite de linhas	250.000	Limita o número de linhas retornadas. Deixe em branco para usar o limite padrão de 250.000; aumente ou diminua explicitamente. Uma consulta que excede o limite é recusada em vez de truncada silenciosamente: restrinja a consulta (adicione um slicer, NON EMPTY ou um conjunto de membros mais restrito) ou aumente o Limite de linhas e tente novamente.

Pré-visualização

Antes de salvar, Pré-visualização executa o MDX atual no cubo e mostra as colunas retornadas e as primeiras linhas, uma verificação rápida de que a consulta tem o formato esperado, independentemente do Limite de linhas configurado na própria etapa.

Resultados e esquema na leitura

A grade que o Essbase retorna é gravada na tabela de destino com suas colunas derivadas da grade retornada (schema-on-read). Você não declara uma lista de colunas antecipadamente:

• Os nomes das colunas vêm das linhas de cabeçalho da grade. Uma célula de cabeçalho que não abrange nada (o canto acima dos rótulos de linha) vira column_1, column_2 e assim por diante; nomes duplicados se tornam exclusivos com um sufixo numérico.
• Uma coluna cujas células de dados são todas numéricas recebe tipo numérico; qualquer outra recebe tipo texto. Células vazias do Essbase chegam como nulos.
• Os rótulos de membros e de aliases na grade vêm da tabela de aliases configurada na conexão, aplicada de forma consistente em toda execução, e não do padrão por sessão do próprio Essbase, que poderia mostrar rótulos diferentes dependendo de quem estava conectado quando a consulta foi executada.

Como o formato acompanha a consulta, alterar o que o MDX coloca nas colunas muda as colunas da tabela na próxima execução; tenha isso em mente para as etapas seguintes que referenciam nomes de colunas específicos.

Acesso a linhas

A segurança em nível de linha se aplica à tabela gravada exatamente como a qualquer outra tabela do PlaidCloud. A governança é imposta sobre o resultado que a etapa grava, de modo que um leitor com restrição de linhas vê apenas as linhas que seu grupo de segurança permite: a consulta é executada com a conta de serviço da conexão, mas a tabela que ela produz é governada como o restante dos seus dados.

Exemplo

Este MDX coloca duas medidas nas colunas e dois produtos nas linhas:

SELECT
  {Sales, COGS} ON COLUMNS,
  {[100-10], [200-10]} ON ROWS
FROM Sample.Basic

Executá-lo em um cubo que retorna esses quatro números grava uma tabela como esta:

column_1	Sales	COGS
100-10	678.0	271.0
200-10	551.0	235.0

A coluna de rótulos de linha não tem cabeçalho na grade, então vira column_1 (texto); Sales e COGS são totalmente numéricas e chegam como colunas numéricas.

Relacionados

• Conectar-se ao Oracle Essbase (guia) — crie a conexão e monte uma consulta.
• Conector do Oracle Essbase — referência dos campos da conexão.
• Essbase: Ler dimensão — carrega o esboço de uma dimensão do Essbase em uma dimensão do PlaidCloud, diretamente na nuvem.
• Etapas do Oracle Essbase
• Solicitação REST — a etapa de uso geral para outras solicitações HTTP ao vivo.