Documentação do Oracle Cloud Infrastructure

Recomendações e Dicas para Estender o Modelo Semântico

Antes de estender seu modelo semântico, revise as recomendações e dicas para garantir que suas extensões funcionem conforme esperado.

Estrutura de Extensões de Modelo Semântico

Estrutura da Agência

Se você ainda estiver na estrutura de Ramificação de Modelo Semântico, agora é a hora de migrar para a estrutura de Sandbox. Consulte Migrar para o Sandbox Framework para Extensões de Modelo Semântico.

Estrutura de Sandbox

Mantenha apenas as sandboxes em uso. Exclua os sandboxes que você usou para testar e que não estão mais em uso. Manter sandboxes não utilizados adicionais degrada o desempenho do sistema.

Objetos de Banco de Dados

Padrões de Nomenclatura do Banco de Dados para Objetos do Autonomous AI Lakehouse

  • Prefixe um objeto personalizado com X_ZZZ_, em que ZZZ é uma abreviação da sua organização.
  • Sufixo de objetos diferentes como:
    • _A = Agregado
    • _D = Dimensão
    • _DH = Hierarquia da Dimensão
    • _F = Fato
    • _H = Auxiliar
    • _M = Dimensão do Mapa
    • _MD = Mini Dimensão
    • _V = Visualizações
    • _MV = View Materializada
    • _DS = Conjunto de dados de aumento de dados
    • _EXT = Extensão de Aumento de Dados
  • Não crie objetos de banco de dados personalizados começando com "DW" porque isso pode resultar em conflitos com os nomes de objetos pré-criados. Objetos de banco de dados personalizados que começam com "DW" podem causar comportamento inconsistente no assistente de Extensões de Modelo Semântico.
  • Não use esses sufixos reservados pelo sistema para os nomes de esquema personalizados: DW, OAC, INFRA, SECURITY, USER ou CORE.

    Se você usar um desses sufixos reservados pelo sistema para os nomes de esquema personalizados, corre o risco de conceder privilégios não intencionais ao seu esquema personalizado durante o processamento do pipeline.

Flexfields e Conjuntos de Dados de Aumento de Dados

  • Certifique-se de que as alterações na origem sejam tratadas na sua instância do Oracle Fusion Data Intelligence. Por exemplo, se um flexfield descritivo usado em uma área de assunto personalizada tiver sido desativado na origem, você deverá substituir ou remover o flexfield descritivo aplicável no Oracle Fusion Data Intelligence ou a extensão de modelo semântico aplicável falhará.
  • Você pode fazer referência a sinônimos dos conjuntos de dados de aumento de dados nas extensões de modelo semântico após a conclusão do carregamento completo inicial do aumento de dados. Use a opção Executar Imediatamente no aumento de dados para executar a carga completa imediatamente.

Estendendo

Geral
  • Ao nomear objetos (dimensões, fatos e colunas), remova todos os espaços à esquerda e à direita. É possível usar sublinhados e espaços em nomes, mas evite todos os outros caracteres especiais.
  • Ao adicionar atributos personalizados ou definir chaves usadas para associação, certifique-se de que o nome para exibição seja exclusivo e não entre em conflito com nenhum dos nomes de coluna pré-criados.
Estender Dimensão
  • Importante: Você deve manter as extensões no mínimo e combiná-las para evitar sobrecarga desnecessária e desempenho degradado. Ao estender uma dimensão (se a granularidade da extensão for de um a um [1:1] com a dimensão pré-criada), combine várias extensões para a mesma dimensão em uma única fonte (tabela/visualização/sinônimo) no Autonomous AI Lakehouse. É preferível ter uma extensão com muitas colunas, em vez de ter várias extensões por coluna.
  • Cuidado: Ao estender uma dimensão, é altamente recomendável associar-se à chave de dimensão base. Se não for possível associar a chave de dimensão base, você poderá associar-se a outra coluna base com cautela, validando a granularidade e a cardinalidade dos dados. É altamente recomendável não associar-se a outra coluna de extensão. O sistema processa as extensões com dependências sequencialmente, aumentando o tempo necessário para aplicar e publicar o sandbox e pode ter um impacto negativo no desempenho da consulta.
  • Ao estender as pastas de Dimensões DEGEN ("Detalhes"), sempre mantenha o mesmo nível de granularidade unindo a(s) chave(s) primária(s) do fato com um relacionamento de um para um [1:1]. Não defina associações de muitos para muitos [M:M] porque isso pode causar degradação do desempenho e duplicação de dados.
  • Tenha cuidado ao estender dimensões que têm relações de um para muitos (1:M) (como seleção múltipla), porque:
    • Eles podem resultar em duplicação de dados porque os dados estendidos são de menor granularidade que a dimensão pai.
    • O tamanho máximo do índice de extensão pode ser excedido.

    Para evitar a constraint, nomeie a tabela/view/sinônimo o mais curto possível. Por exemplo, FDI_X_SZ_V (Tamanho) e FDI_X_PR_V (Preço).

  • Antes de estender um objeto lógico, valide se a tabela de apresentação associada está exposta na área de assunto. Consulte as planilhas de linhagem de modelo semântico aplicáveis:
  • Ao estender uma dimensão, se a tabela que você selecionar for uma tabela de aumento, selecione-a no esquema OAX$OAC em vez de OAX_USER. O esquema principal para tabelas de aumento é OAX$OAC, embora as tabelas de aumento também estejam presentes no OAX_USER.
  • O tamanho estendido da coluna de atributo não pode exceder 256 caracteres.
  • Ao estender dimensões, escolha um tipo de junção com base no tipo de dimensão (degenerado ou em conformidade) e no relacionamento entre as tabelas base e de extensão. Sua escolha depende se você deseja reter ou descartar os registros sem correspondência.
    • Left Outer: Recomendado para a maioria das extensões para preservar todas as linhas da tabela base, especialmente para relações 1:many ou quando a tabela estendida está incompleta. Isso evita a eliminação involuntária de linhas base.
    • Interno: Melhor para um relacionamento verdadeiro 1:1 quando você quiser apenas registros que existam em ambas as tabelas e se sintam confortáveis, excluindo as linhas sem correspondência. Não recomendado ao estender dimensões degeneradas.
    • Exterior direito: usado com pouca frequência. Escolha esta opção quando precisar preservar todas as linhas da tabela estendida e extrair somente as linhas correspondentes da tabela base.
    • Full Outer: Use com cuidado para manter todas as linhas de ambas as tabelas, independentemente das correspondências. Não use Full Outer em dimensões degeneradas porque elas podem introduzir duplicação de dados e degradação de desempenho.

