Personnaliser les descriptions de colonnes et les instructions d’utilisation

  • Rversion finale: Australia
  • Mis à jour 17 avr. 2026
  • 3 minutes de lecture
  • Créez des descriptions de colonnes personnalisées et des instructions d’utilisation dans la table Configuration de colonne sémantique afin que les personnalisations puissent être transférées entre les instances via des ensembles de mises à jour.

    Avant de commencer

    Rôle requis : sn_query_gen.admin ou un rôle supérieur

    Pourquoi et quand exécuter cette tâche

    La Génération de requête couche sémantique utilise des descriptions de colonnes et des instructions d’utilisation pour aider l’IA à comprendre ce que chaque champ représente et comment l’interroger. Vous pouvez remplacer les descriptions générées automatiquement à partir de la table sys_documentation et ajouter des instructions d’utilisation qui guident la construction de requêtes.

    Cette procédure utilise la table Configuration de colonne sémantique. Les personnalisations effectuées de cette manière peuvent être transférées entre les instances via des ensembles de mises à jour et des descriptions de remplacement et des instructions d’utilisation définies directement dans la table Dimension. Pour des tests plus simples sur une seule instance, vous pouvez modifier les champs Étiquette sémantique et Instructions d’utilisation sémantique directement dans la table Dimension [sn_query_gen_dimension]. Ces modifications peuvent être remplacées par des modifications apportées à la table Dimension incluse dans une mise à niveau de module d’extension.

    Utilisez la configuration de colonne lorsque vous souhaitez fournir des descriptions personnalisées, ajouter des instructions d’utilisation pour les conseils de requête ou désactiver des colonnes spécifiques sans supprimer la table entière de la couche sémantique.

    Procédure

    1. Accédez à la Génération de requête > Configuration de la colonne sémantique.
    2. Sélectionnez Nouveau.
    3. Dans le formulaire Configuration de colonne sémantique, renseignez les informations suivantes.
      Tableau 1. Formulaire Configuration de colonne sémantique
      Champ Description
      Nom de la table Table à laquelle appartient la colonne. Doit avoir une entité active dans la couche sémantique.
      Nom de colonne Colonne à configurer. Utilisez le nom de colonne de base de données, pas l’étiquette d’affichage.
      Description sémantique Description personnalisée de ce que la colonne représente en termes commerciaux. Remplace la description générée automatiquement à partir de sys_documentation. 2 000 caractères maximum.
      Instructions d'utilisation sémantique Conseils à l’IA sur la façon d’utiliser cette colonne pendant la génération de requêtes. Incluez les opérateurs préférés, les formats des valeurs attendues et le comportement de filtrage. 2 000 caractères maximum.
      Actives Indique si la configuration de colonne est appliquée. Lorsque cette option est décochée, la colonne revient à l’état généré automatiquement.
    4. Sélectionnez Envoyer.
      Le système synchronise automatiquement la configuration avec l’enregistrement de dimension correspondant dans la couche sémantique.

    Résultats

    La configuration de colonne personnalisée est active et sera utilisée lors Génération de requête du traitement des requêtes qui impliquent cette colonne. Étant donné que cette personnalisation est stockée dans la table Configuration de colonne sémantique, elle peut être incluse dans un ensemble de mises à jour et transférée vers d’autres instances. Pour plus d'informations, consultez .

    Configurations de colonnes

    Les exemples suivants montrent des descriptions de colonnes et des instructions d’utilisation efficaces :

    Tableau 2. Exemples de configurations de colonnes
    Colonne Type Description sémantique Instructions d’utilisation
    creation_type Choix Indique comment le jeu de données a été produit. Valeurs : « Conservé » (sélectionné à la main), « Dérivé » (transformé à partir d’ensembles de données existants), « Synthétique » (généré artificiellement). Laisser vide : les valeurs de choix sont renseignées automatiquement par le système
    dataset_creation_date Date Date à laquelle l’ensemble de données lui-même a été créé ou compilé à l’origine, quelle que soit la date à laquelle l’enregistrement d’actif a été ajouté à l’instance. Utilisez des opérateurs de date (>=, <=, BETWEEN) au format AAAA-MM-JJ.
    base_datasets Référence Liste des autres actifs de l’ensemble de données IA dont cet ensemble de données est dérivé ou sur lequel il s’appuie, représentant la lignée de l’ensemble de données. Champ de référence. Utilisez IS EMPTY pour trouver des jeux de données d’origine/racine. Utilisez IS NOT EMPTY pour trouver des jeux de données dérivés.

    Que faire ensuite

    Testez votre configuration de colonne en posant des questions qui impliquent ce champ et Génération de requête en vérifiant que les filtres corrects sont générés.