Documentation Oracle Cloud Infrastructure

A Résoudre les erreurs courantes dans les extensions de modèle sémantique

Vous devez résoudre les erreurs de modèle sémantique détectées à temps pour éviter les échecs de mise à niveau de patch.

Si vous ne résolvez pas les erreurs, votre pipeline peut être désactivé, les mises à jour de version arrêtées et la facilité d'utilisation et la prise en charge risquent d'être perdues. Utilisez cette liste de solutions pour résoudre les erreurs courantes. Si vous continuez à rencontrer des difficultés après avoir suivi ces solutions, créez une demande de service pour une assistance complète.

Erreur : colonne manquante dans la colonne d'augmentation ou d'augmentation mappée non disponible

Description : l'une de vos augmentations de données n'est plus synchronisée avec l'extension de modèle sémantique correspondante. Cela est probablement dû au fait que la fonctionnalité Options SME pour l'augmentation des données (sous l'onglet Fonctions généralement disponibles de la page Activer les fonctions) a été activée. Pour des performances et une stabilité optimales, Oracle recommande de configurer manuellement votre modèle sémantique avec des extensions utilisateur, plutôt que de faire en sorte que l'augmentation des données génère automatiquement les extensions de modèle sémantique système. La raison de cette recommandation est que toute modification apportée à l'augmentation de données sous-jacente, qui reste référencée dans le modèle sémantique, entraîne l'abandon de la synchronisation et l'échec de vos extensions de modèle sémantique. La pratique recommandée consiste à séparer le processus d'augmentation des données et d'extension du modèle sémantique, qui permet une modélisation plus flexible et empêche les erreurs. A l'avenir, lors de la création d'augmentations de données, utilisez toujours le type de jeu de données et définissez vos propres extensions de modèle sémantique utilisateur. Ne créez aucune augmentation de données (de type Dimension, Fait ou Entité d'extension) qui crée les extensions de modèle sémantique système. Si possible, convertissez toutes vos augmentations de données existantes en jeux de données et extensions de modèle sémantique utilisateur.

Conseil sur la résolution (si vous voyez cette erreur dans une instance hors production) :
  1. Réinitialiser le cache d'augmentation des données. Reportez-vous à Réinitialisation du cache.
  2. Dans la console d'Oracle Fusion Data Intelligence, accédez à Configuration des données, puis à Augmentation des données. Localisez et modifiez l'augmentation de données problématique. Passez à l'étape suivante pour vérifier les attributs sélectionnés. Désélectionnez tous les attributs qui ne sont plus disponibles dans la source. Parcourez les configurations à l'aide de l'option Suivant, puis cliquez sur Terminer pour enregistrer et programmer vos modifications.
  3. Une fois le processus d'augmentation des données terminé, veillez à actualiser et à mettre à jour les extensions de modèle sémantique qui référencent la table cible d'augmentation des données pour enlever les colonnes désactivées.
    Pour supprimer tous les objets non référencés, effectuez un nettoyage du domaine et de l'étoile logique comme suit :
    1. Créez un modèle d'environnement restreint.
    2. Modifiez le domaine pour supprimer tous les éléments qui référencent les colonnes supprimées.
    3. Modifiez l'étoile logique pour supprimer toutes les colonnes, champs dérivés et dimensions associés. Si la dimension est absente de l'étoile logique, ajoutez-la à nouveau, puis supprimez-la.
    4. Appliquez les modifications dans le modèle d'environnement restreint pour confirmer vos modifications.
    5. Fusionnez le modèle d'environnement restreint vers la page principale.
    6. Publier le modèle mis à jour.
    7. Validez à nouveau le modèle pour confirmer qu'il est exempt d'erreurs.

