A Résoudre les erreurs communes 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 des correctifs.
Si vous ne résolvez pas les erreurs, il se peut que votre pipeline soit désactivé, que les mises à jour de version soient arrêtées et que la convivialité et la prise en charge soient perdues. Utilisez cette liste de solutions pour résoudre les erreurs courantes. Si vous continuez à éprouver des difficultés après avoir suivi ces solutions, créez une demande de service pour une assistance complète.
Erreur : Colonne manquante dans l'augmentation ou colonne 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 fonction SME Options for Data Augmentation (Options PME pour l'augmentation de données) (sous l'onglet Generally Available Features (Fonctions généralement disponibles) de la page Enable Features (Activer les fonctions) a été activée. Pour une performance et une stabilité optimales, Oracle recommande de configurer manuellement votre modèle sémantique avec des extensions d'utilisateur, plutôt que de faire en sorte que l'augmentation de données génère automatiquement les extensions de modèle sémantique du système. La raison de cette recommandation est que des modifications apportées à l'augmentation de données sous-jacente, qui restent référencées dans le modèle sémantique, entraînent une désynchronisation et un échec de vos extensions de modèle sémantique. Il est recommandé de séparer le processus d'augmentation de données et d'extension de modèle sémantique, qui offre une plus grande souplesse pour la modélisation complexe et prévient les erreurs. À 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 d'utilisateur. Ne créez pas de nouvelles augmentations de données (de type Dimension, Fait ou Extension d'entité) qui créent les extensions de modèle sémantique du système. Dans la mesure du possible, convertissez toutes vos augmentations de données existantes en jeux de données et en extensions de modèle sémantique d'utilisateur.
- Réinitialisez la mémoire cache d'augmentation de données. Voir Réinitialiser la mémoire cache.
- Dans la console d'Oracle Fusion Data Intelligence, naviguez jusqu'à Configuration de données, puis jusqu'à Augmentation de 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 les attributs qui ne sont plus disponibles dans la source. Naviguez dans les configurations à l'aide de Suivant, puis cliquez sur Terminer pour enregistrer et programmer vos modifications.
- Une fois le processus d'augmentation de données terminé, assurez-vous d'actualiser et de mettre à jour les extensions de modèle sémantique qui référencent la table cible d'augmentation de données pour supprimer 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 :
- Créez un modèle d'environnement restreint.
- Modifiez le domaine pour supprimer tous les éléments qui référencent les colonnes supprimées.
- Modifiez l'étoile logique pour supprimer toutes les colonnes, tous les champs dérivés et toutes les dimensions associés. Si la dimension est manquante dans l'étoile logique, ajoutez-la de nouveau, puis supprimez-la.
- Appliquez les modifications au bac à sable pour confirmer les modifications.
- Fusionnez le bac à sable avec Principal.
- Publier le modèle mis à jour.
- Revalidez le modèle pour confirmer qu'il n'y a pas d'erreur.
Conseil sur la résolution (si cette erreur est détectée dans une instance de production) :
- L'augmentation n'a pas été déployée : Dans ce scénario, vous devez exécuter l'ensemble de configuration des données qui inclut l'augmentation attendue.
- 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 supprimer la référence à celle-ci. Après avoir supprimé la référence, redéployez l'ensemble de modèles sémantiques vers l'instance de production.
Erreur : Les colonnes personnalisées comportent un blanc 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 une espace.
- 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 leurs noms d'affichage.
- Dans Nom d'affichage, supprimez tous les blancs de début ou de fin des colonnes nouvellement sélectionnées. Cliquez en dehors du champ pour enregistrer la modification.
- Passez aux étapes suivantes et enregistrez vos modifications.
- Appliquez les modifications dans votre bac à sable.
- Fusionnez le bac à sable avec le bac à sable principal.
- Publier le modèle mis à jour.
- Revalidez le modèle pour confirmer qu'il n'y a pas d'erreur.
Les colonnes sélectionnées supplémentaires dans l'étoile logique n'apparaîtront pas automatiquement dans le domaine orienté utilisateur, sauf si vous les ajoutez explicitement.
Erreur : Les attributs de domaine comportent un blanc de début ou de fin. Vérifiez les espaces possibles dans le nom/la description/les dossiers/les colonnes du domaine
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 une espace.
Conseil sur la résolution : Modifiez le domaine, puis modifiez la personnalisation problématique, localisez et supprimez tous les espaces de début et de fin dans les noms de domaine, les descriptions, les dossiers et les noms de colonne.
Erreur : L'étape a l'état Erreur
Description : Une erreur est survenue à cette étape lors de la compilation du modèle sémantique.
Conseil sur la résolution : Modifiez l'étape qui a échoué, examinez, identifiez les erreurs et résolvez-les.
Les étapes de personnalisation peuvent être dans un état d'erreur, car la source de l'extension n'est plus accessible. Cela est indiqué par la liste déroulante d'objets affichant "Select" au lieu du nom d'objet correct lorsque vous modifiez la personnalisation.
- Les configurations de données personnalisées référencées sont manquantes dans l'instance, notamment les augmentations de données, les champs flexibles descriptifs et l'analyse de compte configurable.
- L'objet de base de données n'a jamais été migré vers une base de données Autonomous Data Warehouse.
- Les autorisations nécessaires, telles que GRANT SELECT ON "OAX_USER"."TABLE_VIEW" TO "OAX$OAC", n'ont pas été appliquées ou ont été supprimées.
- Le nom de l'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 est survenue lors de la compilation du modèle sémantique.
Conseil pour 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.