Personnaliser les descriptions de colonnes et les instructions d’utilisation

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 System update sets.

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.