Criar Dimensão

  • Ao criar uma dimensão personalizada, você pode desmarcar Adicionar hierarquia à Área de Assunto. No entanto, ainda é necessário definir uma Chave Primária de Hierarquia e um Atributo de Exibição. Clique na pasta Detalhes dos Elementos de Dados Selecionados e, em seguida, no ícone de edição Propriedades para definir a Chave Primária da Hierarquia e o Atributo de Exibição.

Criar Dimensões de Degeneração

  • Evite adicionar atributos de dimensão não gerados às tabelas de fatos. Em vez disso, selecione o indicador de degeneração para o atributo ao definir a definição da tabela de fatos. Atributos de dimensão não sinalizados nas tabelas de fatos afetarão negativamente sua estrutura de relatório, aumentarão o risco de erros de tempo de execução e complicarão a manutenção do sistema.
Criar Fato
  • Ao adicionar um fato personalizado, sempre defina os níveis de conteúdo para as dimensões personalizadas que estão se unindo ao fato personalizado.
  • Ao associar fatos a dimensões, certifique-se de que as colunas que estão sendo unidas sejam de tipos de dados compatíveis.
Criar Hierarquia
  • Ao adicionar uma hierarquia personalizada, evite exibir os níveis totais gerais nas visualizações porque as hierarquias personalizadas são expostas apenas do primeiro nível. As hierarquias predefinidas também não expõem os níveis totais. O nível Total Geral apenas fornece o valor total geral; portanto, use-o somente quando não houver junção entre um fato e uma dimensão e a métrica precisar ser definida em um nível total.
  • Ao definir uma hierarquia, é necessário mapear todos os elementos de dados disponíveis para um nível ou detalhes.
  • Antes de editar uma hierarquia (como adicionar, remover ou alterar níveis), primeiro remova a hierarquia da Área de Assunto, edite a hierarquia e, em seguida, adicione a hierarquia de volta à Área de Assunto.
  • No momento, a estrutura Sandbox não suporta a adição de hierarquias baseadas em valor a uma área de assunto.

Adicionando Colunas

  • Aplicar funções e agregações diretamente às colunas base. Evite aninhar colunas derivadas para evitar dependências desnecessárias, sobrecarga de processamento, atrasos e possíveis erros de cálculo no modelo semântico.
  • Evite adicionar colunas que já estejam presentes no Modelo Semântico existente; isso cria junções redundantes e aumenta a sobrecarga de processamento.
  • Ao trabalhar com fatos e dimensões personalizados, evite usar colunas derivadas. Em vez disso, execute os cálculos necessários na camada do banco de dados ou defina a expressão diretamente no objeto durante o processo de criação.

Usando Configurações de Dados Personalizadas

  • Se você utilizar uma Configuração de Dados Personalizados especializada, como Análise de Conta Configurável, Fusion Accounting Hub ou Aplicativo do Supply Chain Planning, deverá implementar toda a personalização necessária exclusivamente dentro do aplicativo. Evite criar configurações duplicadas no modelo semântico, pois isso introduz dependências redundantes e custos indiretos de processamento desnecessários.

Implantação

  • As migrações devem fluir apenas em uma única direção. Escolha um ambiente para ser o ambiente mestre de Desenvolvimento. Após o teste de aceitação do usuário, gere e implante um pacote de Extensões Semânticas para migrar alterações para a Produção e outros ambientes.
  • Se o modelo semântico proteger objetos com atribuições de aplicativo, grupos ou usuários recém-configurados, certifique-se de importar e implantar o pacote de Segurança antes de importar e implantar o pacote de Modelos Semânticos.