A Resolver Erros Comuns em Extensões de Modelo Semântico
Resolva os erros de modelo semântico detectados a tempo de evitar falhas de upgrade de patch.
Se você não resolver os erros, seu pipeline poderá ser desativado, as atualizações de versão serão interrompidas e a usabilidade e o suporte poderão ser perdidos como resultado. Use esta lista de soluções para resolver erros comuns. Se você continuar a ter dificuldades depois de seguir essas soluções, crie uma solicitação de serviço para assistência abrangente.
Erro: Coluna ausente na coluna de aumento ou aumento mapeado não disponível
Descrição: Um dos seus aumentos de dados não é mais sincronizado com sua extensão de modelo semântico correspondente. Isso provavelmente ocorreu porque o recurso Opções de SME para Aumento de Dados (na guia Recursos Disponíveis Geral da página Ativar Recursos) estava ativado. Para obter desempenho e estabilidade ideais, a Oracle recomenda que você configure manualmente seu modelo semântico com Extensões de Usuário, em vez de fazer com que o aumento de dados gere automaticamente as extensões de modelo semântico do sistema. O motivo dessa recomendação são as alterações no aumento de dados subjacente, que permanecem referenciadas no modelo semântico, que fazem com que as extensões do modelo semântico fiquem fora de sincronia e falhem. A prática recomendada é separar o processo de Aumento de Dados e Extensão de Modelo Semântico, que fornece maior flexibilidade para modelagem complexa e evita erros. No futuro, ao criar aumentos de dados, sempre use o tipo Conjunto de Dados e defina suas próprias extensões de modelo semântico do usuário. Não crie novos aumentos de dados (do tipo Dimensão, Fato ou Entidade de Extensão) que criem as extensões de modelo semântico do sistema. Se possível, converta todos os seus aumentos de dados existentes em conjuntos de dados e extensões de modelo semântico do usuário.
- Redefina o cache de aumento de dados. Consulte Redefinir o Cache.
- Na Console do Oracle Fusion Data Intelligence, navegue até Configuração de Dados e, em seguida, Aumento de Dados. Localize e edite o aumento de dados problemático. Continue para a etapa subsequente para revisar os atributos selecionados. Desmarque os atributos que não estão mais disponíveis na origem. Navegue pelas configurações usando Next e clique em Finish para salvar e programar suas alterações.
- Após a conclusão do processo de aumento de dados, certifique-se de atualizar e atualizar as extensões de modelo semântico que fazem referência à tabela de destino de aumento de dados para remover quaisquer colunas desativadas.
Para remover todos os objetos não referenciados, realize uma limpeza da área de assunto e da estrela lógica da seguinte forma:
- Crie uma sandbox.
- Edite a área de assunto para remover quaisquer elementos que façam referência às colunas excluídas.
- Edite a estrela lógica para excluir todas as colunas associadas, campos derivados e dimensões. Se a dimensão estiver ausente da estrela lógica, adicione-a novamente e exclua-a.
- Aplique as alterações no sandbox para confirmar suas alterações.
- Mescle o sandbox para Principal.
- Publique o modelo atualizado.
- Revalide o modelo para confirmar que ele está livre de erros.
Dica de Resolução (se estiver vendo esse erro em uma instância de produção):
- O aumento não foi implantado: Neste cenário, você deve executar o pacote de Configuração de Dados que inclui o aumento esperado.
- O aumento foi removido deliberadamente: Se o Aumento foi excluído, você deve primeiro atualizar o modelo semântico no ambiente inferior para remover a referência a ele. Após remover a referência, reimplante o pacote de modelos semânticos para a instância de produção.
Erro: As colunas personalizadas têm um caractere de espaço em branco à esquerda ou à direita
Descrição: O nome para exibição de um atributo, coluna derivada ou coluna física começa ou termina com um espaço.
- Edite a estrela lógica e selecione Adicionar atributos para todas as colunas com espaços extras no início ou no final de seus nomes de exibição.
- Em Nome para Exibição, remova qualquer espaço em branco à esquerda ou à direita das colunas recém-selecionadas. Clique fora do campo para salvar a alteração.
- Siga as próximas etapas e salve as modificações.
- Aplique as alterações no seu sandbox.
- Mescle o sandbox para o sandbox principal.
- Publique o modelo atualizado.
- Revalide o modelo para confirmar que ele está livre de erros.
As colunas selecionadas adicionais no asterisco lógico não aparecerão automaticamente na área de assunto voltada para o usuário, a menos que você as adicione explicitamente.
Erro: os atributos da área de assunto têm um caractere de espaço em branco à esquerda ou à direita. Verifique o nome/descrição/pastas/colunas da área de assunto para obter possíveis espaços em branco
Descrição: O nome para exibição de um nome de área de assunto, descrição, pasta ou nome de coluna começa ou termina com um espaço.
Dica de Resolução: Edite a área de assunto e, em seguida, edite a personalização problemática, localize e remova todos os espaços à esquerda e à direita em nomes de áreas de assunto, descrições, pastas e nomes de colunas.
Erro: A etapa está no estado de erro
Descrição: Ocorreu um erro nesta etapa durante a compilação do modelo semântico.
Dica de Resolução: Edite a etapa com falha, investigue, identifique os erros e resolva-os.
As etapas de personalização podem estar em um estado de erro porque a origem da extensão não está mais acessível. Isso é indicado pela lista suspensa de objetos que mostra "Selecionar" em vez do nome correto do objeto quando você edita a personalização.
- A instância não tem configurações de dados personalizados referenciados, incluindo aumentos de dados, flexfields descritivos (DFFs) e análise de conta configurável.
- O objeto de banco de dados nunca foi migrado para o Autonomous AI Lakehouse.
- As permissões necessárias, como GRANT SELECT ON "OAX_USER"."TABLE_VIEW" TO "OAX$OAC", não foram aplicadas ou foram removidas.
- O nome do objeto contém caracteres especiais não suportados, como parênteses.
Erro: A última etapa na ramificação tem erros de verificação de consistência.
Descrição: Ocorreu um erro durante a compilação do modelo semântico.
Dica de Resolução: O erro indica uma falha na etapa final, mas a causa raiz provavelmente está em um estágio anterior. Edite a última etapa com falha, investigue, identifique os erros e resolva-os.
Erro: "Limite máximo de linhas excedido" ou "Falha na execução da consulta: Limite máximo de linhas excedido" na pasta de trabalho.
Descrição: Esses erros aparecem na pasta de trabalho após o modelo semântico ter sido publicado.
Dica de Resolução: Esse problema pode estar relacionado a um tamanho de coluna de atributo estendido superior a 256 caracteres. Para resolver esse problema, modifique a definição da coluna para que o tamanho dela seja menor ou igual a 256 caracteres.
Por exemplo, ALTER TABLE TABLE_NAME MODIFY (COLUMN_NAME VARCHAR2(256));