Essbase
Resumo
| Item | Description |
|---|---|
| Estado de Lançamento | Disponibilidade Geral |
| Produtos | Power BI (modelos semânticos) |
| Tipos de autenticação suportados | Básico (Nome de Utilizador/Palavra-passe) |
| Documentação de referência da função | Essbase.Cubos |
Pré-requisitos
A versão Essbase 11.1.2.x é suportada.
Capacidades suportadas
- Importar
- Consulta direta (modelos semânticos do Power BI)
- Opções avançadas
- Tempo limite do comando em minutos
- Servidor
- Aplicação
- Declaração MDX
Ligar ao Essbase a partir do Power Query Desktop
Para conectar-se a um servidor Essbase:
Selecione a opção Essbase na experiência Obter dados .
Insira a URL para o servidor Oracle Essbase Hyperion. Normalmente, o URL tem a aparência de
http://[hostname]:[port number]/aps/XMLA. Os componentes do URL são:O
hostname(por exemplo,yourservername.domain.com) é o nome do host ou endereço IP do servidor Oracle Hyperion Application Provider Service (APS) para seu sistema interno.O
port number(por exemplo, 19000) é o número da porta que o servidor APS está escutando para solicitações XMLA.A última parte da URL, o caminho (ou seja, /aps/XMLA), diferencia maiúsculas de minúsculas e deve ser especificada exatamente como mostrado.
Alguns exemplos de URLs seriam:
http://apsserver.company.com:19000/aps/XMLA—Usando nome de host totalmente qualificado com a porta padrão 19000.http://hypserver01:13080/aps/XMLA—Usando um nome de host não totalmente qualificado e a porta 13080.http://10.10.10.10/aps/XMLA—Usando um endereço IP e a porta 80 – alterado do padrão 19000.
Selecione o modo de conectividade de dados Import ou DirectQuery . Para obter mais informações: Usar o DirectQuery no Power BI Desktop
Opcionalmente, insira valores em quaisquer opções avançadas que você deseja usar para modificar a consulta de conexão. Para obter mais informações: Conectar-se usando opções avançadas
Na primeira vez que você se conectar a uma fonte de dados (identificada por cada URL exclusivo), você será solicitado a inserir as credenciais da conta. Introduza o Nome de utilizador e a Palavra-passe para a ligação. Para obter mais informações: Autenticação com uma fonte de dados
No Navegador, selecione os dados necessários. Em seguida, selecione Transformar dados para transformar os dados no Power Query Editor ou Carregar para carregar os dados no Power BI.
Conecte-se usando opções avançadas
O Power Query fornece um conjunto de opções avançadas que pode adicionar à sua consulta, se necessário. A tabela seguinte lista todas as opções avançadas que pode definir no Power Query.
| Opção avançada | Description |
|---|---|
| Tempo limite do comando em minutos | Permite definir o tempo máximo que um comando pode ser executado antes que o Power BI abandone a chamada. Se o tempo limite do comando for atingido, o Power BI poderá tentar novamente mais duas vezes antes de abandonar completamente a chamada. Essa configuração é útil para consultar grandes quantidades de dados. O valor padrão do tempo limite do comando é 140 segundos. |
| Servidor | O nome do servidor onde a instrução MDX opcional deve ser executada. Esse valor diferencia maiúsculas de minúsculas. |
| Aplicação | O nome do aplicativo onde a instrução MDX opcional deve ser executada. Esse valor diferencia maiúsculas de minúsculas. |
| Declaração MDX | Opcionalmente, fornece uma instrução MDX específica para o servidor Oracle Essbase executar. Normalmente, o Power BI determina interativamente as medidas e dimensões do cubo a ser retornado. No entanto, especificando a instrução MDX, os resultados dessa instrução MDX específica serão carregados. Ao especificar a instrução MDX, você também deve fornecer as opções avançadas Server (por exemplo, essbaseserver-1) e Application (por exemplo, Sample) para indicar onde a instrução MDX deve ser executada. Além disso, você só pode usar a instrução MDX em conjunto com o modo de Conectividade de Dados definido como Importar.Em geral, o MDX gerado pelo SmartView ou um aceito pelo Essbase Admin não é 100% compatível com o Power BI. O PowerBI requer que as medidas sejam especificadas em um eixo 0 em uma consulta MDX. Além disso, a numeração de nível é invertida no XMLA. O nível menos granular é o nível 0, 1 e assim por diante em XML, mas o oposto no Essbase "diretamente". Portanto, se os números de nível forem usados explicitamente na consulta MDX, eles precisarão ser ajustados. |
Usando o navegador da fonte de dados ao importar dados
Quando o modo de Conectividade de Dados é definido como Importar, o navegador da fonte de dados carrega os servidores configurados para o servidor APS fornecido na URL. A expansão de um nó de servidor na árvore revela os aplicativos disponíveis. A expansão de um nó de aplicativo revela os bancos de dados disponíveis (também conhecidos como cubos). A expansão de um nó de banco de dados revela as medidas e dimensões disponíveis. A dimensão pode ser expandida para revelar os níveis na hierarquia para cada dimensão.
Escolha uma medida e todos os níveis de dimensão (ou específicos) marcando a caixa de seleção ao lado do nome. Uma visualização dos dados é fornecida no painel à direita. Você pode selecionar o botão Carregar para recuperar os dados associados à seleção ou selecionar o botão Transformar Dados para definir mais filtros nos dados antes de carregá-los no Power BI.
Diferenças na exibição em comparação com a administração do Essbase
Ao expandir uma hierarquia de dimensões no navegador, você pode notar que ela parece diferente quando comparada ao uso do painel de controle dos Serviços de Administração do Essbase.
Como exemplo, a imagem a seguir mostra a hierarquia de dimensão de Entidade expandida dos Serviços de Administração do Essbase.
Enquanto estiver no navegador do Power Query, a mesma Entidade que está a ser expandida aparece assim:
Esteja ciente de que este olhar é uma decisão estilística e que não há diferenças nos dados. Os níveis no navegador do Power Query correspondem ao nível hierárquico.
No exemplo acima, o Nível 1 conteria "R_ReportingUnits", "Entrada da entidade de ajuste" e "No_Entity". O nível 2 conteria "R_Americas", "R_EMEA", "R_AsiaPacific", "1_ReportingUnits_Adjustment", "CALA_HFM_Input", "CALA_Total" e assim por diante.
O motivo é porque o navegador no Power Query está limitado a 10.000 membros para exibição e pode haver milhões ou bilhões de membros abaixo de uma hierarquia. Mesmo para o caso de nenhum limite de exibição de membros (como no Power Query Online), navegar e selecionar cada membro individual em um formato de árvore com tantos valores possíveis rapidamente se torna tedioso e difícil de usar.
Assim, o agrupamento dos níveis hierárquicos facilita a seleção do que importar, e a geração de relatórios subsequente pode usar filtros para direcionar apenas os membros que o usuário final deseja.
Usando o navegador da fonte de dados para DirectQuery
Quando um modo de Conectividade de Dados do DirectQuery é escolhido, o navegador da fonte de dados carrega os servidores configurados para o servidor APS fornecido na URL. A expansão de um nó de servidor na árvore revela os aplicativos disponíveis. A expansão de um nó de aplicativo revela os bancos de dados disponíveis (também conhecidos como cubos).
Limitações conhecidas
O conector Essbase não suporta hierarquias de medida. Todas as medidas são exibidas no mesmo nível. Você ainda pode selecionar todas as medidas que você precisa. O campo de pesquisa pode ser usado para restringir as medidas exibidas se houver um grande número de medidas.
Considerações de desempenho
A interação com o Power BI no modo DirectQuery é muito dinâmica. Ao selecionar uma caixa de seleção para incluir uma medida ou nível de dimensão na visualização, o Power BI Desktop gera uma consulta e a envia para o servidor Oracle Essbase para obter os resultados. O Power BI é otimizado para armazenar em cache quaisquer consultas repetidas para melhorar o desempenho. Mas se qualquer nova consulta for gerada, ela será enviada para o servidor Oracle Essbase para produzir um novo resultado. Dependendo do número de medidas selecionadas, dos níveis de dimensão e dos filtros aplicados, a consulta pode ser enviada mais rapidamente do que o servidor Oracle Essbase pode responder. Para melhorar o desempenho e aumentar a capacidade de resposta, considere os três métodos a seguir para otimizar sua interação com o servidor Oracle Essbase.
Opções de redução de consulta
Há três opções para reduzir o número de consultas enviadas. No Power BI Desktop, selecione a guia Arquivo , selecione Opções e configurações > Opções e selecione Reduções de consulta na seção Arquivo atual.
Selecionar a opção Desativando realce/filtragem cruzados por padrão em Reduzir o número de consultas enviadas por desabilita realce/filtragem cruzados por padrão. Quando desabilitadas, as listas de membros no filtro não são atualizadas ao filtrar membros em outros níveis da mesma dimensão. Selecionar a opção Seleções de segmentação de dados em Mostrar um botão Aplicar e enviar consultas apenas uma vez para a seção exibe o botão Aplicar quando uma seleção de segmentação de dados é alterada. Selecionar a opção Filtrar seleções em Mostrar um botão Aplicar e enviar consultas apenas uma vez para a seção exibe o botão Aplicar quando uma seleção de filtro é alterada.
Nota
Estas opções aplicam-se apenas ao ficheiro atual em que está a trabalhar. As configurações atuais da opção Arquivo são salvas com o arquivo e restauradas ao abrir o mesmo arquivo.
Aplicação de filtro iterativa ao adicionar níveis de dimensão no modo de importação
Ao interagir no modo de importação com uma fonte de dados de cubo multidimensional como o Essbase da Oracle, o Power Query inicialmente exibe as medidas, dimensões e níveis de dimensão na caixa de diálogo Navegador de banco de dados. No entanto, embora o Power BI facilite a seleção e visualização de dados, pode, às vezes, levar à recuperação de muitos dados do servidor.
O procedimento a seguir demonstra como reduzir as chances de recuperar mais dados do que o necessário ao importar dados para o Power BI aplicando iterativamente filtros em membros de dimensão em cada nível.
Conectando-se à fonte de dados do Oracle Essbase
Siga as instruções em Ligar ao Essbase a partir do Power Query Desktop para ligar a um servidor Essbase utilizando o modo de importação.
Expanda a árvore para detalhar o servidor, o aplicativo e o banco de dados desejados até expor as medidas e dimensões do banco de dados. Por enquanto, selecione suas medidas e apenas um nível de dimensão. Escolha o nível de dimensão mais importante. Em etapas posteriores, você criará o resultado adicionando incrementalmente mais níveis de dimensões.
Selecione Carregar para importar as medidas selecionadas e o nível de dimensão.
Editando consultas para adicionar mais níveis de dimensão
Agora que você tem um ponto de partida, você pode começar a adicionar mais níveis de dimensão e aplicar filtros à medida que avança.
Selecione Editar Consultas na faixa de opções do Power BI Desktop para iniciar o processo.
Se você tiver membros que deseja filtrar na dimensão inicial, selecione o botão
de propriedades da coluna para exibir a lista de membros de dimensão disponíveis nesse nível. Selecione apenas os membros de dimensão necessários neste nível e, em seguida, selecione OK para aplicar o filtro.
Os dados resultantes agora são atualizados com o filtro aplicado. As Etapas Aplicadas agora contêm uma nova etapa (Linhas Filtradas) para o filtro definido. Você pode selecionar o botão
de configurações para a etapa para modificar o filtro posteriormente.
Agora você adicionará um novo nível de dimensão. Neste caso, você adicionará o próximo nível para baixo para a mesma dimensão que você escolheu inicialmente. Selecione Adicionar Itens no friso para abrir a caixa de diálogo Navegador .
Navegue até a mesma dimensão, mas desta vez selecione o próximo nível abaixo do primeiro nível. Em seguida, selecione OK para adicionar o nível de dimensão ao resultado.
A grade de resultados agora tem os dados do novo nível de dimensão. Observe que, como você aplicou um filtro no nível superior, apenas os membros relacionados no segundo nível são retornados.
Agora você pode aplicar um filtro à dimensão de segundo nível, como fez para o primeiro nível.
Desta forma, cada etapa subsequente garante que apenas os membros e dados que você precisa sejam recuperados do servidor.
Agora vamos adicionar um novo nível de dimensão repetindo as etapas anteriores. Selecione Adicionar itens na barra da faixa de opções novamente.
Navegue até o nível de dimensão desejado, selecione-o e selecione OK para adicionar o nível de dimensão ao resultado.
O novo nível de dimensão é adicionado ao resultado.
Aplique um filtro a este nível de dimensão, conforme necessário.
Observe o resultado.
Aplicando as alterações e carregando os dados
Quando tiver adicionado todos os níveis de dimensão desejados e definido todos os filtros necessários, selecione Fechar no canto superior direito para fechar o editor.
Selecione Sim para aplicar as alterações.
Aguarde até que as alterações sejam aplicadas.
Observe os novos níveis de dimensão no painel Campos .
Agora você está pronto para criar relatórios e visualizações.
Aplicativo de filtro iterativo ao adicionar níveis de dimensão no modo DirectQuery
Ao interagir no modo DirectQuery com uma fonte de dados de cubo multidimensional (como o Essbase do Oracle), o Power BI exibe as dimensões e os níveis do cubo no painel Campos .
Para exibir e filtrar com base nos membros da dimensão:
Arraste e solte um nível de dimensão do painel Campos para o painel Filtros. Você pode arrastar o nível de dimensão para a área Adicionar campos de dados aqui em Filtros neste visual, Filtros nesta página ou Filtros em todas as páginas, dependendo das suas necessidades.
Quando o nível de uma dimensão estiver no painel Filtro e o tipo de filtro estiver definido como Filtragem básica, você notará que os membros do nível dessa dimensão serão exibidos como uma lista de filtros disponíveis.
Você pode verificar os membros que deseja incluir no seu resultado.
Ou você pode selecionar a opção Selecionar tudo e, em seguida, desmarcar os membros que você não deseja incluir no seu resultado.
Digite alguns caracteres no campo de pesquisa desse filtro para encontrar membros na lista.
Quando você tiver filtros para dois ou mais níveis da mesma dimensão, notará que selecionar membros de um nível superior na dimensão altera os membros disponíveis nos níveis inferiores dessa dimensão.
Esse comportamento de realce/filtragem cruzado pode ser desativado marcando a opção Desabilitando realce/filtragem cruzado por padrão , conforme descrito em Opções de redução de consulta.
Quando terminar de escolher os membros desejados no filtro de nível de dimensão, é um bom momento para adicionar esse nível de dimensão à sua visualização. Verifique o nível de dimensão correspondente no painel Campos e, em seguida, ele é adicionado à sua visualização atual.
Para obter mais informações sobre como adicionar filtros, vá para Adicionar um filtro a um relatório no Power BI.
Resolução de Problemas
Esta seção descreve problemas comuns que você pode encontrar e inclui etapas de solução de problemas para resolver os problemas.
Problemas de ligação
Sintoma 1
O Power BI Desktop retorna a mensagem de erro "Não é possível se conectar ao servidor remoto".
Resolução
Verifique se o servidor Essbase Analytic Provider Services (APS) está configurado corretamente para os Servidores do Provedor e os Servidores Autônomos no console do EAS (Serviço de Administração do Essbase). Para obter mais informações: Configurando clusters Essbase
Verifique se o URL está correto.
- Verifique se o nome do host e/ou endereço IP está correto.
- Verifique se a porta fornecida está correta.
- Verifique se o protocolo http (não https) está especificado.
- Verifique se o caso está correto para o caminho /aps/XMLA na URL.
Se houver um firewall entre o Power BI Desktop e o nome de host fornecido, verifique se o nome do host e a porta fornecidos podem passar de saída pelo firewall.
Validação
Tentar conectar-se novamente não mostrará o erro e a lista de cubos e membros estará no painel de navegação. Você também pode selecionar e exibir na visualização no modo de importação.
Sintoma 2
O Power BI Desktop retorna a mensagem de erro "Não foi possível autenticar com as credenciais fornecidas. Tente novamente.”
Resolução
Verifique se o nome de usuário e a senha fornecidos estão corretos. Reintroduza os seus valores cuidadosamente. A senha diferencia maiúsculas de minúsculas.
Validação
Depois de corrigir o nome de usuário e senha, você deve ser capaz de exibir os membros e o valor na visualização ou ser capaz de carregar os dados.
Sintoma 3
O Power BI Desktop retorna a mensagem de erro "Os dados no nível raiz são inválidos. Linha 1, posição 1."
Resolução
Verifique se o servidor Essbase Analytic Provider Services (APS) está configurado corretamente para os Servidores do Provedor e os Servidores Autônomos no console do EAS (Serviço de Administração do Essbase). Para obter mais informações: Configurando clusters do Essbase.
Validação
Tentar conectar-se novamente não mostrará o erro e a lista de cubos e membros será exibida no painel de navegação. Você também pode selecionar e exibir na visualização no modo de importação.
Sintoma 4
Uma vez conectado com êxito ao servidor Oracle Essbase Analytic Provider Services (APS), há servidores listados abaixo do nó URL no navegador da fonte de dados. No entanto, quando você expande um nó de servidor, nenhum aplicativo é listado abaixo desse nó de servidor.
Resolução
Recomendamos configurar o servidor Oracle Hyperion para definir o provedor e os servidores autônomos por meio do console do Essbase Administration Service (EAS). Consulte a seção Adenda: Registrando Provedor e Servidores Autônomos no Console do Serviço de Administração do Essbase (EAS).
Validação
Tentar conectar-se novamente não mostrará o erro e você poderá ver o Cubo e a lista de membros no painel de navegação. Você também pode selecionar e exibir na visualização no modo de importação.
Tempo limite ou problema de dados grandes
Sintoma 1
O Power Query devolve a mensagem de erro "A operação expirou"
Resolução
Verifique se a rede está estável e se há um caminho de rede confiável para o servidor Essbase Analytic Provider Services (APS) fornecido na URL da fonte de dados.
Se houver a possibilidade de que a consulta ao serviço possa retornar uma grande quantidade de dados, especifique um intervalo de tempo limite de comando longo (ou maior). Se possível, adicione filtros à sua consulta para reduzir a quantidade de dados retornados. Por exemplo, selecione apenas membros específicos de cada dimensão que você deseja retornar.
Validação
Tente carregar novamente os dados e, se o problema persistir, tente aumentar para um intervalo de tempo limite maior ou filtrar ainda mais os dados. Se o problema persistir, tente a resolução em Sintomas 3.
Sintoma 2
A consulta retorna a mensagem de erro "Erro interno: a consulta está alocando memória muito grande ( > 4GB) e não pode ser executada. A alocação de consultas excede os limites de alocação."
Resolução
A consulta que você está tentando executar está produzindo resultados maiores do que o servidor Oracle Essbase pode manipular. Forneça ou aumente os filtros na consulta para reduzir a quantidade de dados que o servidor retornará. Por exemplo, selecione membros específicos para cada nível de cada dimensão ou defina limites numéricos no valor das medidas.
Validação
Tente carregar novamente os dados e, se o problema persistir, tente aumentar para um intervalo de tempo limite maior ou filtrar ainda mais os dados. Se o problema persistir, tente a resolução em Sintomas 3.
Essbase Analytic Provider Services (APS) ou servidor Essbase indica um grande número de conexões com sessões de longa duração.
Resolução
Quando o modo de conectividade é DirectQuery, é fácil selecionar medidas ou níveis de dimensão para adicionar à visualização selecionada. No entanto, cada nova seleção cria uma nova consulta e uma nova sessão para o servidor Essbase Analytic Provider Services (APS)/Essbase. Há algumas maneiras de garantir um número reduzido de consultas ou reduzir o tamanho de cada resultado da consulta. Analise as Considerações de Desempenho para reduzir o número de vezes que o servidor é consultado e também para reduzir o tamanho dos resultados da consulta.
Validação
Tente carregar novamente os dados.
Chave que não corresponde ao executar MDX
Sintoma
Uma instrução MDX retorna a mensagem de erro "A chave não correspondeu a nenhuma linha na tabela".
Resolução
É provável que o valor ou o caso dos campos Servidor e Aplicativo não coincidam. Selecione o botão Editar e corrija o valor e a maiúscula e minúscula dos campos Servidor e Aplicativo.
Validação
Tente carregar novamente os dados.
Não é possível obter problema de cubo - MDX
Sintoma
Uma instrução MDX retorna a mensagem de erro "Não é possível obter o nome do cubo da instrução. Verifique o formato usado para especificar o nome do cubo".
Resolução
Verifique se o nome do banco de dados na cláusula FROM da instrução MDX está totalmente qualificado com o nome do aplicativo e do banco de dados, por exemplo, [Sample.Basic]. Selecione o botão Editar e corrija o nome do banco de dados totalmente qualificado na cláusula FROM da instrução MDX.
Validação
Tente carregar novamente os dados.
Problema de erro (1260060) do Essbase - MDX
Sintoma
Uma instrução MDX retorna a mensagem de erro "Erro Essbase (1260060): O nome do cubo XXXX não corresponde ao aplicativo/banco de dados atual"
Resolução
Verifique se o nome do aplicativo e o nome do banco de dados totalmente qualificado na cláusula FROM correspondem. Selecione o botão Editar e corrija o nome do aplicativo ou o nome do banco de dados totalmente qualificado na cláusula FROM da instrução MDX
Validação
Tente carregar novamente os dados.
Erro Essbase (1200549): Dimensão repetida [Medidas] na consulta MDX
Sintoma
Carregar uma dimensão retorna a mensagem de erro "Erro Essbase (1200549): Dimensão repetida [Medidas] na consulta MDX".
Resolução
Entre no servidor Essbase, abra o Console dos Serviços de Administração do Essbase e entre com um usuário administrador (ou com quem tiver permissões sobre o banco de dados problemático).
Navegue até o banco de dados do aplicativo > do servidor > Essbase com a dimensão problemática "Medidas".
Desbloqueie o contorno do banco de dados e edite-o.
Determine qual dimensão deve ser o tipo de dimensão "Contas". Clique com o botão direito do mouse e selecione Editar propriedades do membro....
Selecione o campo Tipo de dimensão e defina-o como Contas. Selecione OK.
Verifique e salve a estrutura de tópicos.
Validação
Tente carregar novamente a dimensão.
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários