Documentation Oracle Cloud Infrastructure

Recommandations et conseils pour étendre le modèle sémantique

Avant d'étendre votre modèle sémantique, consultez les recommandations et les conseils pour vous assurer que vos extensions fonctionnent comme prévu.

Structure d'extensions de modèle sémantique

Structure de succursale

Si vous utilisez toujours la structure Semantic Model Branch, le moment est venu de migrer vers la structure Sandbox. Reportez-vous à Migration vers la structure Sandbox pour les extensions de modèle sémantique.

Environnement Sandbox

Conservez uniquement les modèles d'environnement restreint en cours d'utilisation. Supprimez les modèles d'environnement restreint que vous avez utilisés pour le test et qui ne sont plus utilisés. La gestion d'autres modèles d'environnement restreint inutilisés dégrade les performances du système.

Objets de base de données

Normes de dénomination des bases de données pour les objets Autonomous Data Warehouse

  • Préfixez un objet personnalisé avec X_ZZZ_, où ZZZ est l'abréviation de votre organisation.
  • Suffixez différents objets comme suit :
    • _A = Agrégat
    • _D = Dimension
    • _DH = Hiérarchie des dimensions
    • _F = Fait
    • _H = Aide
    • _M = Dimension de carte
    • _MD = Mini dimension
    • _V = Vues
    • _MV = Vue matérialisée
    • _DS = Jeu de données d'augmentation de données
    • _EXT = Extension d'augmentation des données
  • Il est recommandé de ne pas créer d'objets de base de données personnalisés commençant par "DW", car cela peut entraîner des conflits avec les noms d'objet prédéfinis. Les objets de base de données personnalisés commençant par "DW" peuvent entraîner un comportement incohérent dans l'assistant Extensions de modèle sémantique.

Jeux de données et champs flexibles d'augmentation de données

  • Assurez-vous que les modifications apportées à la source sont traitées dans votre instance Oracle Fusion Data Intelligence. Par exemple, si un champ utilisateur flexible utilisé dans un domaine personnalisé a été désactivé dans la source, vous devez remplacer ou supprimer le champ utilisateur flexible applicable dans Oracle Fusion Data Intelligence, sinon l'extension de modèle sémantique applicable échoue.
  • Vous pouvez référencer des synonymes à partir des jeux de données d'augmentation de données dans les extensions de modèle sémantique une fois le chargement complet initial de l'augmentation de données terminé. Utilisez l'option "Exécuter immédiatement" dans l'augmentation des données pour exécuter immédiatement le chargement complet.

Extension

Généralités
  • Lorsque vous nommez des objets (dimensions, faits et colonnes), supprimez tous les espaces de début et de fin. Vous pouvez utiliser des traits de soulignement et des espaces dans les noms, mais éviter tous les autres caractères spéciaux.
  • Lorsque vous ajoutez des attributs personnalisés ou que vous définissez des clés utilisées pour la jointure, assurez-vous que le nom d'affichage est unique et n'entre pas en conflit avec les noms de colonne prédéfinis.
Etendre la dimension
  • Important : vous devez réduire au minimum les extensions et les combiner pour éviter les surcharges inutiles et les performances dégradées. Lors de l'extension d'une dimension (si la granularité de l'extension est de un à un [1:1] avec la dimension prédéfinie), combinez plusieurs extensions pour la même dimension dans une source unique (table/vue/synonyme) dans Autonomous Data Warehouse. Il est préférable d'avoir une extension avec plusieurs colonnes, plutôt que d'avoir plusieurs extensions par colonne.
  • Attention : lors de l'extension d'une dimension, il est fortement recommandé de la joindre à la clé de dimension de base. S'il n'est pas possible d'effectuer une jointure sur la clé de dimension de base, vous pouvez effectuer une jointure sur une autre colonne de base avec prudence, en validant le grain et la cardinalité des données. Il est fortement déconseillé de se joindre à une autre colonne d'extension. Le système traite les extensions avec des dépendances de manière séquentielle, ce qui allonge le temps nécessaire à l'application et à la publication du modèle d'environnement restreint et peut avoir un impact négatif sur les performances des requêtes.
  • Lors de l'extension des dossiers DEGEN Dimensions ("Détails"), maintenez toujours le même niveau de granularité en rejoignant la ou les clés primaires du fait avec une relation de un à un [1:1]. Ne définissez pas de jointures [N:N] à plusieurs car cela peut entraîner une dégradation des performances et la duplication des données.
  • Soyez prudent lorsque vous étendez des dimensions ayant une à plusieurs relations (1:N) (telles que la sélection multiple), car :
    • Elles peuvent entraîner une duplication des données car les données étendues présentent un grain inférieur à celui de la dimension parent.
    • La longueur maximale de l'index d'extension peut être dépassée.

    Pour éviter la contrainte, nommez la table/vue/synonyme aussi court que possible. Par exemple, FDI_X_SZ_V (Taille) et FDI_X_PR_V (Prix).

  • Lors de l'extension d'une dimension, si la table que vous sélectionnez est une table d'augmentation, sélectionnez-la dans le schéma OAX$OAC au lieu de OAX_USER. Le schéma principal des tables d'augmentation est OAX$OAC, même si les tables d'augmentation sont également présentes dans OAX_USER.

Créer une dimension

  • Lors de la création d'une dimension personnalisée, vous pouvez désélectionner "Ajouter une hiérarchie au domaine". Cependant, il est toujours nécessaire de définir une clé primaire de hiérarchie et un attribut d'affichage. Cliquez sur le dossier Détails des éléments de données sélectionnés, puis sur l'icône de modification Propriétés pour définir la clé primaire de hiérarchie et l'attribut d'affichage.
Créer un fait
  • Lors de l'ajout d'un fait personnalisé, définissez toujours les niveaux de contenu des dimensions libres qui sont jointes au fait personnalisé.
  • Lorsque vous joignez des faits à des dimensions, assurez-vous que les colonnes jointes sont de types de données compatibles.
Créer une Hiérarchie
  • Lors de l'ajout d'une hiérarchie personnalisée, évitez de viser à afficher le total général des niveaux dans les visualisations car les hiérarchies personnalisées ne sont affichées qu'à partir du premier niveau. Les hiérarchies prédéfinies n'exposent pas non plus le total des niveaux. Le niveau Total général donne simplement le montant total général ; par conséquent, utilisez-le uniquement lorsqu'il n'y a pas de jointure entre un fait et une dimension et que la mesure doit être définie à un niveau total.
  • Lors de la définition d'une hiérarchie, il est nécessaire de mapper tous les éléments de données disponibles sur un ou plusieurs niveaux.

Déploiement

  • Les migrations doivent circuler dans une seule direction. Choisissez un environnement comme environnement de développement maître. Après le test d'acceptation par les utilisateurs, générez et déployez un bundle Semantic Extensions pour migrer les modifications vers les environnements de production et autres.
  • Si le modèle sémantique sécurise les objets avec des rôles d'application, des groupes ou des utilisateurs nouvellement configurés, assurez-vous d'importer et de déployer le groupe Security avant d'importer et de déployer le groupe Semantic Model.