Conseil sur la résolution (si l'erreur est détectée dans une instance de production) :

Lorsque vous constatez que certaines colonnes d'augmentation sont absentes dans l'instance de production, la cause en est généralement l'un des deux scénarios suivants :
  1. L'augmentation n'a pas été déployée : dans ce scénario, vous devez exécuter le bundle de configuration de données qui inclut l'augmentation attendue.
  2. L'augmentation a été délibérément supprimée : si l'augmentation a été supprimée, vous devez d'abord mettre à jour le modèle sémantique dans l'environnement inférieur pour enlever la référence à celui-ci. Après avoir enlevé la référence, redéployez le groupe de modèles sémantiques sur l'instance de production.

Erreur : les colonnes personnalisées comportent des caractères non imprimables de début ou de fin

Description : le nom d'affichage d'un attribut, d'une colonne dérivée ou d'une colonne physique commence ou se termine par un espace.

Conseil sur la résolution : cette erreur se produit lorsque les noms d'affichage des attributs non sélectionnés contiennent des espaces de début ou de fin. Pour résoudre ce problème :
  1. Modifiez l'étoile logique et sélectionnez Ajouter des attributs pour toutes les colonnes avec des espaces supplémentaires au début ou à la fin de leur nom d'affichage.
  2. Dans Nom d'affichage, enlevez les espaces de début ou de fin des colonnes nouvellement sélectionnées. Cliquez en dehors du champ pour enregistrer la modification.
  3. Passez aux étapes suivantes et enregistrez vos modifications.
  4. Appliquez les modifications dans votre modèle d'environnement restreint.
  5. Fusionnez le modèle d'environnement restreint avec le modèle d'environnement restreint principal.
  6. Publier le modèle mis à jour.
  7. Revalidez le modèle pour confirmer qu'il est exempt d'erreurs.
Remarque

Les colonnes sélectionnées supplémentaires dans l'étoile logique n'apparaîtront pas automatiquement dans le domaine destiné à l'utilisateur, sauf si vous l'ajoutez explicitement.

Erreur : les attributs de domaine comportent des caractères non imprimables de début ou de fin. Vérifiez le nom du domaine/la description/les dossiers/les colonnes pour connaître les espaces possibles

Description : le nom d'affichage d'un nom de domaine, d'une description, d'un dossier ou d'une colonne commence ou se termine par un espace.

Conseil sur la résolution : modifiez le domaine, puis modifiez la personnalisation problématique, localisez et enlevez tous les espaces de début et de fin sur les noms de domaine, les descriptions, les dossiers et les noms de colonne.

Erreur : l'étape est en état d'erreur

Description : une erreur s'est produite lors de cette étape lors de la compilation du modèle sémantique.

Conseil sur la résolution : modifiez l'étape ayant échoué, examinez, identifiez les erreurs et résolvez-les.

Les étapes de personnalisation peuvent présenter un état d'erreur car la source de l'extension n'est plus accessible. Ceci est indiqué par la liste déroulante d'objets affichant "Sélectionner" au lieu du nom d'objet correct lorsque vous modifiez la personnalisation.

L'objet de base de données introuvable peut se produire pour les raisons suivantes :
  • Il manque des configurations de données personnalisées référencées à l'instance, notamment des augmentations de données, des champs flexibles descriptifs et une analyse de compte configurable.
  • L'objet de base de données n'a jamais été migré vers Autonomous Data Warehouse.
  • Les droits d'accès nécessaires, tels que GRANT SELECT ON "OAX_USER"."TABLE_VIEW" TO "OAX$OAC", n'ont pas été appliqués ou ont été enlevés.
  • Le nom d'objet contient des caractères spéciaux non pris en charge, tels que des parenthèses.

Erreur : la dernière étape de la branche comporte des erreurs de vérification de cohérence.

Description : une erreur s'est produite lors de la compilation du modèle sémantique.

Conseil sur la résolution : l'erreur indique un échec à l'étape finale, mais la cause première réside probablement dans une étape antérieure. Modifiez la dernière étape ayant échoué, examinez, identifiez les erreurs et résolvez-les.