La couche sémantique
Administrateurs disposant de la permission Modèles sémantiques.
La couche sémantique est la description gouvernée de vos données. Plutôt que chacun écrive son propre SQL — avec sa propre définition subtilement différente du « chiffre d'affaires » —, les administrateurs décrivent les données une seule fois, et chaque graphique, tableau, carte et réponse d'Axi compile sur ces définitions partagées.
Les modèles sémantiques
Chaque connexion possède un jeu de modèles sémantiques, typiquement un par table. Un modèle rassemble tout ce qu'Axiome sait de cette table :
- Aperçu — un nom d'affichage et une description (« Que représente une ligne de ce modèle ? »). La description apparaît dans le catalogue et sert à ancrer Axi : une bonne description améliore directement les réponses de l'IA.
- Clés — clés primaires et étrangères, qui déclarent comment les modèles se joignent.
- Dimensions — les attributs pour grouper et filtrer.
- Mesures — les agrégations sur les lignes.
- Métriques — les définitions métier construites sur les mesures.
Les modèles se gèrent dans Paramètres → Administration → Modèles sémantiques. Cette page traite une connexion à la fois — choisissez laquelle dans le sélecteur en haut.
Les équipes qui maintiennent un projet dbt n'ont pas à écrire ces définitions à la main — voir Importer depuis dbt.
Généré, modifié, personnalisé
À la création d'une connexion (et à chaque Rafraîchir le schéma), Axiome introspecte la base et génère un modèle de base pour chaque table : dimensions et mesures déduites des noms et types de colonnes. Chaque élément porte un badge de provenance :
- Généré — produit depuis le schéma, intact.
- Modifié — généré puis personnalisé (les champs surchargés sont listés).
- Personnalisé — créé de toutes pièces par un administrateur.
Les métriques sont toujours organisées à la main — Axiome n'invente jamais de définitions métier à votre place.
Vous pouvez à tout moment Réinitialiser vers le généré pour abandonner toutes les personnalisations d'un modèle et revenir à la base générée. C'est irréversible.
Rafraîchir le schéma
Quand le schéma de votre base change, cliquez sur Rafraîchir le schéma. Axiome ré-introspecte la source et produit un rapport par modèle : colonnes nouvelles, supprimées, changées ou inchangées. Vos personnalisations sont conservées ; une dimension dont la colonne sous-jacente a disparu est signalée comme orpheline pour que vous puissiez la corriger ou la supprimer.
Édition concurrente
L'édition des modèles est sûre en équipe : si quelqu'un d'autre a enregistré le même modèle pendant que vous l'éditiez, Axiome détecte le conflit et vous demande de recharger avant de réappliquer vos changements — pas d'écrasement silencieux.
Pourquoi c'est important pour Axi
Axi planifie ses requêtes sur la couche sémantique : descriptions des modèles, noms des dimensions et mesures, définitions des métriques et chemins de jointure déclarés. Une couche bien organisée est le levier le plus efficace pour rendre les réponses d'Axi justes. Masquez les colonnes internes, décrivez vos modèles et définissez vos métriques clés.