Éditeur de vues sémantiques¶
L’éditeur de vues sémantiques dans l’Snowsight fournit une interface visuelle pour la création et l’édition de vues sémantiques. Si vous affinez une vue créée par le pilote automatique, que vous en créez une à partir de zéro ou que vous modifiez une spécification YAML importée, l’éditeur vous aide à définir des concepts commerciaux, des métriques et des relations sur vos données.
L’éditeur de vues sémantiques vous permet de :
Définir des tables logiques mappées sur vos tables de bases de données physiques
Créer des dimensions (attributs catégoriques), des faits (données au niveau des lignes) et des métriques (mesures agrégées)
Établir des relations entre les tables
Ajouter des requêtes vérifiées comme exemples pour Cortex Analyst
Fournir des instructions personnalisées pour la génération de requêtes
Configurer des synonymes et des descriptions pour améliorer la découverte
Accéder à l’éditeur¶
Vous pouvez accéder à l’éditeur de vues sémantiques via le catalogue de données ou via Cortex Analyst.
Via le catalogue de données¶
Pour accéder à une vue sémantique existante via le catalogue de données, procédez comme suit :
Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Catalog » Database Explorer.
Accédez à votre base de données et votre schéma.
Sélectionnez Semantic Views dans la liste d’objets.
Sélectionnez la vue sémantique que vous souhaitez modifier.
Sélectionnez l’onglet Semantic information pour ouvrir l’éditeur.
Via Cortex Analyst¶
Pour accéder aux vues sémantiques via Cortex Analyst, procédez comme suit :
Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez AI & ML » Cortex Analyst.
Sélectionnez l’onglet Semantic Views.
Deux possibilités :
Sélectionner une vue existante pour la modifier
Sélectionner Create new pour créer une nouvelle vue sémantique
Modifier les métadonnées de la vue sémantique¶
Le nom et la description de la vue sémantique aident les utilisateurs à découvrir et à comprendre l’objectif de la vue.
Pour modifier le nom ou la description de la vue sémantique, procédez comme suit :
Dans l’éditeur, sélectionnez Edit à côté du nom de la vue sémantique en haut de la page.
Mettez à jour les champs Name ou Description.
Sélectionnez Save.
Astuce
Rédigez des descriptions claires et détaillées expliquant :
À quelles questions commerciales cette vue peut répondre
Quelles sources de données sont incluses
Qui doit utiliser cette vue
Exemple : « Analyse des revenus des produits et des clients, y compris les tendances d’une année sur l’autre. Utiliser cette vue pour analyser les performances de vente par région, catégorie de produit et segment de client. »
Gérer les tables logiques¶
Les tables logiques représentent des entités commerciales (telles que des clients, des commandes ou des produits) et sont mappées à des tables ou vues de bases de données physiques. Chaque vue sémantique contient une ou plusieurs tables logiques.
Ajouter une table logique¶
Pour ajouter une table logique à votre vue sémantique, procédez comme suit :
Dans l’éditeur, sélectionnez. + Logical Table.
Naviguez et sélectionnez la table physique ou la vue dans votre base de données.
Sélectionnez Next.
Choisissez les colonnes à inclure dans la table.
Sélectionnez Generate logical table.
L’éditeur génère automatiquement des dimensions et des faits basés sur les colonnes sélectionnées.
Modifier une table logique¶
Pour modifier une table logique existante, procédez comme suit :
Sélectionnez Edit à côté du nom de la table (ou sélectionnez More options » Edit Logical Table).
Modifiez les propriétés de la table :
Name : Nom commercial convivial de cette table
Description : Explication de ce que représente cette table
Synonyms : noms alternatifs (séparés par des virgules)
Primary Key : Colonnes qui identifient les lignes de manière unique
Sélectionnez Save.
Astuce
Utilisez le bouton Generate fields pour autoriser l’AI à remplir automatiquement les descriptions et les synonymes en fonction de vos données et de vos noms de colonnes. Cela peut accélérer considérablement le processus de configuration initiale.
Gérer les faits, les dimensions et les métriques¶
Dans chaque table logique, vous définissez les concepts commerciaux que les utilisateurs peuvent interroger : dimensions, faits et métriques.
Comprendre les types de contenus¶
Dimensions : Attributs catégoriques qui fournissent un contexte (tels que le nom du client, la catégorie de produit ou la date de la commande)
Faits : Données quantitatives au niveau des lignes (telles que le montant de la vente, la quantité ou le prix unitaire)
Métriques : Mesures agrégées calculées à partir de fonctions comme SUM, AVG ou COUNT (telles que le revenu total ou la valeur moyenne des commandes)
Ajouter des dimensions, des faits ou des métriques¶
Pour ajouter un nouvel élément à une table logique, procédez comme suit :
Naviguez vers la table logique dans l’éditeur.
Sélectionnez + à côté de Dimensions, Facts ou Metrics.
Saisissez les détails requis :
Name : Nom descriptif pour cet élément
Expression : expression SQL pour calculer la valeur
Data Type : Type de données du résultat
Sélectionner Add
Modifier ou supprimer des éléments¶
Pour modifier ou supprimer une dimension, un fait ou une métrique qui existe déjà, procédez comme suit :
Sélectionnez l’élément pour ouvrir ses détails et modifier les propriétés.
Sinon, sélectionnez More options » Remove pour supprimer l’élément.
Sélectionnez Save pour appliquer les modifications.
Fonctionnalités avancées¶
Métriques dérivées : Vous pouvez créer des métriques au niveau de la vue qui combinent les métriques de plusieurs tables. Pour plus d’informations, voir Définition de métriques dérivées.
Modificateurs d’accès privé : Marquez les faits ou les métriques comme étant privés pour les masquer des requêtes tout en continuant à les utiliser dans d’autres calculs. Pour plus d’informations, voir Marquer un fait ou une métrique comme privé.
Chemins de jointure préféré pour les métriques : S’il y a des chemins de relations multiples entre deux tables logiques, vous pouvez choisir la relation à utiliser dans le menu Preferred join path.
Gérer des relations¶
Les relations définissent la manière dont les tables logiques se joignent, ce qui permet d’effectuer des requêtes sur plusieurs tables. Chaque relation définit les colonnes d’une table qui font référence aux colonnes d’une autre table.
Ajouter une relation¶
Pour créer une relation entre deux tables logiques, procédez comme suit :
Dans l’éditeur, sélectionnez + à côté de Relationships.
Saisissez un Name descriptif pour la relation (par exemple, « commandes_aux_clients »).
Sélectionnez la Left Table (la table avec la clé étrangère).
Sélectionnez la Right Table (la table à laquelle il est fait référence).
Spécifiez les Join Columns pour chaque table.
Left Column : La ou les colonnes de clés étrangères dans la table de gauche
Right Column : La clé primaire ou les colonnes uniques dans la table de droite
Sélectionnez Add.
La relation apparaît désormais dans la liste des relations et active Cortex Analyst pour générer des requêtes qui joignent ces tables.
Note
Pour les vues sémantiques, vous n’avez généralement pas besoin de spécifier des types de jointure (extérieure gauche, interne) ou des types de relations (une à une, plusieurs à une). Celles-ci sont automatiquement déduites des données et des définitions de clés primaires au moment de la requête.
Modifier ou supprimer des relations¶
Pour modifier ou supprimer une relation, procédez comme suit :
Sélectionnez la relation pour voir ses détails.
Modifiez les propriétés si nécessaire, ou sélectionnez Remove pour la supprimer.
Sélectionnez Save pour appliquer les modifications.
Fonctionnalités avancées pour Cortex Analyst¶
Pour améliorer la précision et la fiabilité de Cortex Analyst, vous pouvez ajouter du contexte et des conseils grâce à des requêtes vérifiées, des synonymes et des instructions personnalisées.
Requêtes vérifiées¶
Les requêtes vérifiées fournissent des exemples de questions accompagnées de réponses SQL correctes. Elles ont deux objectifs :
Aider Cortex Analyst à comprendre comment répondre à des questions similaires
Fournir des suggestions de questions pour aider les utilisateurs à démarrer
Ajouter une requête vérifiée :
Sélectionnez + à côté de Verified Queries.
Saisissez une Question en langage naturel (par exemple, « Quels sont les 10 premiers produits par chiffre d’affaires ? »).
Saisir la SQL Query correspondante qui répond correctement à la question.
(Facultatif) Cochez Use as onboarding question pour afficher cette suggestion aux utilisateurs.
Sélectionnez Add.
Astuce
Ajoutez des requêtes vérifiées pour :
Les questions commerciales courantes que les utilisateurs sont susceptibles de poser
Les requêtes complexes qui nécessitent une logique spécifique
Les cas limites ou les calculs inhabituels
Les questions qui démontrent les capacités de la vue
Synonymes¶
Note
Ajoutez manuellement des synonymes plutôt que de les générer automatiquement à l’aide de l’AI. Privilégiez des alternatives spécifiques au domaine, comme la terminologie interne, les abréviations ou les noms hérités. Les synonymes générés automatiquement réduisent souvent la qualité de la vue sémantique.
Les synonymes aident les utilisateurs à découvrir et à interroger vos données en utilisant une autre terminologie. Par exemple, les utilisateurs peuvent désigner des « utilisateurs » en tant que « clients » ou « comptes ».
Ajouter des synonymes à une table ou à un champ :
Accédez à la table, à la dimension, au fait ou à la métrique pour lesquels vous souhaitez ajouter des synonymes.
Sélectionnez Edit pour ouvrir les propriétés de l’élément.
Dans le champ Synonyms, saisissez des termes alternatifs séparés par des virgules.
Sélectionnez Save.
Exemples de synonymes :
Pour une dimension « nom_client » : « nom de consommateur, nom d’utilisateur, nom d’acheteur »
Pour une métrique « chiffre d’affaires » : « ventes, revenus, recettes »
Pour une table « commandes » : « commandes client, achats »
Instructions personnalisées¶
Les instructions personnalisées fournissent des conseils spécifiques à Cortex Analyst pour la génération SQL et la catégorisation des questions. Utilisez des instructions personnalisées pour :
Définir les règles métier et les contraintes
Spécifier les comportements par défaut
Traiter les questions ambiguës
Rejeter certains types de questions
Ajoutez une instruction personnalisée en procédant comme suit :
Dans l’éditeur, sélectionnez la section Custom Instructions.
Saisissez des instructions en langage naturel. Exemples :
« Toujours filtrer par clients actifs (état = “ACTIVE”), sauf indication contraire »
« Arrondir toutes les valeurs monétaires à 2 décimales »
« Lorsque le chiffre d’affaires est interrogé, utiliser la métrique net_revenue, à moins que les revenus bruts ne soient explicitement demandés. »
« Si une question porte sur les utilisateurs sans spécifier de région, demander à l’utilisateur de préciser quelle région »
Sélectionnez Save.
Pour plus d’informations sur les instructions personnalisées dans les vues sémantiques, consultez Fournir des instructions personnalisées pour Cortex Analyst.
Charger un fichier YAML¶
Si vous disposez déjà d’une spécification YAML de vue sémantique ou d’un fichier YAML de modèle sémantique hérité, vous pouvez la ou le charger pour créer une nouvelle vue sémantique ou mettre à jour une vue existante.
Pour charger un fichier YAML, procédez comme suit :
Dans le menu de navigation, sélectionnez AI & ML » Cortex Analyst.
Sélectionnez Create new » Upload YAML file.
Naviguez et sélectionnez votre fichier YAML.
Examinez la structure de la vue sémantique générée dans l’éditeur.
Sélectionnez Convert and save pour créer la vue sémantique en tant qu’objet de niveau schéma.
L’éditeur convertit la spécification YAML dans une vue sémantique native de Snowflake, que vous pouvez ensuite modifier à l’aide de l’interface visuelle.
Pour plus d’informations sur le format de la spécification YAML, consultez Spécification YAML pour les vues sémantiques.
Pour obtenir des informations sur la conversion d’une spécification en vue sémantique de manière programmatique, consultez Création d’une vue sémantique à partir d’une spécification YAML.